@qase/mcp-server 1.0.0-beta.1 → 1.1.0

package/build/operations/system-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-fields.js","sourceRoot":"","sources":["../../src/operations/system-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,KAA6C;IAC3E,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAE,MAAc,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnF,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EACvC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,qFAAqF;IACvF,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"system-fields.js","sourceRoot":"","sources":["../../src/operations/system-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5C,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;;;GAIG;AACH,KAAK,UAAU,gBAAgB,CAAC,KAA6C;IAC3E,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAE1E,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAClC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,eAAe,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,qFAAqF;IACvF,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC"}

package/build/operations/users.d.ts

@@ -3,6 +3,8 @@
  *
  * Implements all MCP tools for managing users in Qase.
  * Users are team members with access to the Qase workspace.
+ *
+ * https://developers.qase.io/reference/get-users
  */
 export {};
 //# sourceMappingURL=users.d.ts.map

package/build/operations/users.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/operations/users.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/operations/users.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/build/operations/users.js

@@ -3,24 +3,29 @@
  *
  * Implements all MCP tools for managing users in Qase.
  * Users are team members with access to the Qase workspace.
+ *
+ * https://developers.qase.io/reference/get-users
  */
 import { z } from 'zod';
 import { getApiClient } from '../client/index.js';
 import { toolRegistry } from '../utils/registry.js';
-import { toResultAsync } from '../utils/errors.js';
+import { toResultAsync, createToolError } from '../utils/errors.js';
 import { IdSchema } from '../utils/validation.js';
 // ============================================================================
 // SCHEMAS
 // ============================================================================
 /**
  * Schema for listing users
+ * API: GET /v1/user
+ * https://developers.qase.io/reference/get-users
+ *
+ * The Qase API does not document pagination parameters for this endpoint.
  */
