@qase/mcp-server 1.1.8 → 2.0.0

package/build/utils/registry.d.ts

@@ -6,6 +6,7 @@
  * - Convert Zod schemas to JSON Schema automatically
  * - Store and retrieve tool handlers
  * - Manage tool lifecycle
+ * - Support tool discovery with core/discoverable visibility
  */
 import { Tool, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
@@ -18,24 +19,39 @@ export type ToolHandler<T = any, R = any> = (args: T) => Promise<R>;
  * Tool definition for registration
  * Contains all information needed to register a tool with the MCP server
  */
+/** JSON Schema object type for outputSchema */
+export interface OutputSchema {
+    type: 'object';
+    properties?: Record<string, object>;
+    required?: string[];
+    [key: string]: unknown;
+}
 export interface ToolDefinition<T extends z.ZodType = z.ZodType> {
     name: string;
     description: string;
     schema: T;
     handler: ToolHandler;
     annotations?: ToolAnnotations;
+    /** JSON Schema describing the tool's output — enables clients to process results programmatically */
+    outputSchema?: OutputSchema;
+    /** Tool visibility: 'core' tools are always listed, 'discoverable' tools require activation via qase_discover_tools */
+    visibility?: 'core' | 'discoverable';
 }
 /**
  * Tool Registry Class
- * Manages the lifecycle of MCP tools
+ * Manages the lifecycle of MCP tools with support for dynamic discovery
  */
 export declare class ToolRegistry {
     private tools;
     private handlers;
+    private activeTools;
+    private toolVisibility;
+    /** Callback invoked when the active tool set changes (wired to server.sendToolListChanged) */
+    onToolsChanged?: () => void;
     /**
      * Register a new tool with the registry
      *
-     * @param definition - Tool definition including name, description, schema, and handler
+     * @param definition - Tool definition including name, description, schema, handler, and visibility
      *
      * @example
      * ```typescript
@@ -43,18 +59,33 @@ export declare class ToolRegistry {
      *   name: 'list_projects',
      *   description: 'Get all projects',
      *   schema: z.object({ limit: z.number().optional() }),
-     *   handler: async (args) => { ... }
+     *   handler: async (args) => { ... },
+     *   visibility: 'discoverable', // hidden until discovered
      * });
      * ```
      */
     register<T extends z.ZodType>(definition: ToolDefinition<T>): void;
     /**
-     * Get all registered tools
+     * Get active tools only (core + activated discoverable)
      * Used by the ListToolsRequestSchema handler
-     *
-     * @returns Array of all registered tools
      */
     getTools(): Tool[];
+    /**
+     * Get ALL registered tools regardless of activation status.
+     * Used for discovery search and testing.
+     */
+    getAllTools(): Tool[];
+    /**
+     * Search tools by name or description (case-insensitive substring match).
+     * Searches the full catalog including inactive tools.
+     */
+    searchTools(query: string): Tool[];
+    /**
+     * Activate tools by name, making them visible in getTools().
+     * Returns the list of newly activated tool names.
+     * Triggers onToolsChanged callback if any tools were activated.
+     */
+    activateTools(names: string[]): string[];
     /**
      * Get handler function for a specific tool
      *
@@ -62,6 +93,10 @@ export declare class ToolRegistry {
      * @returns Handler function or undefined if not found
      */
     getHandler(name: string): ToolHandler | undefined;
+    /**
+     * Get a specific tool definition by name
+     */
+    getTool(name: string): Tool | undefined;
     /**
      * Check if a tool exists in the registry
      *
@@ -70,9 +105,7 @@ export declare class ToolRegistry {
      */
     hasTool(name: string): boolean;
     /**
-     * Get the count of registered tools
-     *
-     * @returns Number of registered tools
+     * Get the count of registered tools (all, including inactive)
      */
     getToolCount(): number;
     /**

package/build/utils/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAkDlE;;;;;OAKG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,eAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,qGAAqG;IACrG,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uHAAuH;IACvH,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;CACtC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,cAAc,CAAmD;IAEzE,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IA0DlE;;;OAGG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;;OAGG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE;IASlC;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAcxC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAMd;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,eAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAK9B,CAAC"}

package/build/utils/registry.js

@@ -6,19 +6,24 @@
  * - Convert Zod schemas to JSON Schema automatically
  * - Store and retrieve tool handlers
  * - Manage tool lifecycle
+ * - Support tool discovery with core/discoverable visibility
  */
 import { zodToJsonSchema } from 'zod-to-json-schema';
 /**
  * Tool Registry Class
- * Manages the lifecycle of MCP tools
+ * Manages the lifecycle of MCP tools with support for dynamic discovery
  */
 export class ToolRegistry {
     tools = new Map();
     handlers = new Map();
+    activeTools = new Set();
+    toolVisibility = new Map();
+    /** Callback invoked when the active tool set changes (wired to server.sendToolListChanged) */
+    onToolsChanged;
     /**
      * Register a new tool with the registry
      *
-     * @param definition - Tool definition including name, description, schema, and handler
+     * @param definition - Tool definition including name, description, schema, handler, and visibility
      *
      * @example
      * ```typescript
@@ -26,12 +31,14 @@ export class ToolRegistry {
      *   name: 'list_projects',
      *   description: 'Get all projects',
      *   schema: z.object({ limit: z.number().optional() }),
-     *   handler: async (args) => { ... }
+     *   handler: async (args) => { ... },
+     *   visibility: 'discoverable', // hidden until discovered
      * });
      * ```
      */
     register(definition) {
-        const { name, description, schema, handler, annotations } = definition;
+        const { name, description, schema, handler, annotations, outputSchema } = definition;
+        const visibility = definition.visibility ?? 'core';
         // Convert Zod schema to JSON Schema for MCP protocol
         // Using explicit type assertion to avoid TypeScript's deep type inference issues
         // The zodToJsonSchema function can cause "excessively deep" type errors with complex schemas
@@ -66,21 +73,59 @@ export class ToolRegistry {
             description,
             inputSchema,
             ...(annotations && { annotations }),
+            ...(outputSchema && { outputSchema }),
         });
         // Store handler function
         this.handlers.set(name, handler);
+        // Track visibility and activation
+        this.toolVisibility.set(name, visibility);
+        if (visibility === 'core') {
+            this.activeTools.add(name);
+        }
         // Log registration for debugging (to stderr)
-        console.error(`[Registry] Registered tool: ${name}`);
+        console.error(`[Registry] Registered tool: ${name} (${visibility})`);
     }
     /**
-     * Get all registered tools
+     * Get active tools only (core + activated discoverable)
      * Used by the ListToolsRequestSchema handler
-     *
-     * @returns Array of all registered tools
      */
     getTools() {
+        return Array.from(this.tools.values()).filter((t) => this.activeTools.has(t.name));
+    }
+    /**
+     * Get ALL registered tools regardless of activation status.
+     * Used for discovery search and testing.
+     */
+    getAllTools() {
         return Array.from(this.tools.values());
     }
+    /**
+     * Search tools by name or description (case-insensitive substring match).
+     * Searches the full catalog including inactive tools.
+     */
+    searchTools(query) {
+        const lower = query.toLowerCase();
+        return this.getAllTools().filter((t) => t.name.toLowerCase().includes(lower) ||
+            (t.description?.toLowerCase().includes(lower) ?? false));
+    }
+    /**
+     * Activate tools by name, making them visible in getTools().
+     * Returns the list of newly activated tool names.
+     * Triggers onToolsChanged callback if any tools were activated.
+     */
+    activateTools(names) {
+        const newlyActivated = [];
+        for (const name of names) {
+            if (this.tools.has(name) && !this.activeTools.has(name)) {
+                this.activeTools.add(name);
+                newlyActivated.push(name);
+            }
+        }
+        if (newlyActivated.length > 0 && this.onToolsChanged) {
+            this.onToolsChanged();
+        }
+        return newlyActivated;
+    }
     /**
      * Get handler function for a specific tool
      *
@@ -90,6 +135,12 @@ export class ToolRegistry {
     getHandler(name) {
         return this.handlers.get(name);
     }
+    /**
+     * Get a specific tool definition by name
+     */
+    getTool(name) {
+        return this.tools.get(name);
+    }
     /**
      * Check if a tool exists in the registry
      *
@@ -100,9 +151,7 @@ export class ToolRegistry {
         return this.tools.has(name);
     }
     /**
-     * Get the count of registered tools
-     *
-     * @returns Number of registered tools
+     * Get the count of registered tools (all, including inactive)
      */
     getToolCount() {
         return this.tools.size;
@@ -117,6 +166,8 @@ export class ToolRegistry {
     unregister(name) {
         const hadTool = this.tools.delete(name);
         this.handlers.delete(name);
+        this.activeTools.delete(name);
+        this.toolVisibility.delete(name);
         return hadTool;
     }
     /**
@@ -127,6 +178,8 @@ export class ToolRegistry {
     clear() {
         this.tools.clear();
         this.handlers.clear();
+        this.activeTools.clear();
+        this.toolVisibility.clear();
     }
 }
 /**

package/build/utils/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"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"}

package/build/utils/response-shape.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Recursively strip `null`, `undefined`, empty arrays, and empty objects
+ * from API responses before sending them to the LLM.
+ *
+ * Zero, false, and empty strings are preserved — they carry signal (e.g.
+ * `"description": ""` is different from missing description when the user
+ * asked about it).
+ *
+ * Returns `undefined` only when the input itself is `null` or `undefined`.
+ * For objects that collapse to zero kept fields, returns `{}` (an empty
+ * object) — callers should test with `Object.keys(result).length === 0` if
+ * they want to detect collapse, not `result === undefined`. Arrays that
+ * become empty are returned as `[]`.
+ */
+export declare function compactResponse(value: unknown): unknown;
+/**
+ * Keep only the listed top-level fields on an object, or apply the same
+ * projection to each element of an array.
+ *
+ * Special case: `['*']` returns the input unchanged.
+ */
+export declare function projectFields<T>(value: T, fields: string[]): T;
+//# sourceMappingURL=response-shape.d.ts.map

package/build/utils/response-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-shape.d.ts","sourceRoot":"","sources":["../../src/utils/response-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAyBvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAM9D"}

package/build/utils/response-shape.js

@@ -0,0 +1,73 @@
+/**
+ * Recursively strip `null`, `undefined`, empty arrays, and empty objects
+ * from API responses before sending them to the LLM.
+ *
+ * Zero, false, and empty strings are preserved — they carry signal (e.g.
+ * `"description": ""` is different from missing description when the user
+ * asked about it).
+ *
+ * Returns `undefined` only when the input itself is `null` or `undefined`.
+ * For objects that collapse to zero kept fields, returns `{}` (an empty
+ * object) — callers should test with `Object.keys(result).length === 0` if
+ * they want to detect collapse, not `result === undefined`. Arrays that
+ * become empty are returned as `[]`.
+ */
+export function compactResponse(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        const compactedItems = [];
+        for (const item of value) {
+            const c = compactResponse(item);
+            if (c !== undefined)
+                compactedItems.push(c);
+        }
+        return compactedItems;
+    }
+    const record = value;
+    const out = {};
+    let kept = 0;
+    for (const key of Object.keys(record)) {
+        const c = compactResponse(record[key]);
+        if (c === undefined)
+            continue;
+        if (Array.isArray(c) && c.length === 0)
+            continue;
+        if (isPlainObject(c) && Object.keys(c).length === 0)
+            continue;
+        out[key] = c;
+        kept += 1;
+    }
+    return kept === 0 ? {} : out;
+}
+/**
+ * Keep only the listed top-level fields on an object, or apply the same
+ * projection to each element of an array.
+ *
+ * Special case: `['*']` returns the input unchanged.
+ */
+export function projectFields(value, fields) {
+    if (fields.length === 1 && fields[0] === '*')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((item) => projectSingle(item, fields));
+    }
+    return projectSingle(value, fields);
+}
+function projectSingle(obj, fields) {
+    if (!isPlainObject(obj))
+        return obj;
+    const src = obj;
+    const out = {};
+    for (const f of fields) {
+        if (f in src)
+            out[f] = src[f];
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=response-shape.js.map

package/build/utils/response-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-shape.js","sourceRoot":"","sources":["../../src/utils/response-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,cAAc,GAAc,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,SAAS;gBAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjD,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC9D,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAI,KAAQ,EAAE,MAAgB;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;IAC1E,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAM,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,GAAY,EAAE,MAAgB;IACnD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/build/utils/rich-response.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Rich Response Utilities
+ *
+ * Helpers for building multi-block MCP tool responses with audience annotations.
+ * Tools that return RichToolResult bypass the default JSON.stringify wrapping
+ * and deliver content blocks directly to the client.
+ *
+ * - summaryBlock: human-readable markdown for the user (audience: ['user'])
+ * - dataBlock: structured JSON for the assistant (audience: ['assistant'])
+ */
+/** Symbol marker to distinguish rich results from plain handler returns */
+declare const RICH_MARKER: unique symbol;
+/** A single content block in a rich tool result */
+export interface ContentBlock {
+    type: 'text';
+    text: string;
+    annotations?: {
+        audience?: Array<'user' | 'assistant'>;
+        priority?: number;
+    };
+}
+/** Pre-formatted tool result with multiple content blocks */
+export interface RichToolResult {
+    [RICH_MARKER]: true;
+    content: ContentBlock[];
+    /** Machine-readable data for programmatic processing by MCP clients */
+    structuredContent?: Record<string, unknown>;
+}
+/**
+ * Type guard: returns true if the value is a RichToolResult.
+ */
+export declare function isRichResult(value: unknown): value is RichToolResult;
+/**
+ * Build a rich tool result from content blocks.
+ * @param content - Content blocks for display
+ * @param structuredContent - Machine-readable data for programmatic client processing
+ */
+export declare function richResult(content: ContentBlock[], structuredContent?: Record<string, unknown>): RichToolResult;
+/**
+ * Create a user-facing summary block (markdown).
+ * Shown to the user with highest priority.
+ */
+export declare function summaryBlock(text: string): ContentBlock;
+/**
+ * Create an assistant-facing data block (JSON).
+ * Consumed by the LLM for further reasoning.
+ */
+export declare function dataBlock(data: unknown): ContentBlock;
+/**
+ * Build a markdown table with properly padded columns.
+ *
+ * @param headers - Column header labels
+ * @param rows - Array of row data (same length as headers)
+ * @param align - Per-column alignment: 'l' (left, default), 'r' (right), 'c' (center)
+ */
+export declare function markdownTable(headers: string[], rows: string[][], align?: string[]): string;
+export {};
+//# sourceMappingURL=rich-response.d.ts.map

package/build/utils/rich-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-response.d.ts","sourceRoot":"","sources":["../../src/utils/rich-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2EAA2E;AAC3E,QAAA,MAAM,WAAW,eAAiC,CAAC;AAEnD,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE;QACZ,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMpE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EAAE,EACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,cAAc,CAMhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAMvD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAMrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAgC3F"}

package/build/utils/rich-response.js

@@ -0,0 +1,93 @@
+/**
+ * Rich Response Utilities
+ *
+ * Helpers for building multi-block MCP tool responses with audience annotations.
+ * Tools that return RichToolResult bypass the default JSON.stringify wrapping
+ * and deliver content blocks directly to the client.
+ *
+ * - summaryBlock: human-readable markdown for the user (audience: ['user'])
+ * - dataBlock: structured JSON for the assistant (audience: ['assistant'])
+ */
+/** Symbol marker to distinguish rich results from plain handler returns */
+const RICH_MARKER = Symbol.for('qase.rich_result');
+/**
+ * Type guard: returns true if the value is a RichToolResult.
+ */
+export function isRichResult(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[RICH_MARKER] === true);
+}
+/**
+ * Build a rich tool result from content blocks.
+ * @param content - Content blocks for display
+ * @param structuredContent - Machine-readable data for programmatic client processing
+ */
+export function richResult(content, structuredContent) {
+    return {
+        [RICH_MARKER]: true,
+        content,
+        ...(structuredContent && { structuredContent }),
+    };
+}
+/**
+ * Create a user-facing summary block (markdown).
+ * Shown to the user with highest priority.
+ */
+export function summaryBlock(text) {
+    return {
+        type: 'text',
+        text,
+        annotations: { audience: ['user'], priority: 1 },
+    };
+}
+/**
+ * Create an assistant-facing data block (JSON).
+ * Consumed by the LLM for further reasoning.
+ */
+export function dataBlock(data) {
+    return {
+        type: 'text',
+        text: JSON.stringify(data),
+        annotations: { audience: ['assistant'], priority: 0 },
+    };
+}
+/**
+ * Build a markdown table with properly padded columns.
+ *
+ * @param headers - Column header labels
+ * @param rows - Array of row data (same length as headers)
+ * @param align - Per-column alignment: 'l' (left, default), 'r' (right), 'c' (center)
+ */
+export function markdownTable(headers, rows, align) {
+    // Compute max width per column
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)));
+    const pad = (s, w, a) => {
+        const gap = w - s.length;
+        if (gap <= 0)
+            return s;
+        if (a === 'r')
+            return ' '.repeat(gap) + s;
+        if (a === 'c')
+            return ' '.repeat(Math.floor(gap / 2)) + s + ' '.repeat(Math.ceil(gap / 2));
+        return s + ' '.repeat(gap);
+    };
+    const aligns = align ?? headers.map(() => 'l');
+    const headerRow = '| ' + headers.map((h, i) => pad(h, widths[i], aligns[i])).join(' | ') + ' |';
+    const sepRow = '| ' +
+        widths
+            .map((w, i) => {
+            const a = aligns[i];
+            const bar = '-'.repeat(w);
+            if (a === 'r')
+                return bar.slice(0, -1) + ':';
+            if (a === 'c')
+                return ':' + bar.slice(1, -1) + ':';
+            return bar;
+        })
+            .join(' | ') +
+        ' |';
+    const dataRows = rows.map((r) => '| ' + r.map((c, i) => pad(c ?? '', widths[i], aligns[i])).join(' | ') + ' |');
+    return [headerRow, sepRow, ...dataRows].join('\n');
+}
+//# sourceMappingURL=rich-response.js.map

