@qase/mcp-server 1.1.8 → 2.0.1

package/build/cache/redis.d.ts

@@ -0,0 +1,32 @@
+import { CacheBackend } from './types.js';
+import { CircuitBreaker } from './circuit-breaker.js';
+export interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode: 'PX', ttlMs: number): Promise<'OK' | null>;
+    del(...keys: string[]): Promise<number>;
+    scan(cursor: string, matchKey: 'MATCH', pattern: string, countKey: 'COUNT', count: number): Promise<[string, string[]]>;
+    unlink(...keys: string[]): Promise<number>;
+    quit(): Promise<'OK'>;
+}
+export interface RedisCacheOptions {
+    circuitBreaker?: CircuitBreaker;
+}
+/**
+ * Redis-backed CacheBackend with graceful degradation.
+ *
+ * All upstream calls run through an optional circuit breaker. On any failure
+ * the breaker records it, the qase_mcp_cache_errors_total{tier="l2"} counter
+ * increments, and the read path returns undefined (miss). Write paths swallow
+ * errors so the caller is never blocked on a Redis outage.
+ */
+export declare class RedisCache implements CacheBackend {
+    private readonly client;
+    private readonly cb;
+    constructor(client: RedisLikeClient, opts?: RedisCacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    deleteByPrefix(prefix: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/build/cache/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/cache/redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACjF,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CACF,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAW,YAAW,YAAY;IAI3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAGjB,MAAM,EAAE,eAAe,EACxC,IAAI,GAAE,iBAAsB;IAiBxB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAqB3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/build/cache/redis.js

@@ -0,0 +1,89 @@
+import { CircuitBreaker } from './circuit-breaker.js';
+import { getMetrics } from './metrics.js';
+/**
+ * Redis-backed CacheBackend with graceful degradation.
+ *
+ * All upstream calls run through an optional circuit breaker. On any failure
+ * the breaker records it, the qase_mcp_cache_errors_total{tier="l2"} counter
+ * increments, and the read path returns undefined (miss). Write paths swallow
+ * errors so the caller is never blocked on a Redis outage.
+ */
+export class RedisCache {
+    client;
+    cb;
+    constructor(client, opts = {}) {
+        this.client = client;
+        this.cb =
+            opts.circuitBreaker ??
+                new CircuitBreaker({
+                    name: 'redis',
+                    failureThreshold: 5,
+                    openDurationMs: 30_000,
+                    onStateChange: (s) => getMetrics().setGauge('qase_mcp_circuit_breaker_state', { name: 'redis' }, s === 'closed' ? 0 : s === 'half_open' ? 1 : 2),
+                });
+    }
+    async get(key) {
+        try {
+            const raw = await this.cb.exec(() => this.client.get(key));
+            if (raw === null) {
+                getMetrics().incCounter('qase_mcp_cache_misses_total', { tier: 'l2' });
+                return undefined;
+            }
+            try {
+                const v = JSON.parse(raw);
+                getMetrics().incCounter('qase_mcp_cache_hits_total', { tier: 'l2' });
+                return v;
+            }
+            catch {
+                getMetrics().incCounter('qase_mcp_cache_misses_total', { tier: 'l2' });
+                return undefined;
+            }
+        }
+        catch {
+            getMetrics().incCounter('qase_mcp_cache_errors_total', { tier: 'l2' });
+            return undefined;
+        }
+    }
+    async set(key, value, ttlMs) {
+        try {
+            await this.cb.exec(() => this.client.set(key, JSON.stringify(value), 'PX', ttlMs));
+        }
+        catch {
+            getMetrics().incCounter('qase_mcp_cache_errors_total', { tier: 'l2' });
+        }
+    }
+    async delete(key) {
+        try {
+            await this.cb.exec(() => this.client.del(key).then(() => undefined));
+        }
+        catch {
+            getMetrics().incCounter('qase_mcp_cache_errors_total', { tier: 'l2' });
+        }
+    }
+    async deleteByPrefix(prefix) {
+        try {
+            await this.cb.exec(async () => {
+                const pattern = `${prefix}*`;
+                let cursor = '0';
+                do {
+                    const [next, keys] = await this.client.scan(cursor, 'MATCH', pattern, 'COUNT', 200);
+                    if (keys.length > 0)
+                        await this.client.unlink(...keys);
+                    cursor = next;
+                } while (cursor !== '0');
+            });
+        }
+        catch {
+            getMetrics().incCounter('qase_mcp_cache_errors_total', { tier: 'l2' });
+        }
+    }
+    async close() {
+        try {
+            await this.client.quit();
+        }
+        catch {
+            // best-effort on shutdown
+        }
+    }
+}
+//# sourceMappingURL=redis.js.map

package/build/cache/redis.js.map

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

package/build/cache/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cache abstraction. Implementations: InMemoryCache (Plan 1),
+ * LayeredCache wrapping an optional RedisCache (Plan 2).
+ */
+export interface CacheBackend {
+    /**
+     * Look up a cached value. Returns undefined on miss or expiration.
+     * Must never cross tenant boundaries — all isolation happens through the key.
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Write a value with a TTL in milliseconds. Overwrites any existing entry.
+     */
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    /**
+     * Remove a single entry. Silently no-op if key is absent.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Remove every entry whose key starts with the given prefix.
+     * Used for tenant-scoped invalidation and schema-version rollovers.
+     */
+    deleteByPrefix(prefix: string): Promise<void>;
+    /**
+     * Release underlying resources (timers, network connections).
+     */
+    close(): Promise<void>;
+}
+/**
+ * Cross-instance invalidation bus. Implemented in Plan 2 with Redis Pub/Sub;
+ * unused in Plan 1.
+ */
+export interface InvalidationBus {
+    publish(prefix: string): Promise<void>;
+    subscribe(handler: (prefix: string) => void): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE5C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/build/cache/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":""}

package/build/client/index.d.ts

@@ -8,7 +8,13 @@
  * - Environment-based configuration
  */
 import { ProjectsApi, CasesApi, SuitesApi, RunsApi, ResultsApi, PlansApi, MilestonesApi, DefectsApi, EnvironmentsApi, AttachmentsApi, SharedStepsApi, AuthorsApi, CustomFieldsApi, SearchApi, ConfigurationsApi, SystemFieldsApi, UsersApi, SharedParametersApi } from 'qase-api-client';
-import { AxiosRequestConfig } from 'axios';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+/**
+ * Build the User-Agent / source string sent to the Qase API. Qase uses this to
+ * attribute the request source. Defaults to `qase-mcp`; the hosted deployment
+ * sets `QASE_MCP_SOURCE=qase-mcp-hosted` to distinguish it from the self-run CLI.
+ */
+export declare function getUserAgent(): string;
 /**
  * Configuration for the Qase API client
  */
@@ -40,7 +46,8 @@ declare class QaseApiClient {
     readonly sharedParameters: SharedParametersApi;
     private readonly token;
     private readonly host;
-    constructor(config: ApiClientConfig);
+    private readonly axiosInstance;
+    constructor(config: ApiClientConfig, axiosInstance?: AxiosInstance);
     /**
      * Make a direct API call for endpoints not fully covered by the SDK.
      */
@@ -63,5 +70,5 @@ export declare function getApiClient(): QaseApiClient;
  * @internal
  */
 export declare function resetClientInstance(): void;
-export type { QaseApiClient };
+export { QaseApiClient };
 //# sourceMappingURL=index.d.ts.map

package/build/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACR,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAc,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAOlD;;GAEG;AACH,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,cAAM,aAAa;IACjB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,MAAM,EAAE,eAAe;IAiCnC;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;CAenF;AAqDD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAY5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,QAAQ,EACR,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACR,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAQjE;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,cAAM,aAAa;IACjB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,MAAM,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,aAAa;IAkElE;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;CAoBnF;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,aAAa,CAY5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/build/client/index.js

@@ -9,10 +9,21 @@
  */
 import { Configuration, ProjectsApi, CasesApi, SuitesApi, RunsApi, ResultsApi, PlansApi, MilestonesApi, DefectsApi, EnvironmentsApi, AttachmentsApi, SharedStepsApi, AuthorsApi, CustomFieldsApi, SearchApi, ConfigurationsApi, SystemFieldsApi, UsersApi, SharedParametersApi, } from 'qase-api-client';
 import axios from 'axios';
+import { createKeepAliveAgent, attachRetry, attachInflightDedupe } from '../http/index.js';
+import { isJwt } from '../auth/token-type.js';
 import FormData from 'form-data';
-import { requestTokenStorage } from '../utils/auth-context.js';
+import { requestTokenStorage, getEffectiveToken } from '../utils/auth-context.js';
+import { getServer } from '../utils/server-context.js';
 import { VERSION } from '../version.js';
-const USER_AGENT = `qase-mcp/${VERSION}`;
+/**
+ * Build the User-Agent / source string sent to the Qase API. Qase uses this to
+ * attribute the request source. Defaults to `qase-mcp`; the hosted deployment
+ * sets `QASE_MCP_SOURCE=qase-mcp-hosted` to distinguish it from the self-run CLI.
+ */
+export function getUserAgent() {
+    const source = process.env.QASE_MCP_SOURCE?.trim() || 'qase-mcp';
+    return `${source}/${VERSION}`;
+}
 /**
  * Wrapper around qase-api-client that preserves the `client.resource.method()` interface.
  */
@@ -37,50 +48,82 @@ class QaseApiClient {
     sharedParameters;
     token;
     host;
-    constructor(config) {
+    axiosInstance;
+    constructor(config, axiosInstance) {
         this.token = config.token;
         this.host = config.host;
+        const jwtToken = isJwt(config.token);
+        const agent = createKeepAliveAgent({ maxSockets: 20 });
+        this.axiosInstance =
+            axiosInstance ??
+                axios.create({ httpsAgent: agent, headers: { 'User-Agent': getUserAgent() } });
+        // For JWTs, forward verbatim as Authorization: Bearer on every request.
+        // Opaque tokens keep using the Qase `Token` header via Configuration.apiKey.
+        if (jwtToken) {
+            this.axiosInstance.interceptors.request.use((req) => {
+                req.headers = req.headers ?? {};
+                req.headers['Authorization'] = `Bearer ${config.token}`;
+                return req;
+            });
+        }
+        // Tag each Qase API request with the MCP client identity (which AI host/model
+        // is using the connector) for backend metrics. Sourced per-request from the
+        // MCP `initialize` clientInfo, read via serverStorage during tool execution.
+        this.axiosInstance.interceptors.request.use((req) => {
+            const client = getServer()?.getClientVersion();
+            if (client?.name) {
+                req.headers = req.headers ?? {};
+                req.headers['X-MCP-Client-Name'] = client.name;
+                if (client.version) {
+                    req.headers['X-MCP-Client-Version'] = client.version;
+                }
+            }
+            return req;
+        });
+        attachRetry(this.axiosInstance);
+        attachInflightDedupe(this.axiosInstance);
+        const basePath = `${config.host}/v1`;
         const cfg = new Configuration({
-            apiKey: config.token,
-            basePath: `${config.host}/v1`,
+            ...(jwtToken ? {} : { apiKey: config.token }),
+            basePath,
             formDataCtor: FormData,
-            baseOptions: {
-                headers: { 'User-Agent': USER_AGENT },
-            },
         });
-        this.projects = new ProjectsApi(cfg);
-        this.cases = new CasesApi(cfg);
-        this.suites = new SuitesApi(cfg);
-        this.runs = new RunsApi(cfg);
-        this.results = new ResultsApi(cfg);
-        this.plans = new PlansApi(cfg);
-        this.milestones = new MilestonesApi(cfg);
-        this.defects = new DefectsApi(cfg);
-        this.environment = new EnvironmentsApi(cfg);
-        this.attachments = new AttachmentsApi(cfg);
-        this.sharedSteps = new SharedStepsApi(cfg);
-        this.authors = new AuthorsApi(cfg);
-        this.customFields = new CustomFieldsApi(cfg);
-        this.search = new SearchApi(cfg);
-        this.configurations = new ConfigurationsApi(cfg);
-        this.systemFields = new SystemFieldsApi(cfg);
-        this.users = new UsersApi(cfg);
-        this.sharedParameters = new SharedParametersApi(cfg);
+        this.projects = new ProjectsApi(cfg, basePath, this.axiosInstance);
+        this.cases = new CasesApi(cfg, basePath, this.axiosInstance);
+        this.suites = new SuitesApi(cfg, basePath, this.axiosInstance);
+        this.runs = new RunsApi(cfg, basePath, this.axiosInstance);
+        this.results = new ResultsApi(cfg, basePath, this.axiosInstance);
+        this.plans = new PlansApi(cfg, basePath, this.axiosInstance);
+        this.milestones = new MilestonesApi(cfg, basePath, this.axiosInstance);
+        this.defects = new DefectsApi(cfg, basePath, this.axiosInstance);
+        this.environment = new EnvironmentsApi(cfg, basePath, this.axiosInstance);
+        this.attachments = new AttachmentsApi(cfg, basePath, this.axiosInstance);
+        this.sharedSteps = new SharedStepsApi(cfg, basePath, this.axiosInstance);
+        this.authors = new AuthorsApi(cfg, basePath, this.axiosInstance);
+        this.customFields = new CustomFieldsApi(cfg, basePath, this.axiosInstance);
+        this.search = new SearchApi(cfg, basePath, this.axiosInstance);
+        this.configurations = new ConfigurationsApi(cfg, basePath, this.axiosInstance);
+        this.systemFields = new SystemFieldsApi(cfg, basePath, this.axiosInstance);
+        this.users = new UsersApi(cfg, basePath, this.axiosInstance);
+        this.sharedParameters = new SharedParametersApi(cfg, basePath, this.axiosInstance);
     }
     /**
      * Make a direct API call for endpoints not fully covered by the SDK.
      */
     async request(path, options = {}) {
-        const response = await axios({
+        const authHeaders = isJwt(this.token)
+            ? { Authorization: `Bearer ${this.token}` }
+            : { Token: this.token };
+        const { headers: optionHeaders, ...restOptions } = options;
+        const response = await this.axiosInstance.request({
             method: options.method || 'GET',
             url: `${this.host}${path}`,
             headers: {
-                Token: this.token,
+                ...authHeaders,
                 'Content-Type': 'application/json',
-                'User-Agent': USER_AGENT,
-                ...options.headers,
+                ...optionHeaders,
             },
-            ...options,
+            ...restOptions,
         });
         return response.data;
     }
@@ -96,25 +139,6 @@ function getHost() {
     }
     return `https://${domain}`;
 }
-/**
- * Get the effective API token for the current request.
- *
- * Priority:
- *   1. Per-request Bearer token from Authorization header (AsyncLocalStorage)
- *   2. Shared QASE_API_TOKEN environment variable
- */
-function getEffectiveToken() {
-    const requestToken = requestTokenStorage.getStore();
-    if (requestToken) {
-        return requestToken;
-    }
-    const envToken = process.env.QASE_API_TOKEN;
-    if (!envToken) {
-        throw new Error('QASE_API_TOKEN environment variable is required. ' +
-            'Get your token from: https://app.qase.io/user/api/token');
-    }
-    return envToken;
-}
 /**
  * Get full API client config (token + host).
  */
@@ -154,4 +178,5 @@ export function getApiClient() {
 export function resetClientInstance() {
     clientInstance = null;
 }
+export { QaseApiClient };
 //# sourceMappingURL=index.js.map

package/build/client/index.js.map

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

package/build/http/agent.d.ts

@@ -0,0 +1,16 @@
+import * as https from 'https';
+export interface KeepAliveAgentOptions {
+    /** Max concurrent sockets per host. Default: 20. */
+    maxSockets?: number;
+    /** Idle timeout before closing an unused connection. Default: 60s. */
+    keepAliveMsecs?: number;
+}
+/**
+ * Create an https.Agent with connection pooling enabled.
+ *
+ * Removes the TLS handshake (~50–150ms per request) from every call after
+ * the first, which is the single biggest source of per-request latency when
+ * talking to api.qase.io.
+ */
+export declare function createKeepAliveAgent(opts?: KeepAliveAgentOptions): https.Agent;
+//# sourceMappingURL=agent.d.ts.map

package/build/http/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/http/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,qBAA0B,GAAG,KAAK,CAAC,KAAK,CAMlF"}

package/build/http/agent.js

@@ -0,0 +1,16 @@
+import * as https from 'https';
+/**
+ * Create an https.Agent with connection pooling enabled.
+ *
+ * Removes the TLS handshake (~50–150ms per request) from every call after
+ * the first, which is the single biggest source of per-request latency when
+ * talking to api.qase.io.
+ */
+export function createKeepAliveAgent(opts = {}) {
+    return new https.Agent({
+        keepAlive: true,
+        keepAliveMsecs: opts.keepAliveMsecs ?? 60_000,
+        maxSockets: opts.maxSockets ?? 20,
+    });
+}
+//# sourceMappingURL=agent.js.map

package/build/http/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/http/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE;IACnE,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC;QACrB,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,MAAM;QAC7C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;KAClC,CAAC,CAAC;AACL,CAAC"}

package/build/http/dedupe.d.ts

@@ -0,0 +1,14 @@
+import { AxiosInstance } from 'axios';
+/**
+ * Attach an in-flight deduplication adapter.
+ *
+ * When two concurrent GETs have the same URL + sorted query, the second
+ * caller piggy-backs on the first request's promise instead of issuing a new
+ * network call. Applied per-axios-instance — each tenant gets its own
+ * instance in `getApiClient()`, so dedup never crosses tenants.
+ *
+ * Mutating requests (POST/PATCH/PUT/DELETE) are never deduped — they are
+ * not safe to collapse and may have different bodies.
+ */
+export declare function attachInflightDedupe(instance: AxiosInstance): void;
+//# sourceMappingURL=dedupe.d.ts.map

package/build/http/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../../src/http/dedupe.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAqC,MAAM,OAAO,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAwClE"}

package/build/http/dedupe.js

@@ -0,0 +1,69 @@
+import axios from 'axios';
+/**
+ * Attach an in-flight deduplication adapter.
+ *
+ * When two concurrent GETs have the same URL + sorted query, the second
+ * caller piggy-backs on the first request's promise instead of issuing a new
+ * network call. Applied per-axios-instance — each tenant gets its own
+ * instance in `getApiClient()`, so dedup never crosses tenants.
+ *
+ * Mutating requests (POST/PATCH/PUT/DELETE) are never deduped — they are
+ * not safe to collapse and may have different bodies.
+ */
+export function attachInflightDedupe(instance) {
+    const inflight = new Map();
+    // Capture whatever adapter was set on the instance at attach time.
+    // - If MockAdapter is installed first → capturedAdapter is the mock function.
+    // - If nothing was set (fresh axios.create()) → capturedAdapter is undefined;
+    //   we fall back to axios's built-in http adapter via getAdapter.
+    const capturedAdapter = instance.defaults.adapter;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let resolvedAdapter;
+    if (typeof capturedAdapter === 'function') {
+        resolvedAdapter = capturedAdapter;
+    }
+    else {
+        // axios ≥1.7 exposes getAdapter('http') which returns the actual function.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        resolvedAdapter = axios.getAdapter?.('http');
+        if (typeof resolvedAdapter !== 'function') {
+            // Last-resort fallback: skip dedup rather than crash the server.
+            console.error('[dedupe] WARNING: could not resolve HTTP adapter; in-flight deduplication disabled.');
+            return;
+        }
+    }
+    instance.defaults.adapter = (config) => {
+        if (!isDedupable(config)) {
+            return resolvedAdapter(config);
+        }
+        const key = dedupeKey(config);
+        const existing = inflight.get(key);
+        if (existing)
+            return existing;
+        const promise = resolvedAdapter(config).finally(() => {
+            inflight.delete(key);
+        });
+        inflight.set(key, promise);
+        return promise;
+    };
+}
+function isDedupable(config) {
+    const method = (config.method ?? 'get').toLowerCase();
+    return method === 'get' || method === 'head';
+}
+function dedupeKey(config) {
+    const url = config.url ?? '';
+    const base = config.baseURL ?? '';
+    const params = config.params ? stableStringify(config.params) : '';
+    return `${config.method ?? 'get'}|${base}|${url}|${params}`;
+}
+function stableStringify(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return JSON.stringify(obj);
+    if (Array.isArray(obj))
+        return `[${obj.map(stableStringify).join(',')}]`;
+    const record = obj;
+    const keys = Object.keys(record).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(record[k])}`).join(',')}}`;
+}
+//# sourceMappingURL=dedupe.js.map

package/build/http/dedupe.js.map

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

package/build/http/index.d.ts

@@ -0,0 +1,6 @@
+export { createKeepAliveAgent } from './agent.js';
+export type { KeepAliveAgentOptions } from './agent.js';
+export { attachRetry } from './retry.js';
+export type { RetryOptions } from './retry.js';
+export { attachInflightDedupe } from './dedupe.js';
+//# sourceMappingURL=index.d.ts.map

package/build/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/build/http/index.js

@@ -0,0 +1,4 @@
+export { createKeepAliveAgent } from './agent.js';
+export { attachRetry } from './retry.js';
+export { attachInflightDedupe } from './dedupe.js';
+//# sourceMappingURL=index.js.map

package/build/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/build/http/retry.d.ts

@@ -0,0 +1,18 @@
+import { AxiosInstance } from 'axios';
+export interface RetryOptions {
+    /** Maximum retry attempts (does not count the initial attempt). Default: 3. */
+    maxRetries?: number;
+    /** Base delay for exponential backoff in ms. Default: 200. */
+    baseDelayMs?: number;
+    /** Max jitter in ms added to each backoff delay. Default: 100. */
+    maxJitterMs?: number;
+}
+/**
+ * Attach a retry interceptor with jittered exponential backoff.
+ *
+ * Policy (from ADR-0001, Decision → Special Mentions → Infrastructure):
+ * - Idempotent (GET/HEAD/OPTIONS/DELETE): retry 429/502/503/504 + network errors
+ * - Mutating (POST/PATCH/PUT): retry only 429 + pre-send timeouts
+ */
+export declare function attachRetry(instance: AxiosInstance, opts?: RetryOptions): void;
+//# sourceMappingURL=retry.d.ts.map

package/build/http/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/http/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkC,MAAM,OAAO,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CAqBlF"}