-const ListUsersSchema = z.object({
-    limit: z.number().int().positive().max(100).optional().describe('Maximum number of items'),
-    offset: z.number().int().nonnegative().optional().describe('Number of items to skip'),
-});
+const ListUsersSchema = z.object({});
 /**
  * Schema for getting a specific user
+ * API: GET /v1/user/{id}
+ * https://developers.qase.io/reference/get-user
  */
 const GetUserSchema = z.object({
     id: IdSchema,
@@ -30,24 +35,27 @@ const GetUserSchema = z.object({
 // ============================================================================
 /**
  * List all users
+ * API: GET /v1/user
+ * https://developers.qase.io/reference/get-users
  */
-async function listUsers(args) {
+async function listUsers(_args) {
     const client = getApiClient();
-    const { limit, offset } = args;
-    const result = await toResultAsync(client.users.getUsers(limit, offset));
+    const result = await toResultAsync(client.users.getUsers());
     return result.match((response) => response.data.result, (error) => {
-        throw new Error(error);
+        throw createToolError(error, 'listing users');
     });
 }
 /**
  * Get a specific user
+ * API: GET /v1/user/{id}
+ * https://developers.qase.io/reference/get-user
  */
 async function getUser(args) {
     const client = getApiClient();
     const { id } = args;
     const result = await toResultAsync(client.users.getUser(id));
     return result.match((response) => response.data.result, (error) => {
-        throw new Error(error);
+        throw createToolError(error, 'getting user');
     });
 }
 // ============================================================================
@@ -55,7 +63,7 @@ async function getUser(args) {
 // ============================================================================
 toolRegistry.register({
     name: 'list_users',
-    description: 'Get all users in the workspace with optional pagination',
+    description: 'Get all users in the workspace',
     schema: ListUsersSchema,
     handler: listUsers,
 });

package/build/operations/users.js.map

@@ -1 +1 @@
-{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/operations/users.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC1F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACtF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,EAAE,EAAE,QAAQ;CACb,CAAC,CAAC;AAEH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,IAAqC;IAC5D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE/B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAE,MAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAElF,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EACvC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,OAAO,CAAC,IAAmC;IACxD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IAEpB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAE,MAAc,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EACvC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,yDAAyD;IACtE,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,2BAA2B;IACxC,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC"}
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/operations/users.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErC;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,EAAE,EAAE,QAAQ;CACb,CAAC,CAAC;AAEH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;;;GAIG;AACH,KAAK,UAAU,SAAS,CAAC,KAAsC;IAC7D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAClC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAChD,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,OAAO,CAAC,IAAmC;IACxD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IAEpB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7D,OAAO,MAAM,CAAC,KAAK,CACjB,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAClC,CAAC,KAAK,EAAE,EAAE;QACR,MAAM,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,gCAAgC;IAC7C,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH,YAAY,CAAC,QAAQ,CAAC;IACpB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,2BAA2B;IACxC,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC"}

package/build/transports/sse.d.ts

@@ -0,0 +1,10 @@
+import { Express } from 'express';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface SSETransportConfig {
+    port: number;
+    host?: string;
+    sseEndpoint?: string;
+    messagesEndpoint?: string;
+}
+export declare function setupSSETransport(server: Server, config: SSETransportConfig): Express;
+//# sourceMappingURL=sse.d.ts.map

package/build/transports/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAInE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAwCrF"}

package/build/transports/sse.js

@@ -0,0 +1,38 @@
+import express from 'express';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { requestTokenStorage } from '../utils/auth-context.js';
+export function setupSSETransport(server, config) {
+    const app = express();
+    app.use(express.json());
+    const sseEndpoint = config.sseEndpoint || '/sse';
+    const messagesEndpoint = config.messagesEndpoint || '/messages';
+    const host = config.host || '0.0.0.0';
+    let transport = null;
+    // Health check endpoint
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', transport: 'sse' });
+    });
+    // SSE endpoint for establishing connection
+    app.get(sseEndpoint, (_req, res) => {
+        console.error('[SSE] Client connected');
+        transport = new SSEServerTransport(messagesEndpoint, res);
+        server.connect(transport);
+    });
+    // Messages endpoint for receiving client messages
+    app.post(messagesEndpoint, (req, res) => {
+        if (!transport) {
+            res.status(503).json({ error: 'No SSE connection established' });
+            return;
+        }
+        const authHeader = req.headers['authorization'] || '';
+        const requestToken = authHeader.startsWith('Bearer ') ? authHeader.slice(7).trim() : '';
+        requestTokenStorage.run(requestToken, () => transport.handlePostMessage(req, res));
+    });
+    // Start server
+    app.listen(config.port, host, () => {
+        console.error(`[SSE] Server listening on http://${host}:${config.port}${sseEndpoint}`);
+        console.error(`[SSE] Health check: http://${host}:${config.port}/health`);
+    });
+    return app;
+}
+//# sourceMappingURL=sse.js.map

package/build/transports/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/transports/sse.ts"],"names":[],"mappings":"AAAA,OAAO,OAAoB,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAS/D,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,MAA0B;IAC1E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC;IACjD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,WAAW,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;IAEtC,IAAI,SAAS,GAA8B,IAAI,CAAC;IAEhD,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACxC,SAAS,GAAG,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAClD,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAI,GAAG,CAAC,OAAO,CAAC,eAAe,CAAY,IAAI,EAAE,CAAC;QAClE,MAAM,YAAY,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,mBAAmB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,SAAU,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QACjC,OAAO,CAAC,KAAK,CAAC,oCAAoC,IAAI,IAAI,MAAM,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,KAAK,CAAC,8BAA8B,IAAI,IAAI,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/build/transports/streamableHttp.d.ts

@@ -0,0 +1,9 @@
+import { Express } from 'express';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface StreamableHttpConfig {
+    port: number;
+    host?: string;
+    endpoint?: string;
+}
+export declare function setupStreamableHttpTransport(createServer: () => Server, config: StreamableHttpConfig): Express;
+//# sourceMappingURL=streamableHttp.d.ts.map

package/build/transports/streamableHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamableHttp.d.ts","sourceRoot":"","sources":["../../src/transports/streamableHttp.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAKnE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,MAAM,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CA+LT"}

package/build/transports/streamableHttp.js

@@ -0,0 +1,169 @@
+import express from 'express';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { randomUUID } from 'crypto';
+import { requestTokenStorage } from '../utils/auth-context.js';
+// Helper to check if a request is an initialize request
+function isInitializeRequest(body) {
+    return (typeof body === 'object' && body !== null && 'method' in body && body.method === 'initialize');
+}
+export function setupStreamableHttpTransport(createServer, config) {
+    const app = express();
+    // CORS middleware for inspector
+    app.use((req, res, next) => {
+        res.header('Access-Control-Allow-Origin', process.env.CORS_ORIGIN || '*');
+        res.header('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+        res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization, mcp-session-id');
+        if (req.method === 'OPTIONS') {
+            res.sendStatus(200);
+            return;
+        }
+        // Log request (omit headers to avoid exposing Authorization token in logs)
+        console.error(`[StreamableHTTP] ${req.method} ${req.path}`, { query: req.query });
+        next();
+    });
+    app.use(express.json());
+    const endpoint = config.endpoint || '/mcp';
+    const host = config.host || '0.0.0.0';
+    // Session management - store transport and last-seen timestamp per session
+    const SESSION_TTL_MS = 30 * 60 * 1000; // 30 minutes
+    const sessions = new Map();
+    const sessionLastSeen = new Map();
+    // Periodically evict stale sessions that never sent a DELETE
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [id, ts] of sessionLastSeen) {
+            if (now - ts > SESSION_TTL_MS) {
+                const staleTransport = sessions.get(id);
+                if (staleTransport) {
+                    staleTransport.close().catch(() => { });
+                    sessions.delete(id);
+                }
+                sessionLastSeen.delete(id);
+                console.error(`[StreamableHTTP] Evicted stale session: ${id}`);
+            }
+        }
+    }, 5 * 60 * 1000); // check every 5 minutes
+    cleanupInterval.unref(); // don't keep the process alive just for cleanup
+    // Health check endpoint
+    app.get('/health', (_req, res) => {
+        res.json({ status: 'ok', transport: 'streamable-http' });
+    });
+    // MCP endpoint - DELETE for session cleanup
+    app.delete(endpoint, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !sessions.has(sessionId)) {
+            res.status(400).json({
+                error: 'Invalid or missing session ID',
+            });
+            return;
+        }
+        const transport = sessions.get(sessionId);
+        try {
+            await transport.close();
+            sessions.delete(sessionId);
+            sessionLastSeen.delete(sessionId);
+            console.error(`[StreamableHTTP] Session closed: ${sessionId}`);
+            res.status(200).json({ status: 'session closed' });
+        }
+        catch (error) {
+            console.error('[StreamableHTTP] Error closing session:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: 'Internal server error',
+                });
+            }
+        }
+    });
+    // MCP endpoint - GET for SSE streams (if needed)
+    app.get(endpoint, async (req, res) => {
+        const sessionId = req.headers['mcp-session-id'];
+        if (!sessionId || !sessions.has(sessionId)) {
+            res.status(400).json({
+                error: 'Invalid or missing session ID',
+            });
+            return;
+        }
+        const transport = sessions.get(sessionId);
+        try {
+            await transport.handleRequest(req, res);
+        }
+        catch (error) {
+            console.error('[StreamableHTTP] Error handling GET request:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: 'Internal server error',
+                });
+            }
+        }
+    });
+    // MCP endpoint - POST for messages
+    app.post(endpoint, async (req, res) => {
+        console.error(`[StreamableHTTP] POST ${endpoint} received`, {
+            sessionId: req.headers['mcp-session-id'],
+            body: req.body,
+        });
+        const sessionId = req.headers['mcp-session-id'];
+        let transport;
+        if (sessionId && sessions.has(sessionId)) {
+            // Reuse existing transport for this session — bump last-seen
+            transport = sessions.get(sessionId);
+            sessionLastSeen.set(sessionId, Date.now());
+        }
+        else if (isInitializeRequest(req.body)) {
+            // This is an initialize request - create new session
+            const newSessionId = randomUUID();
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => newSessionId,
+                enableJsonResponse: true,
+            });
+            // Store session and record creation time
+            sessions.set(newSessionId, transport);
+            sessionLastSeen.set(newSessionId, Date.now());
+            // Create a fresh Server instance per session — the SDK requires one Server per transport
+            await createServer().connect(transport);
+            console.error(`[StreamableHTTP] New session created: ${newSessionId}`);
+        }
+        else {
+            // Invalid request - has session ID but session not found
+            res.status(400).json({
+                error: 'Invalid request: session not found or not an initialize request',
+            });
+            return;
+        }
+        // Extract per-request token from Authorization header (Bearer <token>)
+        const authHeader = req.headers['authorization'] || '';
+        const requestToken = authHeader.startsWith('Bearer ') ? authHeader.slice(7).trim() : '';
+        if (requestToken) {
+            console.error('[StreamableHTTP] Using per-request Bearer token');
+        }
+        // Run the handler inside AsyncLocalStorage context so getApiClient() can read the token
+        try {
+            await requestTokenStorage.run(requestToken, () => transport.handleRequest(req, res, req.body));
+        }
+        catch (error) {
+            console.error('[StreamableHTTP] Error handling request:', error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: 'Internal server error',
+                });
+            }
+        }
+    });
+    // Start server and store reference to keep it alive
+    const httpServer = app.listen(config.port, host, () => {
+        console.error(`[StreamableHTTP] Server listening on http://${host}:${config.port}${endpoint}`);
+        console.error(`[StreamableHTTP] Health check: http://${host}:${config.port}/health`);
+    });
+    // Handle server errors
+    httpServer.on('error', (error) => {
+        console.error('[StreamableHTTP] Server error:', error);
+    });
+    // Handle client connections
+    httpServer.on('connection', (socket) => {
+        console.error(`[StreamableHTTP] New client connection from ${socket.remoteAddress}:${socket.remotePort}`);
+    });
+    // Keep server reference alive (prevent garbage collection)
+    app._httpServer = httpServer;
+    return app;
+}
+//# sourceMappingURL=streamableHttp.js.map

