@padua/cli 1.13.1 → 2.0.1

package/dist/mcp/providers/gitlab/tools/pipelines.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * GitLab Pipeline MCP tools.
+ *
+ * Registers 5 tools covering the GitLab pipelines and jobs API:
+ *   - list_pipelines, get_pipeline, list_pipeline_jobs, get_job_log, retry_pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPipelineTools = registerPipelineTools;
+const zod_1 = require("zod");
+const tool_helpers_1 = require("../../tool-helpers");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_JOB_LOG_BYTES = 1_048_576; // 1MB
+const TRUNCATION_MARKER = '\n[TRUNCATED: response exceeded 1MB limit]';
+// ---------------------------------------------------------------------------
+// Shared Zod primitives
+// ---------------------------------------------------------------------------
+const projectId = zod_1.z
+    .number()
+    .int()
+    .positive()
+    .max(2_147_483_647)
+    .describe('The numeric ID of the GitLab project.');
+const pipelineId = zod_1.z
+    .number()
+    .int()
+    .positive()
+    .describe('The numeric ID of the pipeline.');
+const pageParam = zod_1.z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe('Page number for pagination.');
+const perPageParam = zod_1.z
+    .number()
+    .int()
+    .min(1)
+    .max(100)
+    .optional()
+    .describe('Number of results per page (1-100).');
+function buildParams(extra) {
+    return Object.fromEntries(Object.entries(extra).filter((entry) => entry[1] !== undefined));
+}
+function capJobLog(raw) {
+    const bytes = Buffer.byteLength(raw, 'utf8');
+    if (bytes <= MAX_JOB_LOG_BYTES)
+        return raw;
+    const truncated = Buffer.from(raw, 'utf8').subarray(0, MAX_JOB_LOG_BYTES).toString('utf8');
+    return truncated + TRUNCATION_MARKER;
+}
+// ---------------------------------------------------------------------------
+// Tool registrations
+// ---------------------------------------------------------------------------
+function registerListPipelines(client, registrar) {
+    const schema = zod_1.z.object({
+        project_id: projectId,
+        ref: zod_1.z
+            .string()
+            .max(255)
+            .regex(/^[a-zA-Z0-9/_.\\-]+$/)
+            .optional()
+            .describe('Filter pipelines by git ref (branch or tag name).'),
+        status: zod_1.z
+            .enum([
+            'created',
+            'waiting_for_resource',
+            'preparing',
+            'pending',
+            'running',
+            'success',
+            'failed',
+            'canceled',
+            'skipped',
+            'manual',
+            'scheduled',
+        ])
+            .optional()
+            .describe('Filter pipelines by status.'),
+        page: pageParam,
+        per_page: perPageParam,
+    });
+    registrar.registerTool('gitlab_list_pipelines', {
+        description: 'List pipelines for a GitLab project.',
+        inputSchema: schema,
+        annotations: { readOnlyHint: true },
+    }, async (input) => {
+        const params = buildParams({
+            ref: input.ref,
+            status: input.status,
+            page: input.page?.toString(),
+            per_page: input.per_page?.toString(),
+        });
+        const resp = await client.get(`/projects/${input.project_id}/pipelines`, params);
+        return (0, tool_helpers_1.toMcpResult)(resp.body);
+    });
+}
+function registerGetPipeline(client, registrar) {
+    const schema = zod_1.z.object({
+        project_id: projectId,
+        pipeline_id: pipelineId,
+    });
+    registrar.registerTool('gitlab_get_pipeline', {
+        description: 'Get details of a single GitLab pipeline by its ID.',
+        inputSchema: schema,
+        annotations: { readOnlyHint: true },
+    }, async (input) => {
+        const resp = await client.get(`/projects/${input.project_id}/pipelines/${input.pipeline_id}`);
+        return (0, tool_helpers_1.toMcpResult)(resp.body);
+    });
+}
+function registerListPipelineJobs(client, registrar) {
+    const schema = zod_1.z.object({
+        project_id: projectId,
+        pipeline_id: pipelineId,
+        page: pageParam,
+        per_page: perPageParam,
+    });
+    registrar.registerTool('gitlab_list_pipeline_jobs', {
+        description: 'List jobs for a specific GitLab pipeline.',
+        inputSchema: schema,
+        annotations: { readOnlyHint: true },
+    }, async (input) => {
+        const params = buildParams({
+            page: input.page?.toString(),
+            per_page: input.per_page?.toString(),
+        });
+        const resp = await client.get(`/projects/${input.project_id}/pipelines/${input.pipeline_id}/jobs`, params);
+        return (0, tool_helpers_1.toMcpResult)(resp.body);
+    });
+}
+function registerGetJobLog(client, registrar) {
+    const schema = zod_1.z.object({
+        project_id: projectId,
+        job_id: zod_1.z.number().int().positive().describe('The numeric ID of the CI job.'),
+    });
+    registrar.registerTool('gitlab_get_job_log', {
+        description: 'Get the log (trace) output of a specific GitLab CI job. Returns plain text.',
+        inputSchema: schema,
+        annotations: { readOnlyHint: true },
+    }, async (input) => {
+        const resp = await client.get(`/projects/${input.project_id}/jobs/${input.job_id}/trace`);
+        const raw = typeof resp.body === 'string' ? resp.body : String(resp.body);
+        return (0, tool_helpers_1.toRawTextResult)(capJobLog(raw));
+    });
+}
+function registerRetryPipeline(client, registrar) {
+    const schema = zod_1.z.object({
+        project_id: projectId,
+        pipeline_id: pipelineId,
+    });
+    registrar.registerTool('gitlab_retry_pipeline', {
+        description: 'Retry all failed jobs in a GitLab pipeline.',
+        inputSchema: schema,
+        annotations: { destructiveHint: true },
+    }, async (input) => {
+        const resp = await client.post(`/projects/${input.project_id}/pipelines/${input.pipeline_id}/retry`);
+        return (0, tool_helpers_1.toMcpResult)(resp.body);
+    });
+}
+// ---------------------------------------------------------------------------
+// Public export
+// ---------------------------------------------------------------------------
+function registerPipelineTools(client, registrar) {
+    registerListPipelines(client, registrar);
+    registerGetPipeline(client, registrar);
+    registerListPipelineJobs(client, registrar);
+    registerGetJobLog(client, registrar);
+    registerRetryPipeline(client, registrar);
+}
+//# sourceMappingURL=pipelines.js.map

