@qverisai/mcp 0.14.6 → 0.15.1

package/CHANGELOG.md

@@ -6,12 +6,32 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 ## [Unreleased]
 
+## [0.15.1] - 2026-11-12
+
 ### Fixed
 
+- Explain public-to-authenticated continuation and distinguish Probe runtime restrictions from catalog evidence.
+
+- Count Unicode model identifier characters consistently with the advertised schema.
+
+- Validate optional Call model identifiers before dispatch: use at most 128 characters without whitespace or control characters, or omit the field when the identifier is unknown.
+
+## [0.15.0] - 2026-10-23
+
+### Fixed
+
+- Finish accepted HTTP tool operations before shutting down sessions, including operations whose clients disconnected; stop accepting new requests as shutdown begins.
+
+- Report successful Calls with pending settlement review as manual review required, preserving execution results without replaying the Call.
+
 - Expose the additive catalog `updated_at` field, matching the SDK contract surfaces.
 
 ### Added
 
+- Expose typed zero-quote settlement review details and preserve an explicitly supplied false zero-quote guard in the Call request.
+
+- Add host-controlled Call idempotency keys, read-only `lookup_execution`, and host-side `reconcileToolExecution(key)`. Add `require_zero_quote` for guarded execution after an exact zero-credit Probe; submitted Calls remain single-submit. ([#436])
+
 - Expose typed Probe one-of alternatives (`required_any_of`) and unsatisfied parameter groups (`missing_field_groups`), while retaining compatibility with older responses.
 
 - MCP success/error payloads now include machine-readable `next_action` guidance for authentication, required parameters, billing, retries, and unknown Call settlement.
@@ -201,7 +221,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 - Handle empty/non-JSON success responses gracefully; `params_to_tool` documented as an object.
 
-[Unreleased]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.14.4...HEAD
+[Unreleased]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.15.1...HEAD
+[0.15.0]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.14.6...mcp-v0.15.0
 [0.14.4]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.14.3...mcp-v0.14.4
 [0.14.3]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.14.2...mcp-v0.14.3
 [0.14.2]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.14.1...mcp-v0.14.2
@@ -255,3 +276,4 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 [#341]: https://github.com/QVerisAI/qveris-agent-toolkit/issues/341
 [#347]: https://github.com/QVerisAI/qveris-agent-toolkit/pull/347
 [#362]: https://github.com/QVerisAI/qveris-agent-toolkit/pull/362
+[0.15.1]: https://github.com/QVerisAI/qveris-agent-toolkit/compare/mcp-v0.15.0...mcp-v0.15.1

package/README.md

@@ -160,9 +160,10 @@ Call a discovered tool with specific parameters.
 | `search_id` | string | ✓ | Search ID from the discover call that found this tool |
 | `params_to_tool` | object | ✓ | A dictionary of parameters to pass to the tool |
 | `session_id` | string | | Session identifier (auto-generated if omitted) |
-| `model` | string | | Model that selected and parameterized the call (maximum 128 characters) |
+| `model` | string | | Optional model identifier (1–128 characters, no whitespace or control characters); omit when unknown |
 | `max_response_size` | number | | Automatic inline limit in UTF-8 bytes (default: 20480; `-1` is unlimited); explicit `full` takes precedence over a finite value |
 | `respond_with` | string | | Omit for compatibility auto-delivery; use `full` to force complete inline data, `summary`, or `fields:<JSONPath,...>` |
+| `require_zero_quote` | boolean | | Probe schema and exact quote, then require server-side zero-credit admission |
 
 **Example:**
 
@@ -172,10 +173,17 @@ Call a discovered tool with specific parameters.
   "search_id": "abcd1234-ab12-ab12-ab12-abcdef123456",
   "params_to_tool": {"city": "London", "units": "metric"},
   "model": "router-model-v1",
-  "respond_with": "summary"
+  "respond_with": "summary",
+  "require_zero_quote": true
 }
 ```
 
+When `require_zero_quote` is true, the server probes first and blocks the Call unless the capability is executable, advertises `require_zero_quote_v1`, the current schema is valid, and the exact quote is zero. The execute body carries this flag at the top level, outside `params_to_tool`. Idempotency keys are host/client-controlled transport metadata, not model-facing `call` arguments. Each Call gets a client-issued key; uncertain outcomes return that key for the read-only `lookup_execution` tool. Lookup accepts only keys issued by that client instance or explicitly bound by trusted host code. The client keeps a bounded in-memory set of 1,024 recent keys. After restart, host persistence must restore the original key with `QverisClient.bindExecutionKey(key)` and must retain the same authorization context. HTTP 409 conflicts skip automatic lookup, and the client never automatically resubmits Execute.
+
+### `lookup_execution`
+
+Read-only query for the outcome associated with a prior Call. It takes `idempotency_key` and never submits Execute.
+
 The `call` response may include compact pre-settlement `billing`. Final charge status should be checked with `usage_history` or `credits_ledger`.
 
 Projection inputs are opt-in. Explicit `respond_with: "full"` returns complete inline `result.data` without an overflow replacement; at the platform hard limit the call fails with `response_too_large`. Omitting `respond_with` retains the 20KB automatic overflow behavior. Paid `call` / `execute_tool` requests are always single-submit: the MCP server does not retry `429`/`503`, follow HTTP redirects, or remove a rejected projection field and resubmit. Projection errors remain errors.
@@ -328,7 +336,7 @@ npx -y @qverisai/mcp
 
 - The endpoint is `POST/GET/DELETE {path}` (default `/mcp`); `GET /health` returns an unauthenticated liveness probe.
 - **Inbound auth:** set `QVERIS_MCP_HTTP_AUTH_TOKEN` to require `Authorization: Bearer <token>` on the MCP endpoint. The server **refuses to start** when binding a non-loopback host without a token, unless you set `QVERIS_MCP_HTTP_ALLOW_UNAUTHENTICATED=true` to delegate auth to an external proxy/gateway. Your `QVERIS_API_KEY` is the server's *outbound* credential to QVeris — it is **not** an inbound check, so anyone reaching an unauthenticated endpoint would spend your credits.
-- **Embedding API:** the package root exports `startHttpServer`, `resolveTransportConfig`, `QverisClient`, and the session-auth types. An independently operated service can set `requireSessionBearer` on its resolved transport config and provide an asynchronous session factory. The transport requires a bearer, passes it only to that factory, stores only a credential fingerprint for session binding, and rejects credential changes. A hosted embedding can call `createQverisServer(client, sessionId, { includeDeprecatedAliases: false })` to advertise only the six canonical tools; deprecated aliases remain callable for cached legacy clients. The embedding service owns validation, client construction, rate limits, deployment, and operations.
+- **Embedding API:** the package root exports `startHttpServer`, `resolveTransportConfig`, `QverisClient`, and the session-auth types. An independently operated service can set `requireSessionBearer` on its resolved transport config and provide an asynchronous session factory. The transport requires a bearer, passes it only to that factory, stores only a credential fingerprint for session binding, and rejects credential changes. A hosted embedding can call `createQverisServer(client, sessionId, { includeDeprecatedAliases: false })` to advertise only the seven canonical tools; deprecated aliases remain callable for cached legacy clients. The embedding service owns validation, client construction, rate limits, deployment, and operations.
 - DNS-rebinding protection is **on by default** (localhost + the bound host/port are allow-listed). When exposing the server publicly, add your public host via `QVERIS_MCP_ALLOWED_HOSTS`.
 - Requests are capped at 4 MiB by default (`QVERIS_MCP_MAX_BODY_BYTES`), and idle sessions are evicted after 5 minutes (`QVERIS_MCP_SESSION_TIMEOUT_MS`).
 - **Discovery:** registries and crawlers can learn about the server without connecting:

package/dist/api/client.d.ts

@@ -6,7 +6,7 @@
  *
  * @module api/client
  */
-import type { SearchRequest, SearchResponse, GetToolsByIdsRequest, ExecuteRequest, ExecuteResponse, ProbeRequest, ProbeResponse, CreditsResponse, UsageHistoryRequest, UsageEventsResponse, CreditsLedgerRequest, CreditsLedgerResponse, ApiEnvelope, QverisClientConfig } from '../types.js';
+import type { SearchRequest, SearchResponse, GetToolsByIdsRequest, ExecuteRequest, ExecuteResponse, ToolExecutionReconciliationData, ProbeRequest, ProbeResponse, CreditsResponse, UsageHistoryRequest, UsageEventsResponse, CreditsLedgerRequest, CreditsLedgerResponse, ApiEnvelope, QverisClientConfig, ExecuteTransportOptions } from '../types.js';
 /**
  * Qveris API Client
  *
@@ -34,12 +34,18 @@ export declare class QverisClient {
     private readonly defaultTimeoutMs;
     private readonly maxRetries;
     private rateLimitRetries;
+    private readonly issuedExecutionKeys;
     constructor(config: QverisClientConfig);
     /**
      * How many times the client has backed off on a rate-limited (429) /
      * transient (503) response so far — retried pressure, not failure.
      */
     get rateLimitRetryCount(): number;
+    /** Bind a previously issued Call key restored by host-controlled persistence. */
+    bindExecutionKey(idempotencyKey: string): void;
+    /** Whether this client issued or the host explicitly bound a Call key. */
+    hasIssuedExecutionKey(idempotencyKey: string): boolean;
+    private rememberExecutionKey;
     /** Sleep for `ms` (a seam so tests can stub out the wait). */
     private sleep;
     /**
@@ -66,7 +72,11 @@ export declare class QverisClient {
      * This is the Call action; the response may include pre-settlement billing.
      * Uses a longer timeout (120s) by default.
      */
-    executeTool(toolId: string, request: ExecuteRequest): Promise<ExecuteResponse>;
+    executeTool(toolId: string, request: ExecuteRequest, options?: ExecuteTransportOptions): Promise<ExecuteResponse>;
+    /** Read-only recovery for an execute request whose response may have been lost. */
+    getExecutionByIdempotencyKey(idempotencyKey: string): Promise<unknown>;
+    /** Read-only host API; deliberately not exposed as an MCP model argument. */
+    reconcileToolExecution(idempotencyKey: string): Promise<ToolExecutionReconciliationData>;
     /**
      * Get current credit balance and bucket details.
      */

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAInB,MAAM,aAAa,CAAC;AAuDrB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,EAAE,kBAAkB;IAYtC;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,8DAA8D;YAChD,KAAK;IAKnB;;OAEG;YACW,OAAO;IA6IrB;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYlE;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3E;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUnF;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAqCpF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IAI3E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;IAWpH;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;CAUvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAalD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,+BAA+B,EAE/B,YAAY,EACZ,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAIlB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAyDrB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;gBAE7C,MAAM,EAAE,kBAAkB;IAYtC;;;OAGG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,iFAAiF;IACjF,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAI9C,0EAA0E;IAC1E,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAItD,OAAO,CAAC,oBAAoB;IAY5B,8DAA8D;YAChD,KAAK;IAKnB;;OAEG;YACW,OAAO;IAwJrB;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAYlE;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3E;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUnF;;;;OAIG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC;IA0E3B,mFAAmF;IAC7E,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB5E,6EAA6E;IACvE,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAqB9F;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IAI3E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;IAWpH;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;CAUvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAalD"}

package/dist/api/client.js

@@ -6,9 +6,11 @@
  *
  * @module api/client
  */
+import { randomUUID } from 'node:crypto';
 import { computeRetryDelayMs, DEFAULT_BASE_DELAY_MS, DEFAULT_MAX_DELAY_MS, parseRetryAfterMs, resolveMaxRetries, RETRYABLE_STATUS, } from '../retry.js';
 import { normalizeCreditBalanceResponse } from './credit-balance.js';
 const DEFAULT_BASE_URL = 'https://qveris.ai/api/v1';
+const MAX_ISSUED_EXECUTION_KEYS = 1024;
 /**
  * Resolve the base URL for the QVeris API.
  * Priority: explicit baseUrl > QVERIS_BASE_URL env > built-in default.
@@ -75,6 +77,7 @@ export class QverisClient {
     defaultTimeoutMs;
     maxRetries;
     rateLimitRetries = 0;
+    issuedExecutionKeys = new Set();
     constructor(config) {
         if (!config.apiKey) {
             throw new Error('Qveris API key is required');
@@ -93,6 +96,26 @@ export class QverisClient {
     get rateLimitRetryCount() {
         return this.rateLimitRetries;
     }
+    /** Bind a previously issued Call key restored by host-controlled persistence. */
+    bindExecutionKey(idempotencyKey) {
+        this.rememberExecutionKey(idempotencyKey);
+    }
+    /** Whether this client issued or the host explicitly bound a Call key. */
+    hasIssuedExecutionKey(idempotencyKey) {
+        return this.issuedExecutionKeys.has(idempotencyKey);
+    }
+    rememberExecutionKey(idempotencyKey) {
+        if (typeof idempotencyKey !== 'string' || idempotencyKey.trim().length === 0) {
+            throw new Error('idempotency key must be a non-empty string.');
+        }
+        this.issuedExecutionKeys.delete(idempotencyKey);
+        this.issuedExecutionKeys.add(idempotencyKey);
+        if (this.issuedExecutionKeys.size > MAX_ISSUED_EXECUTION_KEYS) {
+            const oldest = this.issuedExecutionKeys.values().next().value;
+            if (oldest !== undefined)
+                this.issuedExecutionKeys.delete(oldest);
+        }
+    }
     /** Sleep for `ms` (a seam so tests can stub out the wait). */
     async sleep(ms) {
         if (ms <= 0)
@@ -102,7 +125,7 @@ export class QverisClient {
     /**
      * Makes an authenticated HTTP request to the Qveris API.
      */
-    async request(operation, method, endpoint, body, timeoutMs, query) {
+    async request(operation, method, endpoint, body, timeoutMs, query, headers = {}, sensitiveQueryKeys = []) {
         const url = new URL(`${this.baseUrl}${endpoint}`);
         if (query) {
             for (const [key, value] of Object.entries(query)) {
@@ -112,13 +135,20 @@ export class QverisClient {
             }
         }
         const resolvedTimeoutMs = timeoutMs ?? this.defaultTimeoutMs;
-        const queryParams = Object.fromEntries(url.searchParams.entries());
+        const queryParams = Object.fromEntries([...url.searchParams.entries()].map(([key, value]) => [
+            key,
+            sensitiveQueryKeys.includes(key) ? '[REDACTED]' : value,
+        ]));
+        const observableUrl = new URL(url);
+        for (const key of sensitiveQueryKeys)
+            if (observableUrl.searchParams.has(key))
+                observableUrl.searchParams.set(key, '[REDACTED]');
         const requestContext = {
             source: 'qveris_api',
             operation,
             method,
             endpoint,
-            url: url.toString(),
+            url: observableUrl.toString(),
             ...(Object.keys(queryParams).length > 0 && { query_params: queryParams }),
             timeout_ms: resolvedTimeoutMs,
         };
@@ -137,6 +167,7 @@ export class QverisClient {
                     headers: {
                         Authorization: `Bearer ${this.apiKey}`,
                         'Content-Type': 'application/json',
+                        ...headers,
                     },
                     body: body ? JSON.stringify(body) : undefined,
                     signal: controller.signal,
@@ -271,41 +302,94 @@ export class QverisClient {
      * This is the Call action; the response may include pre-settlement billing.
      * Uses a longer timeout (120s) by default.
      */
-    async executeTool(toolId, request) {
+    async executeTool(toolId, request, options = {}) {
         const endpoint = `/tools/execute?tool_id=${encodeURIComponent(toolId)}`;
-        const result = await this.request('call', 'POST', endpoint, request, EXECUTE_TIMEOUT_MS);
-        const executionId = executionIdFrom(result) ?? null;
-        if (typeof result?.success === 'boolean' && executionId) {
-            if (result.success === false) {
-                return {
-                    ...result,
-                    next_action: {
-                        action: 'reconcile_settlement',
-                        automatic: false,
-                        requires_user: false,
-                        missing_fields: [],
-                        reason: 'call_failed_after_submission',
-                    },
-                };
+        const idempotencyKey = options.idempotencyKey ?? randomUUID();
+        this.rememberExecutionKey(idempotencyKey);
+        try {
+            const result = await this.request('call', 'POST', endpoint, request, EXECUTE_TIMEOUT_MS, undefined, { 'Idempotency-Key': idempotencyKey });
+            const executionId = executionIdFrom(result) ?? null;
+            if (typeof result?.success === 'boolean' && executionId) {
+                if (result.success === false) {
+                    return {
+                        ...result,
+                        next_action: {
+                            action: 'reconcile_settlement',
+                            automatic: false,
+                            requires_user: false,
+                            missing_fields: [],
+                            reason: 'call_failed_after_submission',
+                        },
+                    };
+                }
+                return result;
             }
-            return result;
+            const malformed = {
+                status: 200,
+                message: 'Call response did not match the expected contract',
+                ...(executionId && { details: { execution_id: executionId } }),
+                observability: {
+                    source: 'qveris_api',
+                    operation: 'call',
+                    method: 'POST',
+                    endpoint,
+                    url: `${this.baseUrl}${endpoint}`,
+                    timeout_ms: EXECUTE_TIMEOUT_MS,
+                    http_status: 200,
+                    error_type: 'invalid_response',
+                },
+            };
+            throw malformed;
         }
-        const error = {
-            status: 200,
-            message: 'Call response did not match the expected contract',
-            ...(executionId && { details: { execution_id: executionId } }),
-            observability: {
-                source: 'qveris_api',
-                operation: 'call',
-                method: 'POST',
-                endpoint,
-                url: `${this.baseUrl}${endpoint}`,
-                timeout_ms: EXECUTE_TIMEOUT_MS,
-                http_status: 200,
-                error_type: 'invalid_response',
-            },
-        };
-        throw error;
+        catch (error) {
+            const uncertain = isUncertainCallError(error);
+            const status = error && typeof error === 'object' && 'status' in error ? error.status : undefined;
+            if (error && typeof error === 'object' && (uncertain || status === 200 || status === 409)) {
+                error.idempotency_key = idempotencyKey;
+            }
+            if (!uncertain)
+                throw error;
+            let recoveryData;
+            try {
+                const recovered = await this.getExecutionByIdempotencyKey(idempotencyKey);
+                const data = unwrapApiEnvelopeData(recovered);
+                if (data?.status === 'completed' && data.response && typeof data.response === 'object') {
+                    const response = normalizeCreditBalanceResponse(data.response);
+                    if (typeof response.success === 'boolean' && executionIdFrom(response))
+                        return response;
+                }
+                recoveryData = data;
+            }
+            catch {
+                // Recovery is read-only. Never submit a second execute request with a new key.
+            }
+            if (error && typeof error === 'object') {
+                const recoverable = error;
+                if (recoveryData)
+                    recoverable.recovery = recoveryData;
+            }
+            throw error;
+        }
+    }
+    /** Read-only recovery for an execute request whose response may have been lost. */
+    async getExecutionByIdempotencyKey(idempotencyKey) {
+        if (!this.hasIssuedExecutionKey(idempotencyKey)) {
+            throw new Error('Execution lookup key was not issued or bound by this QverisClient instance.');
+        }
+        return this.request('call', 'GET', '/tools/executions/by-idempotency-key', undefined, this.defaultTimeoutMs, { key: idempotencyKey }, {}, ['key']);
+    }
+    /** Read-only host API; deliberately not exposed as an MCP model argument. */
+    async reconcileToolExecution(idempotencyKey) {
+        if (!idempotencyKey.trim())
+            throw new Error('idempotencyKey must not be empty');
+        const response = await this.request('call_reconciliation', 'GET', '/tools/executions/by-idempotency-key', undefined, undefined, { key: idempotencyKey }, {}, ['key']);
+        if ('status' in response && 'data' in response) {
+            if (response.status !== 'success' || response.data == null) {
+                throw new Error(response.message || 'Call reconciliation failed');
+            }
+            return response.data;
+        }
+        return response;
     }
     /**
      * Get current credit balance and bucket details.
@@ -401,4 +485,16 @@ function getErrorCause(error) {
         return cause;
     return undefined;
 }
+function isUncertainCallError(error) {
+    if (!error || typeof error !== 'object' || !('status' in error))
+        return false;
+    const status = error.status;
+    return status === 0 || status === 200 || status === 408 || (typeof status === 'number' && status >= 500);
+}
+function unwrapApiEnvelopeData(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    return typeof record.status === 'string' && 'data' in record ? record.data : value;
+}
 //# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/execution-guidance.d.ts

@@ -0,0 +1,81 @@
+import type { ExecutionRestrictions, ProbeResponse, ToolInfo } from './types.js';
+export declare function isPublicContext(searchId: unknown): boolean;
+export declare function publicGuidance(): {
+    allowed_actions: string[];
+    action: string;
+    reason: string;
+    message: string;
+    automatic: boolean;
+};
+export declare function withCatalogGuidance<T extends {
+    search_id?: string;
+    contract_features?: string[];
+    results?: ToolInfo[];
+}>(result: T): T & {
+    execution_guidance?: {
+        allowed_actions: string[];
+        action: string;
+        reason: string;
+        message: string;
+        automatic: boolean;
+    } | undefined;
+    results?: (ToolInfo | {
+        execution_guidance: {
+            action: string;
+            reason: string;
+            message: string;
+            automatic: boolean;
+        };
+        tool_id: string;
+        service_id?: string;
+        updated_at?: string;
+        name?: string;
+        description?: string;
+        capability?: string;
+        cost_class?: string;
+        reliability?: string;
+        as_of_support?: boolean;
+        categories?: Array<string | import("./types.js").ToolCategory>;
+        capabilities?: import("./types.js").ToolCapability[];
+        catalog_capabilities?: import("./types.js").CatalogCapability[];
+        catalog_capabilities_warning?: "unavailable";
+        provider_id?: string;
+        provider_name?: string | Record<string, string>;
+        provider_description?: string;
+        provider_website_url?: string;
+        region?: string;
+        params?: import("./types.js").ToolParameterContract;
+        tool_name?: string;
+        category?: string;
+        score?: number;
+        cost?: number | string;
+        calls_count?: string;
+        parameters?: import("./types.js").JsonValue;
+        input_schema?: import("./types.js").JsonValue;
+        parameters_schema?: import("./types.js").JsonValue;
+        query_params?: import("./types.js").JsonValue;
+        body_params?: import("./types.js").JsonValue;
+        requestBody?: import("./types.js").JsonValue;
+        output_schema?: import("./types.js").JsonValue;
+        verification_status: import("./types.js").VerificationStatus;
+        verification: import("./types.js").CatalogVerification;
+        execution_restrictions: ExecutionRestrictions;
+        examples?: import("./types.js").ToolExamples;
+        stats?: import("./types.js").ToolStats;
+        billing_rule?: import("./types.js").BillingRule;
+        expected_cost?: string | number;
+        final_score?: number;
+        why_recommended?: string;
+        has_last_execution?: boolean;
+        last_execution_record?: Record<string, unknown>;
+        docs_url?: string;
+        protocol?: string;
+    })[] | undefined;
+};
+export declare function probeGuidance(probe: ProbeResponse, requireQuote: boolean): {
+    action: string;
+    reason: string;
+    message: string;
+    automatic: boolean;
+};
+//# sourceMappingURL=execution-guidance.d.ts.map

package/dist/execution-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-guidance.d.ts","sourceRoot":"","sources":["../src/execution-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMjF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED,wBAAgB,cAAc;;;;;;EAS7B;AAqCD,wBAAgB,mBAAmB,CACjC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,EACpF,MAAM,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQV;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO;;;;;EA8ExE"}

package/dist/execution-guidance.js

@@ -0,0 +1,81 @@
+function guidance(action, reason, message) {
+    return { action, reason, message, automatic: false };
+}
+export function isPublicContext(searchId) {
+    return typeof searchId === 'string' && searchId.startsWith('pub_');
+}
+export function publicGuidance() {
+    return {
+        ...guidance('connect_qveris_execution', 'public_readonly', 'This QVeris context supports only Discover and Inspect. Connect to the authenticated QVeris execution endpoint for the same deployment. Keep the tool ID and inputs, then Inspect without the public search_id; use the fresh authenticated context before Call.'),
+        allowed_actions: ['discover', 'inspect'],
+    };
+}
+function prohibited(r, ignoreTechnical = false) {
+    return (r?.eligibility === 'restricted' ||
+        r?.license === 'restricted' ||
+        r?.commercial_use === 'prohibited' ||
+        r?.region_status === 'blocked' ||
+        r?.authentication === 'blocked' ||
+        (!ignoreTechnical && r?.technical === 'blocked'));
+}
+function catalogGuidance(tool, publicContext) {
+    const r = tool.execution_restrictions;
+    if (prohibited(r) || r?.next_action === 'switch_provider') {
+        return guidance('select_allowed_provider', 'catalog_execution_prohibited', 'Current policy directs away from this selection. Choose another capability.');
+    }
+    if (!publicContext &&
+        (r?.callable === false ||
+            r?.blocked_actions?.includes('execute') ||
+            (r?.next_action && r.next_action !== 'execute'))) {
+        return guidance('inspect_then_probe_once', 'catalog_execution_not_confirmed', 'Directory evidence does not confirm execution. Check the current contract and any explicit restriction; use one authenticated Probe if admission, inputs or a quote need confirmation. Stop if still unresolved.');
+    }
+    return undefined;
+}
+export function withCatalogGuidance(result) {
+    const publicContext = isPublicContext(result.search_id) || result.contract_features?.includes('public-readonly-v1') === true;
+    const results = result.results?.map((tool) => {
+        const advice = catalogGuidance(tool, publicContext);
+        return advice ? { ...tool, execution_guidance: advice } : tool;
+    });
+    return { ...result, ...(results && { results }), ...(publicContext && { execution_guidance: publicGuidance() }) };
+}
+export function probeGuidance(probe, requireQuote) {
+    const r = probe.execution_restrictions;
+    const reason = probe.reason;
+    if (probe.exists === false ||
+        ['tool_unavailable', 'tool_disabled', 'region_restricted'].includes(reason ?? '') ||
+        prohibited(r, reason === 'realtime_unavailable')) {
+        return guidance('select_allowed_provider', ['tool_unavailable', 'tool_disabled', 'region_restricted'].includes(reason ?? '')
+            ? (reason ?? 'execution_prohibited')
+            : 'execution_prohibited', 'Current execution is unavailable or prohibited for this selection. Do not Call it.');
+    }
+    if (reason === 'insufficient_scope')
+        return guidance('request_qveris_execute_scope', reason, 'Use a QVeris credential with execution scope; provider sign-in will not fix this.');
+    if (reason === 'oauth2_signin_required')
+        return guidance('sign_in_to_provider', reason, 'This tool requires provider sign-in. If the host does not expose the provider connection flow, continue in a supporting QVeris client or select another capability.');
+    if (reason === 'delegation_budget_not_supported')
+        return guidance('change_delegation_or_select_provider', reason, 'Use an authorized credential with a supported budget policy or choose another capability; signing in again does not fix this budget.');
+    if (reason === 'realtime_unavailable')
+        return guidance('retry_probe_once_or_select_provider', reason, 'The tool is temporarily unavailable. Retry the read-only Probe at most once or choose another capability.');
+    if (probe.schema?.valid === false)
+        return guidance('correct_parameters', 'invalid_parameters', 'Correct the current inputs before a new Probe.');
+    const actions = [r?.next_action, probe.recovery?.next_action].filter((value) => value !== undefined);
+    if (actions.includes('switch_provider'))
+        return guidance('select_allowed_provider', 'execution_not_admitted', 'Current guidance recommends another provider. Do not Call this selection.');
+    const quote = probe.quote;
+    const usableQuote = quote?.currency === 'credits' &&
+        typeof quote.estimate_credits === 'number' &&
+        Number.isFinite(quote.estimate_credits) &&
+        quote.estimate_credits >= 0 &&
+        typeof quote.exact === 'boolean';
+    if ((requireQuote && !usableQuote) || actions.includes('confirm_budget'))
+        return guidance('confirm_budget', 'quote_or_budget_confirmation_required', 'Review a usable current quote and the applicable budget before Call.');
+    const conflicting = r?.callable === false ||
+        r?.blocked_actions?.includes('execute') ||
+        (Array.isArray(r?.allowed_actions) && !r.allowed_actions.includes('execute')) ||
+        actions.some((action) => action !== 'execute');
+    if (probe.executable === true && !conflicting && !reason)
+        return guidance('review_and_call', 'execution_preflight_ready', 'Call once only after the current input and cost requirements are met.');
+    return guidance('stop_and_review_preflight', 'execution_guidance_unresolved', 'Current preflight did not confirm execution. Review the latest evidence or select another capability; do not loop through Inspect, Probe or login.');
+}
+//# sourceMappingURL=execution-guidance.js.map

package/dist/execution-guidance.js.map

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

package/dist/http.d.ts

@@ -79,7 +79,8 @@ export interface RunningHttpServer {
     httpServer: HttpServer;
     /** The port actually bound (useful when config.port is 0). */
     port: number;
-    /** Close all sessions and stop the HTTP server. */
+    /** Stop admission, finish accepted requests/operations, then close sessions.
+     * The embedder owns the shutdown deadline; this never force-cancels a Call. */
     close: () => Promise<void>;
 }
 /**