package/build/utils/rich-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-response.js","sourceRoot":"","sources":["../../src/utils/rich-response.ts"],"names":[],"mappings":"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"}

package/build/utils/server-context.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Server Context
+ *
+ * Provides access to the MCP Server instance within tool handlers
+ * via AsyncLocalStorage, following the same pattern as auth-context.ts.
+ *
+ * This enables features that require server-level access (elicitation,
+ * tool list notifications) without passing the server through handler signatures.
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Per-request server storage.
+ * Holds the Server instance for the current request context.
+ */
+export declare const serverStorage: AsyncLocalStorage<Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>>;
+/**
+ * Get the Server instance from the current async context.
+ * Returns undefined if called outside of a serverStorage.run() scope.
+ */
+export declare function getServer(): Server | undefined;
+/**
+ * Ask the user to confirm a destructive action via MCP elicitation.
+ *
+ * Graceful degradation:
+ * - No server in context → proceed (return true)
+ * - Client doesn't support elicitation → proceed
+ * - elicitInput() throws → proceed (log error)
+ * - User declines or cancels → return false
+ */
+export declare function confirmDestructiveAction(toolName: string, args: Record<string, unknown>): Promise<boolean>;
+//# sourceMappingURL=server-context.d.ts.map

package/build/utils/server-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-context.d.ts","sourceRoot":"","sources":["../../src/utils/server-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAkC,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmClB"}