blueprint-extractor-mcp 7.0.7 → 7.0.8

package/dist/execution/adapters/lazy-commandlet-adapter.d.ts

@@ -0,0 +1,28 @@
+import type { ExecutionAdapter } from '../execution-adapter.js';
+import { type CommandletAdapterOptions } from './commandlet-adapter.js';
+type ResolvedCommandletInputs = {
+    engineRoot?: string;
+    projectPath?: string;
+};
+type CommandletAdapterFactory = (options: CommandletAdapterOptions) => ExecutionAdapter;
+export type LazyCommandletAdapterOptions = {
+    resolveInputs: () => Promise<ResolvedCommandletInputs>;
+    createAdapter?: CommandletAdapterFactory;
+    platform?: NodeJS.Platform;
+};
+export declare class LazyCommandletAdapter implements ExecutionAdapter {
+    private adapter;
+    private adapterPromise;
+    private readonly resolveInputs;
+    private readonly createAdapter;
+    private readonly platform;
+    constructor(options: LazyCommandletAdapterOptions);
+    execute(subsystem: string, method: string, params: Record<string, unknown>): Promise<Record<string, unknown>>;
+    isAvailable(): Promise<boolean>;
+    getMode(): 'commandlet';
+    getCapabilities(): ReadonlySet<import("../execution-adapter.js").ToolCapability>;
+    shutdown(): Promise<void>;
+    private getOrCreateAdapter;
+    private createAndInitializeAdapter;
+}
+export {};

package/dist/execution/adapters/lazy-commandlet-adapter.js

@@ -0,0 +1,71 @@
+import { COMMANDLET_CAPABILITIES } from '../execution-adapter.js';
+import { CommandletAdapter } from './commandlet-adapter.js';
+export class LazyCommandletAdapter {
+    adapter = null;
+    adapterPromise = null;
+    resolveInputs;
+    createAdapter;
+    platform;
+    constructor(options) {
+        this.resolveInputs = options.resolveInputs;
+        this.createAdapter = options.createAdapter ?? ((adapterOptions) => new CommandletAdapter(adapterOptions));
+        this.platform = options.platform;
+    }
+    async execute(subsystem, method, params) {
+        const adapter = await this.getOrCreateAdapter();
+        return adapter.execute(subsystem, method, params);
+    }
+    async isAvailable() {
+        try {
+            const adapter = await this.getOrCreateAdapter();
+            return await adapter.isAvailable();
+        }
+        catch {
+            return false;
+        }
+    }
+    getMode() {
+        return 'commandlet';
+    }
+    getCapabilities() {
+        return COMMANDLET_CAPABILITIES;
+    }
+    async shutdown() {
+        if (this.adapter && typeof this.adapter.shutdown === 'function') {
+            await this.adapter.shutdown();
+        }
+        this.adapter = null;
+        this.adapterPromise = null;
+    }
+    async getOrCreateAdapter() {
+        if (this.adapter) {
+            return this.adapter;
+        }
+        if (!this.adapterPromise) {
+            this.adapterPromise = this.createAndInitializeAdapter();
+        }
+        try {
+            const adapter = await this.adapterPromise;
+            this.adapter = adapter;
+            return adapter;
+        }
+        finally {
+            this.adapterPromise = null;
+        }
+    }
+    async createAndInitializeAdapter() {
+        const resolved = await this.resolveInputs();
+        if (!resolved.engineRoot || !resolved.projectPath) {
+            throw new Error('Commandlet fallback requires both engineRoot and projectPath to be resolved.');
+        }
+        const adapter = this.createAdapter({
+            engineRoot: resolved.engineRoot,
+            projectPath: resolved.projectPath,
+            ...(this.platform ? { platform: this.platform } : {}),
+        });
+        if (typeof adapter.initialize === 'function') {
+            await adapter.initialize();
+        }
+        return adapter;
+    }
+}

package/dist/helpers/tool-registration.js

@@ -1,15 +1,44 @@
+import { z } from 'zod';
 import { extractExtraContent, extractToolPayload, isPlainObject } from './formatting.js';
 import { rawHandlerRegistry } from './alias-registration.js';