package/dist/mcp/providers/gitlab/tools/pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelines.js","sourceRoot":"","sources":["../../../../../src/mcp/providers/gitlab/tools/pipelines.ts"],"names":[],"mappings":"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"}

package/dist/mcp/providers/gitlab/tools/repository.d.ts

@@ -0,0 +1,4 @@
+import type { GitLabClient } from '../client';
+import type { ToolRegistrar } from '../../types';
+export declare function registerRepositoryTools(client: GitLabClient, registrar: ToolRegistrar): void;
+//# sourceMappingURL=repository.d.ts.map

package/dist/mcp/providers/gitlab/tools/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/providers/gitlab/tools/repository.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAYjD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,aAAa,GACvB,IAAI,CAwQN"}

package/dist/mcp/providers/gitlab/tools/repository.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRepositoryTools = registerRepositoryTools;
+const zod_1 = require("zod");
+const validation_1 = require("../../../server/validation");
+const tool_helpers_1 = require("../../tool-helpers");
+function buildQueryParams(raw) {
+    const params = {};
+    for (const [key, val] of Object.entries(raw)) {
+        if (val !== undefined)
+            params[key] = String(val);
+    }
+    return params;
+}
+function registerRepositoryTools(client, registrar) {
+    // -------------------------------------------------------------------------
+    // 1. gitlab_list_projects
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_list_projects', {
+        description: 'List GitLab projects accessible to the authenticated user',
+        inputSchema: zod_1.z.object({
+            search: zod_1.z.string().optional().describe('Filter projects by name'),
+            page: validation_1.PageSchema.optional().describe('Page number'),
+            per_page: validation_1.PerPageSchema.optional().describe('Results per page'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const queryParams = buildQueryParams({
+            search: params.search,
+            page: params.page,
+            per_page: params.per_page,
+        });
+        const response = await client.get('/projects', queryParams);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 2. gitlab_get_project
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_get_project', {
+        description: 'Get details of a specific GitLab project by ID',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const response = await client.get(`/projects/${params.project_id}`);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 3. gitlab_get_file
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_get_file', {
+        description: 'Get the contents of a file from a GitLab repository',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            file_path: validation_1.FilePathSchema.describe('Path to the file in the repository'),
+            ref: zod_1.z.string().optional().describe('Branch name, tag, or commit SHA to read from'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const encodedPath = encodeURIComponent(params.file_path);
+        const queryParams = buildQueryParams({ ref: params.ref });
+        const response = await client.get(`/projects/${params.project_id}/repository/files/${encodedPath}`, queryParams);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 4. gitlab_create_file
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_create_file', {
+        description: 'Create a new file in a GitLab repository',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            file_path: validation_1.FilePathSchema.describe('Path to the file in the repository'),
+            branch: validation_1.BranchNameSchema.describe('Branch to commit the change to'),
+            content: zod_1.z.string().describe('The new file content'),
+            commit_message: zod_1.z.string().min(1).describe('Commit message for the change'),
+        }),
+        annotations: { destructiveHint: true },
+    }, async (params) => {
+        const encodedPath = encodeURIComponent(params.file_path);
+        const response = await client.post(`/projects/${params.project_id}/repository/files/${encodedPath}`, { branch: params.branch, content: params.content, commit_message: params.commit_message });
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 5. gitlab_update_file
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_update_file', {
+        description: 'Update an existing file in a GitLab repository',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            file_path: validation_1.FilePathSchema.describe('Path to the file in the repository'),
+            branch: validation_1.BranchNameSchema.describe('Branch to commit the change to'),
+            content: zod_1.z.string().describe('The updated file content'),
+            commit_message: zod_1.z.string().min(1).describe('Commit message for the change'),
+        }),
+        annotations: { destructiveHint: true },
+    }, async (params) => {
+        const encodedPath = encodeURIComponent(params.file_path);
+        const response = await client.put(`/projects/${params.project_id}/repository/files/${encodedPath}`, { branch: params.branch, content: params.content, commit_message: params.commit_message });
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 6. gitlab_list_branches
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_list_branches', {
+        description: 'List branches in a GitLab project repository',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            search: zod_1.z.string().optional().describe('Filter branches by name'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const queryParams = buildQueryParams({ search: params.search });
+        const response = await client.get(`/projects/${params.project_id}/repository/branches`, queryParams);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 7. gitlab_get_branch
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_get_branch', {
+        description: 'Get details of a specific branch in a GitLab project',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            branch: validation_1.BranchNameSchema.describe('The branch name'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const response = await client.get(`/projects/${params.project_id}/repository/branches/${params.branch}`);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 8. gitlab_search_code
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_search_code', {
+        description: 'Search code (blobs) within a GitLab project',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            search: validation_1.SearchQuerySchema.describe('Search query string'),
+            ref: zod_1.z.string().optional().describe('Branch or tag to search within'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const queryParams = buildQueryParams({
+            scope: 'blobs',
+            search: params.search,
+            ref: params.ref,
+        });
+        const response = await client.get(`/projects/${params.project_id}/search`, queryParams);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 9. gitlab_get_repository_tree
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_get_repository_tree', {
+        description: 'List the repository tree (files and directories) for a GitLab project',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+            path: zod_1.z.string().optional().describe('Subdirectory path inside the repository'),
+            ref: zod_1.z.string().optional().describe('Branch name, tag, or commit SHA'),
+            recursive: zod_1.z.boolean().optional().describe('If true, list tree recursively'),
+            page: validation_1.PageSchema.optional().describe('Page number for pagination'),
+            per_page: validation_1.PerPageSchema.optional().describe('Number of results per page'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const queryParams = buildQueryParams({
+            path: params.path,
+            ref: params.ref,
+            recursive: params.recursive,
+            page: params.page,
+            per_page: params.per_page,
+        });
+        const response = await client.get(`/projects/${params.project_id}/repository/tree`, queryParams);
+        return (0, tool_helpers_1.toMcpResult)(response.body);
+    });
+    // -------------------------------------------------------------------------
+    // 10. gitlab_get_clone_urls
+    // -------------------------------------------------------------------------
+    registrar.registerTool('gitlab_get_clone_urls', {
+        description: 'Get HTTP and SSH clone URLs for a GitLab project',
+        inputSchema: zod_1.z.object({
+            project_id: validation_1.GitLabProjectIdSchema.describe('The numeric ID of the GitLab project'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, async (params) => {
+        const response = await client.get(`/projects/${params.project_id}`);
+        const { http_url_to_repo, ssh_url_to_repo } = response.body;
+        return (0, tool_helpers_1.toMcpResult)({ http_url_to_repo, ssh_url_to_repo });
+    });
+}
+//# sourceMappingURL=repository.js.map

package/dist/mcp/providers/gitlab/tools/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../../../src/mcp/providers/gitlab/tools/repository.ts"],"names":[],"mappings":"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"}

package/dist/mcp/providers/index.d.ts

@@ -0,0 +1,4 @@
+export type { Provider, ToolRegistrar } from './types';
+export { ProviderRegistry } from './registry';
+export type { ProviderReadyResult } from './registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/providers/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "ProviderRegistry", { enumerable: true, get: function () { return registry_1.ProviderRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/providers/index.ts"],"names":[],"mappings":";;;AACA,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA"}

package/dist/mcp/providers/registry.d.ts

@@ -0,0 +1,90 @@
+/**
+ * ProviderRegistry — lifecycle manager for MCP providers.
+ *
+ * Holds all registered Provider instances and orchestrates bulk operations:
+ * tool/resource registration, readiness checks, and graceful shutdown.
+ *
+ * Design notes:
+ * - Zero MCP SDK imports. Providers are wired through the ToolRegistrar port.
+ * - shutdownAll() is intentionally fault-tolerant: every provider's shutdown()
+ *   is called regardless of earlier failures. Errors are collected and the
+ *   first is re-thrown after all shutdowns complete.
+ * - readyAll() is non-throwing: per-provider errors are captured into the
+ *   returned ProviderReadyResult array so callers can inspect partial failures.
+ */
+import { Provider, ToolRegistrar } from './types';
+/**
+ * Result of a single provider's readiness check.
+ *
+ * When `ready` is true the `error` property is absent.
+ * When `ready` is false the `error` property contains the rejection reason.
+ */
+export interface ProviderReadyResult {
+    /** The provider's stable identifier. */
+    name: string;
+    /** Whether the provider is ready to serve requests. */
+    ready: boolean;
+    /** The error thrown by ready(), present only when ready is false. */
+    error?: Error;
+}
+/**
+ * Registry that manages Provider instances and their lifecycle.
+ *
+ * Providers are stored by name. Registering a provider with an existing name
+ * overwrites the previous registration (last-write-wins).
+ */
+export declare class ProviderRegistry {
+    private readonly providers;
+    /**
+     * Register a provider by its name.
+     *
+     * If a provider with the same name is already registered it is overwritten.
+     *
+     * @param provider - The provider to register.
+     */
+    register(provider: Provider): void;
+    /**
+     * Retrieve a provider by name.
+     *
+     * @param name - The provider's stable identifier.
+     * @returns The provider, or undefined if no provider with that name exists.
+     */
+    get(name: string): Provider | undefined;
+    /**
+     * Return a snapshot of all registered providers.
+     *
+     * The returned array is a new array; mutating it does not affect the registry.
+     */
+    getAll(): Provider[];
+    /**
+     * Register all tools and resources from every provider via the ToolRegistrar port.
+     *
+     * Called once at server startup before the first MCP client connects.
+     * For each provider, registerTools() is called before registerResources().
+     *
+     * @param registrar - The ToolRegistrar port implementation (never the raw McpServer).
+     */
+    registerAll(registrar: ToolRegistrar): void;
+    /**
+     * Check the readiness of all registered providers.
+     *
+     * Does NOT throw on individual provider failures. Instead, every provider's
+     * result — success or failure — is captured in the returned array. Callers
+     * should inspect the results to decide whether to start the MCP server.
+     *
+     * @returns A result for each registered provider, in registration order.
+     */
+    readyAll(): Promise<ProviderReadyResult[]>;
+    /**
+     * Shut down all registered providers, collecting any errors along the way.
+     *
+     * Graceful degradation: every provider's shutdown() is called even if a
+     * preceding provider throws. After all shutdowns complete, if any errors
+     * were collected the first error is re-thrown so callers are notified of
+     * partial failure.
+     *
+     * @throws The first error encountered during shutdown, if any.
+     */
+    shutdownAll(): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/mcp/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/mcp/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAMlD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAMD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAMzD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;;;OAIG;IACH,MAAM,IAAI,QAAQ,EAAE;IAQpB;;;;;;;OAOG;IACH,WAAW,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAO3C;;;;;;;;OAQG;IACG,QAAQ,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAmBhD;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAenC"}

package/dist/mcp/providers/registry.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * ProviderRegistry — lifecycle manager for MCP providers.
+ *
+ * Holds all registered Provider instances and orchestrates bulk operations:
+ * tool/resource registration, readiness checks, and graceful shutdown.
+ *
+ * Design notes:
+ * - Zero MCP SDK imports. Providers are wired through the ToolRegistrar port.
+ * - shutdownAll() is intentionally fault-tolerant: every provider's shutdown()
+ *   is called regardless of earlier failures. Errors are collected and the
+ *   first is re-thrown after all shutdowns complete.
+ * - readyAll() is non-throwing: per-provider errors are captured into the
+ *   returned ProviderReadyResult array so callers can inspect partial failures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderRegistry = void 0;
+// ---------------------------------------------------------------------------
+// ProviderRegistry
+// ---------------------------------------------------------------------------
+/**
+ * Registry that manages Provider instances and their lifecycle.
+ *
+ * Providers are stored by name. Registering a provider with an existing name
+ * overwrites the previous registration (last-write-wins).
+ */
+class ProviderRegistry {
+    providers = new Map();
+    // -------------------------------------------------------------------------
+    // Registration and lookup
+    // -------------------------------------------------------------------------
+    /**
+     * Register a provider by its name.
+     *
+     * If a provider with the same name is already registered it is overwritten.
+     *
+     * @param provider - The provider to register.
+     */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Retrieve a provider by name.
+     *
+     * @param name - The provider's stable identifier.
+     * @returns The provider, or undefined if no provider with that name exists.
+     */
+    get(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * Return a snapshot of all registered providers.
+     *
+     * The returned array is a new array; mutating it does not affect the registry.
+     */
+    getAll() {
+        return Array.from(this.providers.values());
+    }
+    // -------------------------------------------------------------------------
+    // Bulk lifecycle operations
+    // -------------------------------------------------------------------------
+    /**
+     * Register all tools and resources from every provider via the ToolRegistrar port.
+     *
+     * Called once at server startup before the first MCP client connects.
+     * For each provider, registerTools() is called before registerResources().
+     *
+     * @param registrar - The ToolRegistrar port implementation (never the raw McpServer).
+     */
+    registerAll(registrar) {
+        for (const provider of this.providers.values()) {
+            provider.registerTools(registrar);
+            provider.registerResources(registrar);
+        }
+    }
+    /**
+     * Check the readiness of all registered providers.
+     *
+     * Does NOT throw on individual provider failures. Instead, every provider's
+     * result — success or failure — is captured in the returned array. Callers
+     * should inspect the results to decide whether to start the MCP server.
+     *
+     * @returns A result for each registered provider, in registration order.
+     */
+    async readyAll() {
+        const results = [];
+        for (const provider of this.providers.values()) {
+            try {
+                await provider.ready();
+                results.push({ name: provider.name, ready: true });
+            }
+            catch (err) {
+                results.push({
+                    name: provider.name,
+                    ready: false,
+                    error: err instanceof Error ? err : new Error(String(err)),
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Shut down all registered providers, collecting any errors along the way.
+     *
+     * Graceful degradation: every provider's shutdown() is called even if a
+     * preceding provider throws. After all shutdowns complete, if any errors
+     * were collected the first error is re-thrown so callers are notified of
+     * partial failure.
+     *
+     * @throws The first error encountered during shutdown, if any.
+     */
+    async shutdownAll() {
+        const errors = [];
+        for (const provider of this.providers.values()) {
+            try {
+                await provider.shutdown();
+            }
+            catch (err) {
+                errors.push(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        if (errors.length > 0) {
+            throw errors[0];
+        }
+    }
+}
+exports.ProviderRegistry = ProviderRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/mcp/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/mcp/providers/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAuBH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAa,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzD,4EAA4E;IAC5E,0BAA0B;IAC1B,4EAA4E;IAE5E;;;;;;OAMG;IACH,QAAQ,CAAC,QAAkB;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,4EAA4E;IAC5E,4BAA4B;IAC5B,4EAA4E;IAE5E;;;;;;;OAOG;IACH,WAAW,CAAC,SAAwB;QAClC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,QAAQ,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAClC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAA0B,EAAE,CAAC;QAE1C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;iBAC3D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAY,EAAE,CAAC;QAE3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AA7GD,4CA6GC"}