@qverisai/mcp 0.5.0 → 0.7.0

package/dist/tools/get-by-ids.d.ts

@@ -32,7 +32,7 @@ export interface GetToolsByIdsInput {
     session_id?: string;
 }
 /**
- * JSON Schema for the get_tools_by_ids tool input.
+ * JSON Schema for the inspect tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export declare const getToolsByIdsSchema: {
@@ -58,7 +58,7 @@ export declare const getToolsByIdsSchema: {
     required: string[];
 };
 /**
- * Executes the get_tools_by_ids operation.
+ * Executes the inspect operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Request parameters with tool IDs

package/dist/tools/get-by-ids.js

@@ -8,7 +8,7 @@
  * @module tools/get-by-ids
  */
 /**
- * JSON Schema for the get_tools_by_ids tool input.
+ * JSON Schema for the inspect tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export const getToolsByIdsSchema = {
@@ -37,7 +37,7 @@ export const getToolsByIdsSchema = {
     required: ['tool_ids'],
 };
 /**
- * Executes the get_tools_by_ids operation.
+ * Executes the inspect operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Request parameters with tool IDs

package/dist/tools/search.d.ts

@@ -35,7 +35,7 @@ export interface SearchToolsInput {
     session_id?: string;
 }
 /**
- * JSON Schema for the search_tools tool input.
+ * JSON Schema for the discover tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export declare const searchToolsSchema: {
@@ -60,7 +60,7 @@ export declare const searchToolsSchema: {
     required: string[];
 };
 /**
- * Executes the search_tools operation.
+ * Executes the discover operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Search parameters

package/dist/tools/search.js

@@ -7,7 +7,7 @@
  * @module tools/search
  */
 /**
- * JSON Schema for the search_tools tool input.
+ * JSON Schema for the discover tool input.
  * Used by MCP to validate and document the tool parameters.
  */
 export const searchToolsSchema = {
@@ -35,7 +35,7 @@ export const searchToolsSchema = {
     required: ['query'],
 };
 /**
- * Executes the search_tools operation.
+ * Executes the discover operation.
  *
  * @param client - Initialized Qveris API client
  * @param input - Search parameters

package/dist/tools/usage-history.d.ts

@@ -0,0 +1,72 @@
+/**
+ * usage_history MCP Tool Implementation
+ *
+ * Context-safe query for request-level usage audit history.
+ */
+import type { QverisClient } from '../api/client.js';
+import { type UsageFilterInput } from './audit-utils.js';
+export interface UsageHistoryInput extends UsageFilterInput {
+}
+export declare const usageHistorySchema: {
+    type: "object";
+    properties: {
+        mode: {
+            type: string;
+            enum: string[];
+            description: string;
+            default: string;
+        };
+        start_date: {
+            type: string;
+            description: string;
+        };
+        end_date: {
+            type: string;
+            description: string;
+        };
+        bucket: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        execution_id: {
+            type: string;
+            description: string;
+        };
+        search_id: {
+            type: string;
+            description: string;
+        };
+        event_type: {
+            type: string;
+            description: string;
+        };
+        kind: {
+            type: string;
+            description: string;
+        };
+        success: {
+            type: string;
+            description: string;
+        };
+        charge_outcome: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        min_credits: {
+            type: string;
+            description: string;
+        };
+        max_credits: {
+            type: string;
+            description: string;
+        };
+        limit: {
+            type: string;
+            description: string;
+        };
+    };
+};
+export declare function executeUsageHistory(client: QverisClient, input: UsageHistoryInput): Promise<Record<string, unknown>>;
+//# sourceMappingURL=usage-history.d.ts.map

package/dist/tools/usage-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-history.d.ts","sourceRoot":"","sources":["../../src/tools/usage-history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAeL,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;CAAG;AAE9D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA0ClC"}

package/dist/tools/usage-history.js

@@ -0,0 +1,135 @@
+/**
+ * usage_history MCP Tool Implementation
+ *
+ * Context-safe query for request-level usage audit history.
+ */
+import { DEFAULT_PAGE_SIZE, MAX_EXPORT_ROWS, MAX_SEARCH_SCAN_ROWS, MAX_SUMMARY_ROWS, clampLimit, getUsageItems, matchesUsage, normalizeMode, pickUsage, resolveDateRange, summarizeUsage, summarizeUsageFromServer, unwrapEnvelope, writeJsonlExport, } from './audit-utils.js';
+export const usageHistorySchema = {
+    type: 'object',
+    properties: {
+        mode: {
+            type: 'string',
+            enum: ['summary', 'search', 'export_file'],
+            description: 'summary returns aggregates, search returns capped rows, export_file writes JSONL locally. Default: summary.',
+            default: 'summary',
+        },
+        start_date: { type: 'string', description: 'Start date in YYYY-MM-DD. Defaults to yesterday UTC.' },
+        end_date: { type: 'string', description: 'End date in YYYY-MM-DD. Defaults to today UTC.' },
+        bucket: { type: 'string', enum: ['hour', 'day', 'week'], description: 'Aggregation bucket for summary mode.' },
+        execution_id: { type: 'string', description: 'Focus on one execution_id.' },
+        search_id: { type: 'string', description: 'Focus on one search_id.' },
+        event_type: { type: 'string', description: 'Filter by event type, for example tool_execute or search.' },
+        kind: { type: 'string', description: 'Backend usage kind grouping when supported.' },
+        success: { type: 'boolean', description: 'Filter by call success.' },
+        charge_outcome: {
+            type: 'string',
+            enum: ['charged', 'included', 'failed_not_charged', 'failed_charged_review'],
+            description: 'Filter by charge outcome.',
+        },
+        min_credits: { type: 'number', description: 'Minimum actual/requested credits to match.' },
+        max_credits: { type: 'number', description: 'Maximum actual/requested credits to match.' },
+        limit: { type: 'number', description: 'Max rows for search mode. Default 10, hard max 50.' },
+    },
+};
+export async function executeUsageHistory(client, input) {
+    const mode = normalizeMode(input.mode);
+    const range = resolveDateRange(input);
+    if (mode === 'search') {
+        const limit = clampLimit(input.limit);
+        const result = await collectUsageRows(client, input, limit, MAX_SEARCH_SCAN_ROWS, true);
+        return {
+            mode,
+            ...range,
+            shown_records: result.rows.length,
+            matched_records: result.total,
+            truncated: result.truncated,
+            items: result.rows.map((row) => pickUsage(row)),
+        };
+    }
+    if (mode === 'export_file') {
+        const result = await collectUsageRows(client, input, MAX_EXPORT_ROWS, MAX_EXPORT_ROWS, false);
+        return writeJsonlExport('usage_history', result.rows, {
+            ...range,
+            matched_records: result.total,
+            truncated: result.truncated,
+            filters: exportFilters(input),
+        });
+    }
+    const summaryLimit = clampLimit(input.limit);
+    const summaryResponse = unwrapEnvelope(await client.getUsageHistory(buildQuery(input, 1, summaryLimit, true)));
+    if (summaryResponse.summary) {
+        return summarizeUsageFromServer(summaryResponse.summary, input, getUsageItems(summaryResponse).length, summaryResponse.total);
+    }
+    const result = await collectUsageRows(client, input, MAX_SUMMARY_ROWS, MAX_SUMMARY_ROWS, false);
+    return summarizeUsage(result.rows, input, result.scannedRows, result.total, result.truncated);
+}
+async function collectUsageRows(client, input, limit, maxRows, stopWhenLimitReached) {
+    const rows = [];
+    let page = 1;
+    let total;
+    let scannedRows = 0;
+    let truncated = false;
+    while (rows.length < limit && scannedRows < maxRows) {
+        const query = buildQuery(input, page, Math.min(DEFAULT_PAGE_SIZE, maxRows - scannedRows));
+        const response = unwrapEnvelope(await client.getUsageHistory(query));
+        const items = getUsageItems(response);
+        if (total === undefined)
+            total = response.total;
+        if (items.length === 0)
+            break;
+        scannedRows += items.length;
+        for (const item of items) {
+            if (!matchesUsage(item, input))
+                continue;
+            rows.push(item);
+            if (stopWhenLimitReached && rows.length >= limit)
+                break;
+        }
+        if (stopWhenLimitReached && rows.length >= limit) {
+            truncated = Boolean(total && total > scannedRows);
+            break;
+        }
+        if (total !== undefined && scannedRows >= total)
+            break;
+        if (items.length < DEFAULT_PAGE_SIZE)
+            break;
+        page += 1;
+    }
+    if (total !== undefined && scannedRows < total)
+        truncated = true;
+    if (scannedRows >= maxRows && (total === undefined || scannedRows < total))
+        truncated = true;
+    return { rows: rows.slice(0, limit), total, scannedRows, truncated };
+}
+function buildQuery(input, page, pageSize, summary = false) {
+    const range = resolveDateRange(input);
+    return {
+        ...range,
+        summary: summary || undefined,
+        bucket: summary ? input.bucket : undefined,
+        event_type: input.event_type,
+        kind: input.kind,
+        success: input.success,
+        charge_outcome: input.charge_outcome,
+        search_id: input.search_id,
+        execution_id: input.execution_id,
+        min_credits: input.min_credits,
+        max_credits: input.max_credits,
+        limit: summary ? pageSize : undefined,
+        page,
+        page_size: pageSize,
+    };
+}
+function exportFilters(input) {
+    return {
+        execution_id: input.execution_id,
+        search_id: input.search_id,
+        event_type: input.event_type,
+        kind: input.kind,
+        success: input.success,
+        charge_outcome: input.charge_outcome,
+        min_credits: input.min_credits,
+        max_credits: input.max_credits,
+    };
+}
+//# sourceMappingURL=usage-history.js.map

package/dist/tools/usage-history.js.map

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

package/dist/types.d.ts

@@ -54,9 +54,48 @@ export interface ToolStats {
     avg_execution_time_ms?: number;
     /** Historical success rate (0.0 - 1.0) */
     success_rate?: number;
-    /** Estimated cost in credits per call */
+    /** Legacy fallback estimate in credits per call */
     cost?: number;
 }
+export interface BillingPrice {
+    amount_credits: number;
+    per?: number | null;
+    unit?: string | null;
+    unit_label?: string | null;
+}
+export interface BillingChargeLine {
+    component_key: string;
+    quantity?: number | null;
+    unit?: string | null;
+    unit_label?: string | null;
+    price?: BillingPrice | null;
+    amount_credits?: number | null;
+    description?: string | null;
+    is_adjustment?: boolean | null;
+}
+export interface BillingRule {
+    metering_mode?: string;
+    billing_unit?: string;
+    billing_unit_label?: string;
+    price?: BillingPrice | null;
+    price_breakdown?: Record<string, unknown>[] | null;
+    pricing_dimensions?: Record<string, unknown>[] | null;
+    minimum_charge_credits?: number | null;
+    snapshot_id?: number | null;
+    snapshot_version?: string | null;
+    runtime_pricing_version?: string | null;
+    pricing_source_system?: string | null;
+    description?: string;
+}
+export interface CompactBillingStatement {
+    price?: BillingPrice | null;
+    quantity?: number | null;
+    charge_lines?: BillingChargeLine[] | null;
+    minimum_charge_credits?: number | null;
+    list_amount_credits?: number | null;
+    requested_amount_credits?: number | null;
+    summary?: string | null;
+}
 /**
  * Information about a tool returned from search results.
  * Contains everything needed to understand and execute the tool.
@@ -89,6 +128,8 @@ export interface ToolInfo {
     examples?: ToolExamples;
     /** Historical execution performance statistics */
     stats?: ToolStats;
+    /** Structured rule-level billing metadata when available */
+    billing_rule?: BillingRule;
     /** Relevance score for the search query (0.0 - 1.0, higher = better match) */
     final_score?: number;
     /** Whether this tool has been executed before (verified in production) */
@@ -229,13 +270,117 @@ export interface ExecuteResponse {
     execution_time?: number;
     /** Execution duration in milliseconds (alternative field) */
     elapsed_time_ms?: number;
-    /** Credits consumed by this execution */
+    /** Legacy fallback estimate; use usage audit or credits ledger for final charge */
     cost?: number;
+    /** Structured pre-settlement billing statement when available */
+    billing?: CompactBillingStatement;
+    /** Legacy/full pre-settlement bill snapshot when returned directly */
+    pre_settlement_bill?: Record<string, unknown>;
     /** User's remaining credits after this execution */
     remaining_credits?: number;
     /** Timestamp of execution (ISO 8601 format) */
     created_at?: string;
 }
+export interface ApiEnvelope<T> {
+    status: string;
+    message?: string;
+    status_code?: number;
+    data: T;
+}
+export interface CreditsResponse {
+    remaining_credits: number;
+    daily_free?: Record<string, unknown>;
+    invite_reward?: Record<string, unknown>;
+    welcome_bonus?: Record<string, unknown>;
+    purchased?: Record<string, unknown>;
+}
+export interface UsageHistoryRequest {
+    start_date?: string;
+    end_date?: string;
+    summary?: boolean;
+    bucket?: string;
+    event_type?: string;
+    kind?: string;
+    success?: boolean;
+    charge_outcome?: string;
+    search_id?: string;
+    execution_id?: string;
+    min_credits?: number;
+    max_credits?: number;
+    limit?: number;
+    page?: number;
+    page_size?: number;
+}
+export interface UsageEventItem {
+    id: string;
+    event_type: string;
+    kind?: string | null;
+    source_system: string;
+    source_ref_type?: string | null;
+    source_ref_id?: string | null;
+    session_id?: string | null;
+    search_id?: string | null;
+    execution_id?: string | null;
+    tool_id?: string | null;
+    model?: string | null;
+    query?: string | null;
+    success: boolean;
+    charge_outcome?: string | null;
+    error_message?: string | null;
+    billing_snapshot_status?: string | null;
+    pre_settlement_bill?: Record<string, unknown> | null;
+    settlement_result?: Record<string, unknown> | null;
+    requested_amount_credits?: number | null;
+    actual_amount_credits?: number | null;
+    credits_ledger_entry_id?: string | null;
+    display_target?: string | null;
+    billing_summary?: string | null;
+    pre_settlement_amount_credits?: number | null;
+    settled_amount_credits?: number | null;
+    created_at: string;
+}
+export interface UsageEventsResponse {
+    items: UsageEventItem[];
+    total: number;
+    page: number;
+    page_size: number;
+    summary?: Record<string, unknown> | null;
+}
+export interface CreditsLedgerRequest {
+    start_date?: string;
+    end_date?: string;
+    summary?: boolean;
+    bucket?: string;
+    entry_type?: string;
+    direction?: string;
+    min_credits?: number;
+    max_credits?: number;
+    limit?: number;
+    page?: number;
+    page_size?: number;
+}
+export interface CreditsLedgerItem {
+    id: string;
+    entry_type: string;
+    amount_credits: number;
+    source_system: string;
+    source_ref_type?: string | null;
+    source_ref_id?: string | null;
+    pre_settlement_bill?: Record<string, unknown> | null;
+    settlement_result?: Record<string, unknown> | null;
+    balance_before?: Record<string, unknown> | null;
+    balance_after?: Record<string, unknown> | null;
+    ledger_metadata?: Record<string, unknown> | null;
+    description?: string | null;
+    created_at: string;
+}
+export interface CreditsLedgerResponse {
+    items: CreditsLedgerItem[];
+    total: number;
+    page: number;
+    page_size: number;
+    summary?: Record<string, unknown> | null;
+}
 /**
  * Configuration options for the Qveris API client.
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE3D,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAElB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAEhB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,2BAA2B;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB,kDAAkD;IAClD,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,0BAA0B;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,4BAA4B;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,OAAO,EAAE,QAAQ,EAAE,CAAC;IAEpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAEhB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qverisai/mcp",
-  "version": "0.5.0",
-  "description": "Official QVeris AI MCP Server SDK - Search and execute tools via natural language",
+  "version": "0.7.0",
+  "description": "QVeris MCP server for agent tool discovery, inspection, and calling",
   "keywords": [
     "qveris",
     "mcp",
@@ -14,12 +14,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/QVerisAI/QVerisAI",
+    "url": "https://github.com/QVerisAI/qveris-agent-toolkit",
     "directory": "packages/mcp"
   },
   "homepage": "https://qveris.ai",
   "bugs": {
-    "url": "https://github.com/QVerisAI/QVerisAI/issues"
+    "url": "https://github.com/QVerisAI/qveris-agent-toolkit/issues"
   },
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,8 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "gen:openapi": "openapi-typescript ../../docs/openapi/qveris-public-api.openapi.json -o src/generated/openapi.d.ts && npx prettier --write src/generated/openapi.d.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -47,6 +48,7 @@
   "devDependencies": {
     "@types/node": "^22.10.1",
     "@types/uuid": "^10.0.0",
+    "openapi-typescript": "7.4.4",
     "typescript": "^5.7.2",
     "vitest": "^2.1.0"
   },