package/build/transports/streamableHttp.js.map

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

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

@@ -0,0 +1,8 @@
+import { AsyncLocalStorage } from 'async_hooks';
+/**
+ * Per-request token storage.
+ * Holds the Bearer token extracted from the Authorization header for the current request.
+ * Empty string means no user token — fall back to shared QASE_API_TOKEN.
+ */
+export declare const requestTokenStorage: AsyncLocalStorage<string>;
+//# sourceMappingURL=auth-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../src/utils/auth-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,2BAAkC,CAAC"}

package/build/utils/auth-context.js

@@ -0,0 +1,8 @@
+import { AsyncLocalStorage } from 'async_hooks';
+/**
+ * Per-request token storage.
+ * Holds the Bearer token extracted from the Authorization header for the current request.
+ * Empty string means no user token — fall back to shared QASE_API_TOKEN.
+ */
+export const requestTokenStorage = new AsyncLocalStorage();
+//# sourceMappingURL=auth-context.js.map

package/build/utils/auth-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.js","sourceRoot":"","sources":["../../src/utils/auth-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,iBAAiB,EAAU,CAAC"}

package/build/utils/case-enums.d.ts

@@ -0,0 +1,6 @@
+type SystemFieldMap = Record<string, Map<string, number>>;
+export declare function normalizeCaseEnums<T extends Record<string, unknown>>(caseData: T): Promise<T>;
+export declare function resetCaseEnumCacheForTest(): void;
+export declare function __setCaseEnumCacheForTest(snapshot: SystemFieldMap): void;
+export {};
+//# sourceMappingURL=case-enums.d.ts.map

