@gullabs/xai 0.6.0 → 0.7.0

package/dist/index.d.cts

@@ -815,7 +815,7 @@ declare const xaiPricingVersion: "xai-2026-08-24";
 /**
  * Live-pinned 2026-08-24 per-invocation tool rates (µUSD per call).
  * Source: `usage.server_side_tool_usage_details` on /v1/responses.
- * $5 / 1,000 web or X searches; $10 / 1,000 attachment/document searches.
+ * $5 / 1,000 web or X searches. Attachment search is not priced until live-pinned.
  */
 declare const XAI_TOOL_RATE_MICRO_USD: {
     readonly web_search_calls: 5000;
@@ -875,10 +875,10 @@ declare const XAI_PRICING: Readonly<Record<string, XaiModelRates>>;
  *    nearest integer micro-USD.
  * 6. `microUsd` is the sum of the four components — guarantees
  *    `details.input + details.cached + details.output + details.tools === microUsd`.
- * 7. Tool lanes: live-pinned counters `web_search_calls`, `x_search_calls`,
- *    `document_search_calls`. If `usage.details.server_tools_requested === 1`
- *    and those counters are absent, token lanes are priced, `tools: 0`,
- *    `confidence: 'estimated'`. `'exact'` requires counters present or no
+ * 7. Tool lanes: live-pinned counters `web_search_calls`, `x_search_calls`.
+ *    Missing expected counters → `tools: 0`, `estimated`. File-ref sets
+ *    `attachment_search_unpinned` → `estimated` (attachment not priced).
+ *    `'exact'` requires no unpinned attachment and counters present or no
  *    server tools requested.
  */
 declare function computeXaiCost(model: string, usage: Usage, tier?: string): Cost;

package/dist/index.d.ts

@@ -815,7 +815,7 @@ declare const xaiPricingVersion: "xai-2026-08-24";
 /**
  * Live-pinned 2026-08-24 per-invocation tool rates (µUSD per call).
  * Source: `usage.server_side_tool_usage_details` on /v1/responses.
- * $5 / 1,000 web or X searches; $10 / 1,000 attachment/document searches.
+ * $5 / 1,000 web or X searches. Attachment search is not priced until live-pinned.
  */
 declare const XAI_TOOL_RATE_MICRO_USD: {
     readonly web_search_calls: 5000;
@@ -875,10 +875,10 @@ declare const XAI_PRICING: Readonly<Record<string, XaiModelRates>>;
  *    nearest integer micro-USD.
  * 6. `microUsd` is the sum of the four components — guarantees
  *    `details.input + details.cached + details.output + details.tools === microUsd`.
- * 7. Tool lanes: live-pinned counters `web_search_calls`, `x_search_calls`,
- *    `document_search_calls`. If `usage.details.server_tools_requested === 1`
- *    and those counters are absent, token lanes are priced, `tools: 0`,
- *    `confidence: 'estimated'`. `'exact'` requires counters present or no
+ * 7. Tool lanes: live-pinned counters `web_search_calls`, `x_search_calls`.
+ *    Missing expected counters → `tools: 0`, `estimated`. File-ref sets
+ *    `attachment_search_unpinned` → `estimated` (attachment not priced).
+ *    `'exact'` requires no unpinned attachment and counters present or no
  *    server tools requested.
  */
 declare function computeXaiCost(model: string, usage: Usage, tier?: string): Cost;

package/dist/index.js

@@ -556,6 +556,13 @@ function xaiAdapter(opts) {
             )}]; tool cost will be estimated.`
           });
         }
+        if (hasFileRef) {
+          usage.details["attachment_search_unpinned"] = 1;
+          warnings.push({
+            type: "other",
+            message: "xai: file-ref enables attachment_search but that counter is not live-pinned; tool cost is estimated."
+          });
+        }
       }
       const citations = collectXaiCitations(response, messageItems);
       const providerMeta = {};
@@ -1492,7 +1499,8 @@ function computeXaiCost(model, usage, tier) {
     usage.outputTokens * base.outputPerM * factor / 1e6
   );
   const serverToolsRequested = usage.details["server_tools_requested"] === 1;
-  const missingRequestedCounters = usage.details["server_tools_missing"] === 1 || serverToolsRequested && !XAI_TOOL_COUNTER_KEYS.some((key) => key in usage.details);
+  const missingRequestedCounters = usage.details["server_tools_missing"] === 1 || serverToolsRequested && usage.details["attachment_search_unpinned"] !== 1 && !XAI_TOOL_COUNTER_KEYS.some((key) => key in usage.details);
+  const attachmentUnpinned = usage.details["attachment_search_unpinned"] === 1;
   const toolsCost = missingRequestedCounters ? 0 : XAI_TOOL_COUNTER_KEYS.reduce((sum, key) => {
     const count = usage.details[key];
     if (typeof count !== "number" || count <= 0) return sum;
@@ -1503,7 +1511,7 @@ function computeXaiCost(model, usage, tier) {
     microUsd,
     usd: microUsd / 1e6,
     pricingVersion: xaiPricingVersion,
-    confidence: missingRequestedCounters ? "estimated" : "exact",
+    confidence: missingRequestedCounters || attachmentUnpinned ? "estimated" : "exact",
     details: {
       input: inputCost,
       cached: cachedCost,