@qase/mcp-server 1.1.8 → 2.0.1

package/build/utils/case-enums.js

@@ -1,4 +1,6 @@
 import { getApiClient } from '../client/index.js';
+import { getCache, buildCacheKey, hashToken } from '../cache/index.js';
+import { getEffectiveToken } from './auth-context.js';
 const caseEnumFields = [
     'priority',
     'type',
@@ -8,85 +10,101 @@ const caseEnumFields = [
     'layer',
     'automation',
 ];
-let systemFieldCache = null;
+// System fields are workspace-level config (priority, severity, status options,
+// etc.) that change on the order of hours to days when an admin reconfigures
+// the workspace. 5 minutes balances freshness against API call frequency; do
+// not decrease below 1 minute without measuring.
+const SYSTEM_FIELDS_TTL_MS = 5 * 60 * 1000;
 function normalizeEnumValue(raw, lookup) {
-    if (raw === undefined || raw === null) {
+    if (raw === undefined || raw === null)
         return undefined;
-    }
-    if (typeof raw === 'number') {
+    if (typeof raw === 'number')
         return raw;
-    }
-    if (typeof raw === 'string') {
-        const trimmed = raw.trim();
-        if (trimmed === '') {
-            return undefined;
-        }
-        const parsed = Number(trimmed);
-        if (Number.isInteger(parsed)) {
-            return parsed;
-        }
-        const lower = trimmed.toLowerCase();
-        if (lookup?.has(lower)) {
-            return lookup.get(lower);
-        }
-    }
-    return undefined;
+    if (typeof raw !== 'string')
+        return undefined;
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return undefined;
+    const parsed = Number(trimmed);
+    if (Number.isInteger(parsed))
+        return parsed;
+    const lower = trimmed.toLowerCase();
+    return lookup?.[lower];
 }
-function createFieldMap(entry) {
-    if (!entry.options || entry.options.length === 0) {
+function buildFieldLookup(entry) {
+    if (!entry.options || entry.options.length === 0)
         return undefined;
+    const out = {};
+    for (const opt of entry.options) {
+        out[opt.slug.toLowerCase()] = opt.id;
+        if (opt.title)
+            out[opt.title.toLowerCase()] = opt.id;
+        out[opt.id.toString()] = opt.id;
     }
-    const map = new Map();
-    for (const option of entry.options) {
-        map.set(option.slug.toLowerCase(), option.id);
-        if (option.title) {
-            map.set(option.title.toLowerCase(), option.id);
-        }
-        map.set(option.id.toString(), option.id);
+    return out;
+}
+function systemFieldsKey() {
+    const token = getEffectiveToken();
+    const host = process.env.QASE_API_DOMAIN || 'api.qase.io';
+    return buildCacheKey({
+        host,
+        tenantId: hashToken(token),
+        resource: 'system_fields',
+    });
+}
+async function fetchSystemFieldMaps() {
+    const client = getApiClient();
+    const response = await client.systemFields.getSystemFields();
+    const map = {};
+    for (const entry of response.data.result) {
+        const slug = entry.slug.toLowerCase();
+        const lookup = buildFieldLookup(entry);
+        if (lookup)
+            map[slug] = lookup;
     }
     return map;
 }
+/**
+ * Resolve system-field metadata from cache, fetching from the API on miss.
+ *
+ * Note on concurrency: this function does not coalesce concurrent cache
+ * misses. If two requests race past a cold cache simultaneously, both will
+ * hit the API. This is deliberate — the axios-level in-flight deduplication
+ * added in Task 12 of the Phase 1 plan coalesces identical GETs at the HTTP
+ * layer, which is a more general fix that also covers other metadata
+ * fetches, so there is no need to reimplement it here.
+ */
 async function getSystemFieldMaps() {
-    if (systemFieldCache) {
-        return systemFieldCache;
-    }
-    const client = getApiClient();
-    systemFieldCache = client.systemFields
-        .getSystemFields()
-        .then((response) => {
-        const map = {};
-        for (const entry of response.data.result) {
-            const normalizedSlug = entry.slug.toLowerCase();
-            const fieldMap = createFieldMap(entry);
-            if (fieldMap) {
-                map[normalizedSlug] = fieldMap;
-            }
-        }
-        return map;
-    })
-        .catch((error) => {
-        systemFieldCache = null;
-        throw error;
-    });
-    return systemFieldCache;
+    const cache = await getCache();
+    const key = systemFieldsKey();
+    const cached = await cache.get(key);
+    if (cached)
+        return cached;
+    const fresh = await fetchSystemFieldMaps();
+    await cache.set(key, fresh, SYSTEM_FIELDS_TTL_MS);
+    return fresh;
 }
 export async function normalizeCaseEnums(caseData) {
     const normalized = { ...caseData };
     const systemFields = await getSystemFieldMaps();
     for (const field of caseEnumFields) {
-        const rawValue = normalized[field];
+        const raw = normalized[field];
         const lookup = systemFields[field];
-        const mappedValue = normalizeEnumValue(rawValue, lookup);
-        if (mappedValue !== undefined) {
-            normalized[field] = mappedValue;
+        const mapped = normalizeEnumValue(raw, lookup);
+        if (mapped !== undefined) {
+            normalized[field] = mapped;
         }
     }
     return normalized;
 }
-export function resetCaseEnumCacheForTest() {
-    systemFieldCache = null;
+/** @internal — used by tests to pre-populate the tenant-scoped shard. */
+export async function __setCaseEnumCacheForTest(snapshot) {
+    const cache = await getCache();
+    await cache.set(systemFieldsKey(), snapshot, SYSTEM_FIELDS_TTL_MS);
 }
-export function __setCaseEnumCacheForTest(snapshot) {
-    systemFieldCache = Promise.resolve(snapshot);
+/** @internal — used by tests to clear the tenant-scoped shard. */
+export async function resetCaseEnumCacheForTest() {
+    const cache = await getCache();
+    await cache.delete(systemFieldsKey());
 }
 //# sourceMappingURL=case-enums.js.map

package/build/utils/case-enums.js.map

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

package/build/utils/output-schemas.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Output Schemas for MCP Tools
+ *
+ * JSON Schema definitions describing tool output structure.
+ * Enables MCP clients to process results programmatically in a sandbox
+ * instead of passing raw JSON to the LLM (reduces token usage ~37%).
+ */
+import type { OutputSchema } from './registry.js';
+export declare const CiReportOutput: OutputSchema;
+export declare const RegressionRunOutput: OutputSchema;
+export declare const TriageDefectOutput: OutputSchema;
+export declare const QqlSearchOutput: OutputSchema;
+export declare const ProjectContextOutput: OutputSchema;
+export declare const DeleteOutput: OutputSchema;
+export declare const DiscoverToolsOutput: OutputSchema;
+//# sourceMappingURL=output-schemas.d.ts.map

package/build/utils/output-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.d.ts","sourceRoot":"","sources":["../../src/utils/output-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,cAAc,EAAE,YAQ5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,YAQjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,YAQhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,YAO7B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAWlC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,YAO1B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,YAkBjC,CAAC"}

package/build/utils/output-schemas.js

@@ -0,0 +1,82 @@
+/**
+ * Output Schemas for MCP Tools
+ *
+ * JSON Schema definitions describing tool output structure.
+ * Enables MCP clients to process results programmatically in a sandbox
+ * instead of passing raw JSON to the LLM (reduces token usage ~37%).
+ */
+export const CiReportOutput = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'integer', description: 'Created run ID' },
+        run_status: { type: 'string', enum: ['active', 'complete', 'complete_failed'] },
+        results_recorded: { type: 'integer', description: 'Number of results recorded' },
+    },
+    required: ['run_id', 'run_status', 'results_recorded'],
+};
+export const RegressionRunOutput = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'integer', description: 'Created run ID' },
+        cases_added: { type: 'integer', description: 'Number of cases added to the run' },
+        run: { type: 'object', description: 'Full run entity' },
+    },
+    required: ['run_id', 'cases_added'],
+};
+export const TriageDefectOutput = {
+    type: 'object',
+    properties: {
+        defect_id: { type: 'integer', description: 'Created defect ID' },
+        defect: { type: 'object', description: 'Full defect entity' },
+        linked_results: { type: 'integer', description: 'Number of linked result hashes' },
+    },
+    required: ['defect_id', 'linked_results'],
+};
+export const QqlSearchOutput = {
+    type: 'object',
+    properties: {
+        total: { type: 'integer', description: 'Total matching entities' },
+        entities: { type: 'array', description: 'Matching entities', items: { type: 'object' } },
+    },
+    required: ['total', 'entities'],
+};
+export const ProjectContextOutput = {
+    type: 'object',
+    properties: {
+        project: { type: 'object', description: 'Project details' },
+        suites: { type: 'object', description: 'Suites list with entities array' },
+        milestones: { type: 'object', description: 'Milestones list' },
+        environments: { type: 'object', description: 'Environments list' },
+        custom_fields: { type: 'object', description: 'Custom fields list' },
+        users: { type: 'object', description: 'Team members list' },
+    },
+    required: ['project', 'suites', 'milestones', 'environments'],
+};
+export const DeleteOutput = {
+    type: 'object',
+    properties: {
+        success: { type: 'boolean' },
+        id: { type: 'integer', description: 'Deleted entity ID' },
+    },
+    required: ['success'],
+};
+export const DiscoverToolsOutput = {
+    type: 'object',
+    properties: {
+        found: { type: 'integer', description: 'Number of matching tools' },
+        activated: { type: 'integer', description: 'Number of newly activated tools' },
+        tools: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    destructive: { type: 'boolean' },
+                },
+            },
+        },
+    },
+    required: ['found', 'activated', 'tools'],
+};
+//# sourceMappingURL=output-schemas.js.map

package/build/utils/output-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-schemas.js","sourceRoot":"","sources":["../../src/utils/output-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE;QAC1D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE;QAC/E,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4BAA4B,EAAE;KACjF;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,kBAAkB,CAAC;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE;QAC1D,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kCAAkC,EAAE;QACjF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;KACxD;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE;QAChE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QAC7D,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;KACnF;IACD,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;QAClE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;KACzF;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC;CAChC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;QAC1E,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;QAC9D,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;QAClE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACpE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;KAC5D;IACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAC;CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC5B,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE;KAC1D;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACnE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,iCAAiC,EAAE;QAC9E,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC/B,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBACjC;aACF;SACF;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;CAC1C,CAAC"}

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"}