package/build/utils/case-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-enums.d.ts","sourceRoot":"","sources":["../../src/utils/case-enums.ts"],"names":[],"mappings":"AAwBA,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAsF1D,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAExE"}

package/build/utils/case-enums.js

@@ -0,0 +1,91 @@
+import { getApiClient } from '../client/index.js';
+const caseEnumFields = [
+    'priority',
+    'type',
+    'behavior',
+    'severity',
+    'status',
+    'layer',
+];
+let systemFieldCache = null;
+function normalizeEnumValue(raw, lookup) {
+    if (raw === undefined || raw === null) {
+        return undefined;
+    }
+    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;
+}
+function createFieldMap(entry) {
+    if (!entry.options || entry.options.length === 0) {
+        return undefined;
+    }
+    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 map;
+}
+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;
+}
+export async function normalizeCaseEnums(caseData) {
+    const normalized = { ...caseData };
+    const systemFields = await getSystemFieldMaps();
+    for (const field of caseEnumFields) {
+        const rawValue = normalized[field];
+        const lookup = systemFields[field];
+        const mappedValue = normalizeEnumValue(rawValue, lookup);
+        if (mappedValue !== undefined) {
+            normalized[field] = mappedValue;
+        }
+    }
+    return normalized;
+}
+export function resetCaseEnumCacheForTest() {
+    systemFieldCache = null;
+}
+export function __setCaseEnumCacheForTest(snapshot) {
+    systemFieldCache = Promise.resolve(snapshot);
+}
+//# sourceMappingURL=case-enums.js.map

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

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

package/build/utils/errors.d.ts

@@ -17,6 +17,23 @@ export declare class QaseApiError extends Error {
     details?: unknown | undefined;
     constructor(message: string, statusCode?: number | undefined, errorCode?: string | undefined, details?: unknown | undefined);
 }
+/**
+ * Error class for tool execution errors
+ *
+ * Use this for expected failures during tool execution (API errors, validation errors,
+ * business logic errors). These errors are returned to the LLM with isError: true,
+ * allowing the LLM to understand the failure and take corrective action.
+ *
+ * Protocol errors (unknown tool, invalid schema) should use regular Error instead.
+ */
+export declare class ToolExecutionError extends Error {
+    suggestion?: string | undefined;
+    constructor(message: string, suggestion?: string | undefined);
+    /**
+     * Format the error message for LLM consumption
+     */
+    toUserMessage(): string;
+}
 /**
  * Format API error into a user-friendly message
  *
@@ -70,4 +87,12 @@ export declare function isRateLimitError(error: unknown): boolean;
  * ```
  */
 export declare function toResultAsync<T>(promise: Promise<T>): ResultAsync<T, string>;