+const normalizedToolResultEnvelopeSchema = z.object({
+    success: z.boolean(),
+    operation: z.string(),
+    code: z.string().optional(),
+    message: z.string().optional(),
+    recoverable: z.boolean().optional(),
+    next_steps: z.array(z.string()).optional(),
+    _hints: z.array(z.string()).optional(),
+    diagnostics: z.array(z.object({
+        severity: z.string().optional(),
+        code: z.string().optional(),
+        message: z.string().optional(),
+        path: z.string().optional(),
+    })).optional(),
+    execution: z.object({
+        mode: z.enum(['immediate', 'task_aware']),
+        task_support: z.enum(['optional', 'required', 'forbidden']),
+        status: z.string().optional(),
+        progress_message: z.string().optional(),
+    }).optional(),
+}).passthrough();
+function wrapOutputSchemaWithNormalizedErrors(outputSchema) {
+    if (outputSchema instanceof z.ZodObject) {
+        return normalizedToolResultEnvelopeSchema.extend(outputSchema.partial().shape).passthrough();
+    }
+    return normalizedToolResultEnvelopeSchema;
+}
 export function installNormalizedToolRegistration({ server, toolHelpRegistry, registeredToolMap, defaultOutputSchema, normalizeToolError, normalizeToolSuccess, executor, }) {
     const rawRegisterTool = server.registerTool.bind(server);
     server.registerTool = ((name, config, cb) => {
-        const outputSchema = (config.outputSchema ?? defaultOutputSchema);
+        const declaredOutputSchema = (config.outputSchema ?? defaultOutputSchema);
+        const outputSchema = wrapOutputSchemaWithNormalizedErrors(declaredOutputSchema);
         rawHandlerRegistry.set(name, cb);
         toolHelpRegistry.set(name, {
             title: config.title ?? name,
             description: config.description ?? '',
             inputSchema: (config.inputSchema ?? {}),
-            outputSchema,
+            outputSchema: declaredOutputSchema,
             annotations: config.annotations,
         });
         const registered = rawRegisterTool(name, {

package/dist/schemas/tool-inputs.d.ts

@@ -1243,12 +1243,12 @@ export declare const ImportJobSchema: z.ZodObject<{
         status: z.ZodOptional<z.ZodString>;
         progress_message: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     }, {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
@@ -1383,16 +1383,16 @@ export declare const ImportJobSchema: z.ZodObject<{
     code?: string | undefined;
     message?: string | undefined;
     recoverable?: boolean | undefined;
+    next_steps?: string[] | undefined;
+    _hints?: string[] | undefined;
     execution?: {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     } | undefined;
     completedAt?: string | undefined;
     startedAt?: string | undefined;
-    next_steps?: string[] | undefined;
-    _hints?: string[] | undefined;
     jobId?: string | undefined;
 }, {
     status: string;
@@ -1433,16 +1433,16 @@ export declare const ImportJobSchema: z.ZodObject<{
     code?: string | undefined;
     message?: string | undefined;
     recoverable?: boolean | undefined;
+    next_steps?: string[] | undefined;
+    _hints?: string[] | undefined;
     execution?: {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     } | undefined;
     completedAt?: string | undefined;
     startedAt?: string | undefined;
-    next_steps?: string[] | undefined;
-    _hints?: string[] | undefined;
     jobId?: string | undefined;
 }>;
 export declare const ImportJobListSchema: z.ZodObject<{
@@ -1475,12 +1475,12 @@ export declare const ImportJobListSchema: z.ZodObject<{
         status: z.ZodOptional<z.ZodString>;
         progress_message: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     }, {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
@@ -1502,12 +1502,12 @@ export declare const ImportJobListSchema: z.ZodObject<{
             status: z.ZodOptional<z.ZodString>;
             progress_message: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
         }, {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
@@ -1642,16 +1642,16 @@ export declare const ImportJobListSchema: z.ZodObject<{
         code?: string | undefined;
         message?: string | undefined;
         recoverable?: boolean | undefined;
+        next_steps?: string[] | undefined;
+        _hints?: string[] | undefined;
         execution?: {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
         } | undefined;
         completedAt?: string | undefined;
         startedAt?: string | undefined;
-        next_steps?: string[] | undefined;
-        _hints?: string[] | undefined;
         jobId?: string | undefined;
     }, {
         status: string;
@@ -1692,16 +1692,16 @@ export declare const ImportJobListSchema: z.ZodObject<{
         code?: string | undefined;
         message?: string | undefined;
         recoverable?: boolean | undefined;
+        next_steps?: string[] | undefined;
+        _hints?: string[] | undefined;
         execution?: {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
         } | undefined;
         completedAt?: string | undefined;
         startedAt?: string | undefined;
-        next_steps?: string[] | undefined;
-        _hints?: string[] | undefined;
         jobId?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -1748,16 +1748,16 @@ export declare const ImportJobListSchema: z.ZodObject<{
         code?: string | undefined;
         message?: string | undefined;
         recoverable?: boolean | undefined;
+        next_steps?: string[] | undefined;
+        _hints?: string[] | undefined;
         execution?: {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
         } | undefined;
         completedAt?: string | undefined;
         startedAt?: string | undefined;
-        next_steps?: string[] | undefined;
-        _hints?: string[] | undefined;
         jobId?: string | undefined;
     }[];
     code?: string | undefined;
@@ -1769,14 +1769,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
         severity?: string | undefined;
     }[] | undefined;
     recoverable?: boolean | undefined;
+    next_steps?: string[] | undefined;
+    _hints?: string[] | undefined;
     execution?: {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     } | undefined;
-    next_steps?: string[] | undefined;
-    _hints?: string[] | undefined;
 }, {
     success: boolean;
     operation: string;
@@ -1821,16 +1821,16 @@ export declare const ImportJobListSchema: z.ZodObject<{
         code?: string | undefined;
         message?: string | undefined;
         recoverable?: boolean | undefined;
+        next_steps?: string[] | undefined;
+        _hints?: string[] | undefined;
         execution?: {
-            mode: "task_aware" | "immediate";
+            mode: "immediate" | "task_aware";
             task_support: "optional" | "required" | "forbidden";
             status?: string | undefined;
             progress_message?: string | undefined;
         } | undefined;
         completedAt?: string | undefined;
         startedAt?: string | undefined;
-        next_steps?: string[] | undefined;
-        _hints?: string[] | undefined;
         jobId?: string | undefined;
     }[];
     code?: string | undefined;
@@ -1842,14 +1842,14 @@ export declare const ImportJobListSchema: z.ZodObject<{
         severity?: string | undefined;
     }[] | undefined;
     recoverable?: boolean | undefined;
+    next_steps?: string[] | undefined;
+    _hints?: string[] | undefined;
     execution?: {
-        mode: "task_aware" | "immediate";
+        mode: "immediate" | "task_aware";
         task_support: "optional" | "required" | "forbidden";
         status?: string | undefined;
         progress_message?: string | undefined;
     } | undefined;
-    next_steps?: string[] | undefined;
-    _hints?: string[] | undefined;
 }>;
 export declare const UserDefinedStructMutationOperationSchema: z.ZodEnum<["replace_fields", "patch_field", "rename_field", "remove_field", "reorder_fields"]>;
 export declare const UserDefinedEnumMutationOperationSchema: z.ZodEnum<["replace_entries", "rename_entry", "remove_entry", "reorder_entries"]>;