+/**
+ * Create a ToolExecutionError from an API error with helpful suggestions
+ *
+ * @param error - The formatted error message
+ * @param context - Optional context about the operation (e.g., "creating project")
+ * @returns ToolExecutionError with suggestion for recovery
+ */
+export declare function createToolError(error: string, context?: string): ToolExecutionError;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,UAAU,CAAC,EAAE,MAAM;IACnB,SAAS,CAAC,EAAE,MAAM;IAClB,OAAO,CAAC,EAAE,OAAO;gBAHxB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,OAAO,YAAA;CAM3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4CrD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAE5E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,UAAU,CAAC,EAAE,MAAM;IACnB,SAAS,CAAC,EAAE,MAAM;IAClB,OAAO,CAAC,EAAE,OAAO;gBAHxB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,OAAO,CAAC,EAAE,OAAO,YAAA;CAM3B;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGlC,UAAU,CAAC,EAAE,MAAM;gBAD1B,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA;IAO5B;;OAEG;IACH,aAAa,IAAI,MAAM;CAMxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4CrD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAGnF"}

package/build/utils/errors.js

@@ -25,6 +25,33 @@ export class QaseApiError extends Error {
         Object.setPrototypeOf(this, QaseApiError.prototype);
     }
 }
+/**
+ * Error class for tool execution errors
+ *
+ * Use this for expected failures during tool execution (API errors, validation errors,
+ * business logic errors). These errors are returned to the LLM with isError: true,
+ * allowing the LLM to understand the failure and take corrective action.
+ *
+ * Protocol errors (unknown tool, invalid schema) should use regular Error instead.
+ */
+export class ToolExecutionError extends Error {
+    suggestion;
+    constructor(message, suggestion) {
+        super(message);
+        this.suggestion = suggestion;
+        this.name = 'ToolExecutionError';
+        Object.setPrototypeOf(this, ToolExecutionError.prototype);
+    }
+    /**
+     * Format the error message for LLM consumption
+     */
+    toUserMessage() {
+        if (this.suggestion) {
+            return `${this.message}\n\nSuggestion: ${this.suggestion}`;
+        }
+        return this.message;
+    }
+}
 /**
  * Format API error into a user-friendly message
  *
@@ -133,4 +160,55 @@ export function isRateLimitError(error) {
 export function toResultAsync(promise) {
     return ResultAsync.fromPromise(promise, formatApiError);
 }
+/**
+ * Create a ToolExecutionError from an API error with helpful suggestions
+ *
+ * @param error - The formatted error message
+ * @param context - Optional context about the operation (e.g., "creating project")
+ * @returns ToolExecutionError with suggestion for recovery
+ */
+export function createToolError(error, context) {
+    const suggestion = getSuggestionForError(error, context);
+    return new ToolExecutionError(error, suggestion);
+}
+/**
+ * Get a helpful suggestion based on the error message
+ */
+function getSuggestionForError(error, context) {
+    const lowerError = error.toLowerCase();
+    // Authentication errors
+    if (lowerError.includes('authentication failed') || lowerError.includes('401')) {
+        return 'Check that QASE_API_TOKEN environment variable is set correctly.';
+    }
+    // Permission errors
+    if (lowerError.includes('forbidden') || lowerError.includes('403')) {
+        return 'Verify you have the required permissions for this operation.';
+    }
+    // Not found errors
+    if (lowerError.includes('not found') || lowerError.includes('404')) {
+        return 'Verify the resource exists. Use the appropriate list or get tool to check.';
+    }
+    // Validation errors - try to provide context-specific suggestions
+    if (lowerError.includes('invalid') || lowerError.includes('validation')) {
+        if (context?.includes('project')) {
+            return 'The project code may already exist, or the input data is invalid. Use list_projects or get_project to check existing projects.';
+        }
+        if (context?.includes('case')) {
+            return 'Verify the project code exists and the case data is valid. Use get_project to check the project.';
+        }
+        if (context?.includes('run')) {
+            return 'Verify the project code exists and the run configuration is valid.';
+        }
+        return 'Check that all required fields are provided and values are in the correct format.';
+    }
+    // Rate limiting
+    if (lowerError.includes('rate limit') || lowerError.includes('429')) {
+        return 'Wait a moment and try again, or reduce the frequency of requests.';
+    }
+    // Server errors
+    if (lowerError.includes('server error') || lowerError.includes('5')) {
+        return 'This is a temporary server issue. Please try again later.';
+    }
+    return undefined;
+}
 //# sourceMappingURL=errors.js.map