@ai-matrx/api 0.1.30 → 0.1.32

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 var chunkFNIYADWI_cjs = require('./chunk-FNIYADWI.cjs');
 var chunkMVXD6WI6_cjs = require('./chunk-MVXD6WI6.cjs');
-var chunkILAZVNEL_cjs = require('./chunk-ILAZVNEL.cjs');
+var chunk27ZEEIXM_cjs = require('./chunk-27ZEEIXM.cjs');
 var chunk2SXAAKGV_cjs = require('./chunk-2SXAAKGV.cjs');
 var format = require('@ai-matrx/kit/format');
 
@@ -44,7 +44,7 @@ function buildMatrxRequestBody(body, scope) {
   }
   const bodyOrganizationId = base.organization_id;
   if (scope.organization_id !== void 0 && bodyOrganizationId !== void 0 && (typeof bodyOrganizationId !== "string" || bodyOrganizationId.trim() !== scope.organization_id)) {
-    throw new chunkILAZVNEL_cjs.OrganizationContextError(
+    throw new chunk27ZEEIXM_cjs.OrganizationContextError(
       "organization_context_mismatch",
       "Request body organization_id must match the request context organization."
     );
@@ -116,14 +116,14 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
   };
   async function* events() {
     if (!response.body) {
-      throw new chunkILAZVNEL_cjs.BackendApiError({
+      throw new chunk27ZEEIXM_cjs.BackendApiError({
         code: "internal_error",
         detail: "Response has no body",
         userMessage: "No response received from server"
       });
     }
     try {
-      for await (const envelope of chunkILAZVNEL_cjs.readMatrxNdjsonStream(response.body, {
+      for await (const envelope of chunk27ZEEIXM_cjs.readMatrxNdjsonStream(response.body, {
         ...signal ? { signal } : {},
         ...hooks.onMalformedLine ? { onMalformedLine: hooks.onMalformedLine } : {},
         ...hooks.onUnknownEnvelope ? { onUnknownEnvelope: hooks.onUnknownEnvelope } : {}
@@ -135,7 +135,7 @@ function parseMatrxNdjsonResponse(response, signal, hooks = {}) {
       if (signal?.aborted || error instanceof Error && error.name === "AbortError") {
         return;
       }
-      const transportError = error instanceof chunkILAZVNEL_cjs.BackendApiError ? error : new chunkILAZVNEL_cjs.StreamTransportError({
+      const transportError = error instanceof chunk27ZEEIXM_cjs.BackendApiError ? error : new chunk27ZEEIXM_cjs.StreamTransportError({
         detail: error instanceof Error ? error.message : "The response stream ended unexpectedly.",
         details: error,
         ...ids.requestId ? { requestId: ids.requestId } : {}
@@ -152,7 +152,7 @@ async function httpErrorFrom(response) {
   const serverDetail = await response.json().catch(() => void 0);
   return {
     type: response.status >= 400 && response.status < 500 ? "validation_error" : "http_error",
-    message: chunkILAZVNEL_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
+    message: chunk27ZEEIXM_cjs.extractMatrxErrorMessage(serverDetail) ?? bareStatusSentence(response.status),
     status: response.status,
     serverDetail
   };
@@ -160,7 +160,7 @@ async function httpErrorFrom(response) {
 async function executeMatrxCall(request, hooks = {}) {
   const upper = request.method.toUpperCase();
   const sendsBody = request.stream || upper !== "GET" && upper !== "HEAD";
-  const { response } = await chunkILAZVNEL_cjs.sendOnWire({
+  const { response } = await chunk27ZEEIXM_cjs.sendOnWire({
     url: request.url,
     method: request.method,
     headers: request.headers,
@@ -210,11 +210,11 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
     headers[name] = value;
   });
   const fetchOptions = {};
-  for (const key of chunkILAZVNEL_cjs.WIRE_FETCH_OPTION_KEYS) {
+  for (const key of chunk27ZEEIXM_cjs.WIRE_FETCH_OPTION_KEYS) {
     if (init[key] !== void 0) fetchOptions[key] = init[key];
   }
   try {
-    const { response, controller } = await chunkILAZVNEL_cjs.sendOnWire({
+    const { response, controller } = await chunk27ZEEIXM_cjs.sendOnWire({
       url,
       method: init.method ?? "GET",
       fetchOptions,
@@ -237,7 +237,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
       throw callerSignal?.reason instanceof Error ? callerSignal.reason : new DOMException("The request was cancelled.", "AbortError");
     }
     if (options.timeoutMs !== void 0 && chunk2SXAAKGV_cjs.isNetError(error) && (error.code === "connect-timeout" || error.code === "total-timeout")) {
-      throw new chunkILAZVNEL_cjs.BackendApiError({
+      throw new chunk27ZEEIXM_cjs.BackendApiError({
         code: "request_timeout",
         detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
         userMessage: "The request timed out \u2014 please retry.",
@@ -251,7 +251,7 @@ async function sendMatrxRequest(url, init = {}, options = {}) {
   }
 }
 async function readMatrxJsonResponse(response) {
-  if (!response.ok) throw await chunkILAZVNEL_cjs.parseHttpError(response);
+  if (!response.ok) throw await chunk27ZEEIXM_cjs.parseHttpError(response);
   if (response.status === 204) return null;
   return await response.json();
 }
@@ -261,7 +261,7 @@ function classifyStatus(status) {
   return status >= 400 && status < 500 ? "validation_error" : "http_error";
 }
 function normalizeMatrxError(err) {
-  if (err instanceof chunkILAZVNEL_cjs.OrganizationContextError) {
+  if (err instanceof chunk27ZEEIXM_cjs.OrganizationContextError) {
     return {
       type: "validation_error",
       message: err.message,
@@ -273,7 +273,7 @@ function normalizeMatrxError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return { type: "abort_error", message: "Request was cancelled." };
   }
-  if (err instanceof chunkILAZVNEL_cjs.MatrxApiError) {
+  if (err instanceof chunk27ZEEIXM_cjs.MatrxApiError) {
     return {
       type: classifyStatus(err.status),
       message: honestTransportMessage(err.message, err.status),
@@ -283,7 +283,7 @@ function normalizeMatrxError(err) {
       name: err.name
     };
   }
-  if (err instanceof chunkILAZVNEL_cjs.BackendApiError) {
+  if (err instanceof chunk27ZEEIXM_cjs.BackendApiError) {
     return {
       type: "network_error",
       message: honestTransportMessage(
@@ -379,9 +379,9 @@ function createMatrxTransport(options) {
   const resolve = resolveTarget ?? (() => ({ baseUrl }));
   const resolveOrganizationId = (callOrganizationId) => {
     if (organizationId === void 0) return null;
-    if (callOrganizationId !== null) return chunkILAZVNEL_cjs.requireOrganizationContext(callOrganizationId);
+    if (callOrganizationId !== null) return chunk27ZEEIXM_cjs.requireOrganizationContext(callOrganizationId);
     const candidate = typeof organizationId === "function" ? organizationId() : organizationId;
-    return chunkILAZVNEL_cjs.requireOrganizationContext(candidate);
+    return chunk27ZEEIXM_cjs.requireOrganizationContext(candidate);
   };
   return {
     async fetch(path, init) {
@@ -392,7 +392,7 @@ function createMatrxTransport(options) {
       let overHeaders = callOrganizationId === null ? policyHeaders : stripOrganizationHeader(policyHeaders);
       const orgId = resolveOrganizationId(callOrganizationId);
       if (orgId !== null) {
-        overHeaders = chunkILAZVNEL_cjs.applyOrganizationContextHeader(overHeaders, orgId);
+        overHeaders = chunk27ZEEIXM_cjs.applyOrganizationContextHeader(overHeaders, orgId);
       }
       const wireHeaders = callOrganizationId === null ? { ...init.headers } : stripOrganizationHeader({ ...init.headers });
       const info = {
@@ -405,7 +405,7 @@ function createMatrxTransport(options) {
       diagnostics?.onRequest?.(info);
       let response;
       try {
-        ({ response } = await chunkILAZVNEL_cjs.sendOnWire(
+        ({ response } = await chunk27ZEEIXM_cjs.sendOnWire(
           {
             url,
             method: init.method,
@@ -429,11 +429,11 @@ function createMatrxTransport(options) {
       }
       if (!response.ok && !expectedErrorStatuses?.includes(response.status)) {
         const serverDetail = await response.clone().json().catch(() => void 0);
-        const code = chunkILAZVNEL_cjs.extractMatrxErrorCode(serverDetail);
+        const code = chunk27ZEEIXM_cjs.extractMatrxErrorCode(serverDetail);
         diagnostics?.onError?.(
           {
             type: classifyStatus(response.status),
-            message: chunkILAZVNEL_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
+            message: chunk27ZEEIXM_cjs.extractMatrxErrorMessage(serverDetail) ?? `HTTP ${response.status}`,
             status: response.status,
             serverDetail,
             ...code ? { code } : {}
@@ -734,7 +734,7 @@ async function readServerDetail(response) {
   }
 }
 async function throwApiError(path, response) {
-  throw new chunkILAZVNEL_cjs.MatrxApiError({
+  throw new chunk27ZEEIXM_cjs.MatrxApiError({
     status: response.status,
     path,
     serverDetail: await readServerDetail(response)
@@ -755,7 +755,7 @@ function toRunHandle(response, options) {
   return {
     requestId: response.headers.get("X-Request-ID"),
     conversationId: response.headers.get("X-Conversation-ID"),
-    events: chunkILAZVNEL_cjs.readMatrxNdjsonStream(response.body, {
+    events: chunk27ZEEIXM_cjs.readMatrxNdjsonStream(response.body, {
       ...options.signal ? { signal: options.signal } : {},
       ...options.maxReadAhead !== void 0 ? { maxReadAhead: options.maxReadAhead } : {},
       ...options.onMalformedLine ? { onMalformedLine: options.onMalformedLine } : {},
@@ -778,7 +778,7 @@ async function requestStream(transport, path, options) {
   });
   if (!response.ok) return throwApiError(path, response);
   if (!response.body) {
-    throw new chunkILAZVNEL_cjs.MatrxApiError({
+    throw new chunk27ZEEIXM_cjs.MatrxApiError({
       status: response.status,
       path,
       serverDetail: { code: "missing_response_body" },
@@ -838,7 +838,7 @@ async function getRuntimeOperationStatus(transport, requestId, options = {}) {
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkILAZVNEL_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunk27ZEEIXM_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -853,7 +853,7 @@ async function getRuntimeOperationsByLink(transport, linkKind, linkId, options =
       { method: "GET", ...options.signal ? { signal: options.signal } : {} }
     );
   } catch (error) {
-    if (error instanceof chunkILAZVNEL_cjs.MatrxApiError && error.status === 404) return null;
+    if (error instanceof chunk27ZEEIXM_cjs.MatrxApiError && error.status === 404) return null;
     throw error;
   }
 }
@@ -894,7 +894,7 @@ async function* followRuntimeOperationEvents(transport, executionId, options = {
       ...options.signal ? { signal: options.signal } : {}
     }
   );
-  const frames = chunkILAZVNEL_cjs.readMatrxSseStream(
+  const frames = chunk27ZEEIXM_cjs.readMatrxSseStream(
     response.body,
     options.onIncomplete ? { onIncomplete: options.onIncomplete } : {}
   );
@@ -1097,7 +1097,7 @@ async function openMatrxStream(transport, path, options = {}) {
   return toRunHandle(response, options);
 }
 function withRunOrganization(transport, organizationId) {
-  const orgId = chunkILAZVNEL_cjs.requireOrganizationContext(organizationId);
+  const orgId = chunk27ZEEIXM_cjs.requireOrganizationContext(organizationId);
   return {
     fetch: (path, init) => transport.fetch(path, {
       ...init,
@@ -1124,7 +1124,7 @@ async function followWorkflowRunEvents(transport, runId, options) {
     throw error;
   }
   try {
-    for await (const frame of chunkILAZVNEL_cjs.readMatrxSseStream(
+    for await (const frame of chunk27ZEEIXM_cjs.readMatrxSseStream(
       response.body
     )) {
       if (frame.event === "end") return { ended: true };
@@ -1170,7 +1170,7 @@ async function resumeOrRejoin(transport, resumeCall, options) {
   } catch (error) {
     const target = readLiveRunRejoin(error);
     if (!target) {
-      if (error instanceof chunkILAZVNEL_cjs.MatrxApiError && isResumeConflict(error)) {
+      if (error instanceof chunk27ZEEIXM_cjs.MatrxApiError && isResumeConflict(error)) {
         return { kind: "resume_conflict", error };
       }
       throw error;
@@ -1571,9 +1571,19 @@ function providerSessionUsageBody(usage) {
     output_tokens: count(usage.output_tokens),
     cached_input_tokens: count(usage.cached_input_tokens),
     characters: count(usage.characters),
-    seconds
+    seconds,
+    ...componentsBody(usage.components)
   };
 }
+var COMPONENT_KEY = /^(input|cached_input|output)\.[a-z_]{1,32}$/;
+function componentsBody(components) {
+  if (!components) return {};
+  const out = {};
+  for (const [key, value] of Object.entries(components)) {
+    if (COMPONENT_KEY.test(key) && count(value) > 0) out[key] = count(value);
+  }
+  return Object.keys(out).length > 0 ? { components: out } : {};
+}
 function isEmptyProviderUsage(usage) {
   return !usage.usage_id?.trim() || !usage.model?.trim() || count(usage.input_tokens) === 0 && count(usage.output_tokens) === 0 && count(usage.cached_input_tokens) === 0 && count(usage.characters) === 0 && !(typeof usage.seconds === "number" && usage.seconds > 0);
 }
@@ -1586,7 +1596,7 @@ async function reportProviderSessionUsage(transport, usage, options = {}) {
     });
     return "ok";
   } catch (error) {
-    if (error instanceof chunkILAZVNEL_cjs.MatrxApiError) {
+    if (error instanceof chunk27ZEEIXM_cjs.MatrxApiError) {
       const status = error.status;
       if (status >= 400 && status < 500 && status !== 401 && status !== 408 && status !== 425 && status !== 429) {
         console.warn(`[provider-usage] server refused ${usage.provider} usage ${usage.usage_id} (${status})`);
@@ -2282,115 +2292,115 @@ Object.defineProperty(exports, "toCredentialsPort", {
 });
 Object.defineProperty(exports, "BackendApiError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.BackendApiError; }
+  get: function () { return chunk27ZEEIXM_cjs.BackendApiError; }
 });
 Object.defineProperty(exports, "CONTRACT_SHA256", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.CONTRACT_SHA256; }
+  get: function () { return chunk27ZEEIXM_cjs.CONTRACT_SHA256; }
 });
 Object.defineProperty(exports, "DEPLOYMENTS", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.DEPLOYMENTS; }
+  get: function () { return chunk27ZEEIXM_cjs.DEPLOYMENTS; }
 });
 Object.defineProperty(exports, "DOMAINS", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.DOMAINS; }
+  get: function () { return chunk27ZEEIXM_cjs.DOMAINS; }
 });
 Object.defineProperty(exports, "MatrxApiError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.MatrxApiError; }
+  get: function () { return chunk27ZEEIXM_cjs.MatrxApiError; }
 });
 Object.defineProperty(exports, "OrganizationContextError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.OrganizationContextError; }
+  get: function () { return chunk27ZEEIXM_cjs.OrganizationContextError; }
 });
 Object.defineProperty(exports, "StreamTransportError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.StreamTransportError; }
+  get: function () { return chunk27ZEEIXM_cjs.StreamTransportError; }
 });
 Object.defineProperty(exports, "applyOrganizationContextHeader", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.applyOrganizationContextHeader; }
+  get: function () { return chunk27ZEEIXM_cjs.applyOrganizationContextHeader; }
 });
 Object.defineProperty(exports, "assertOrganizationMatchesOperation", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.assertOrganizationMatchesOperation; }
+  get: function () { return chunk27ZEEIXM_cjs.assertOrganizationMatchesOperation; }
 });
 Object.defineProperty(exports, "assertQueryOrganizationMatchesContext", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.assertQueryOrganizationMatchesContext; }
+  get: function () { return chunk27ZEEIXM_cjs.assertQueryOrganizationMatchesContext; }
 });
 Object.defineProperty(exports, "createApi", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.createApi; }
+  get: function () { return chunk27ZEEIXM_cjs.createApi; }
 });
 Object.defineProperty(exports, "createOrganizationOperation", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.createOrganizationOperation; }
+  get: function () { return chunk27ZEEIXM_cjs.createOrganizationOperation; }
 });
 Object.defineProperty(exports, "describeBackendFailure", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.describeBackendFailure; }
+  get: function () { return chunk27ZEEIXM_cjs.describeBackendFailure; }
 });
 Object.defineProperty(exports, "extractMatrxErrorCode", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.extractMatrxErrorCode; }
+  get: function () { return chunk27ZEEIXM_cjs.extractMatrxErrorCode; }
 });
 Object.defineProperty(exports, "extractMatrxErrorMessage", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.extractMatrxErrorMessage; }
+  get: function () { return chunk27ZEEIXM_cjs.extractMatrxErrorMessage; }
 });
 Object.defineProperty(exports, "getUserMessage", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.getUserMessage; }
+  get: function () { return chunk27ZEEIXM_cjs.getUserMessage; }
 });
 Object.defineProperty(exports, "isBinaryType", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.isBinaryType; }
+  get: function () { return chunk27ZEEIXM_cjs.isBinaryType; }
 });
 Object.defineProperty(exports, "isGenericUserMessage", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.isGenericUserMessage; }
+  get: function () { return chunk27ZEEIXM_cjs.isGenericUserMessage; }
 });
 Object.defineProperty(exports, "isStreamTransportLost", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.isStreamTransportLost; }
+  get: function () { return chunk27ZEEIXM_cjs.isStreamTransportLost; }
 });
 Object.defineProperty(exports, "openJsonOrStream", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.openJsonOrStream; }
+  get: function () { return chunk27ZEEIXM_cjs.openJsonOrStream; }
 });
 Object.defineProperty(exports, "openStream", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.openStream; }
+  get: function () { return chunk27ZEEIXM_cjs.openStream; }
 });
 Object.defineProperty(exports, "parseCallApiError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.parseCallApiError; }
+  get: function () { return chunk27ZEEIXM_cjs.parseCallApiError; }
 });
 Object.defineProperty(exports, "parseHttpError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.parseHttpError; }
+  get: function () { return chunk27ZEEIXM_cjs.parseHttpError; }
 });
 Object.defineProperty(exports, "parseHttpErrorBody", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.parseHttpErrorBody; }
+  get: function () { return chunk27ZEEIXM_cjs.parseHttpErrorBody; }
 });
 Object.defineProperty(exports, "parsePersistedBackendError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.parsePersistedBackendError; }
+  get: function () { return chunk27ZEEIXM_cjs.parsePersistedBackendError; }
 });
 Object.defineProperty(exports, "parseStreamError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.parseStreamError; }
+  get: function () { return chunk27ZEEIXM_cjs.parseStreamError; }
 });
 Object.defineProperty(exports, "requireOrganizationContext", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.requireOrganizationContext; }
+  get: function () { return chunk27ZEEIXM_cjs.requireOrganizationContext; }
 });
 Object.defineProperty(exports, "unwrapUpstreamError", {
   enumerable: true,
-  get: function () { return chunkILAZVNEL_cjs.unwrapUpstreamError; }
+  get: function () { return chunk27ZEEIXM_cjs.unwrapUpstreamError; }
 });
 Object.defineProperty(exports, "AbortedError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-B6p8TJkh.cjs';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-B6p8TJkh.cjs';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-A1nOdg4F.cjs';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-A1nOdg4F.cjs';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.cjs';
@@ -1819,7 +1819,7 @@ declare function followServerJob(transport: MatrxTransport, options: FollowServe
  */
 
 /** The providers whose sessions a browser holds directly (server allow-list). */
-type MatrxClientSessionProvider = "openai" | "xai" | "cartesia";
+type MatrxClientSessionProvider = "openai" | "xai" | "google" | "cartesia";
 interface ProviderSessionFailure {
     provider: MatrxClientSessionProvider;
     model?: string | null;
@@ -1879,6 +1879,11 @@ interface ProviderSessionUsage {
     cached_input_tokens?: number;
     characters?: number;
     seconds?: number;
+    /**
+     * Per-modality token counts (`input.audio`, `cached_input.audio`, `output.audio`, `input.image`…),
+     * each a subset of its flat count, priced at the catalog's `component_prices`.
+     */
+    components?: Record<string, number>;
 }
 interface ProviderSessionUsageReceipt {
     billed: boolean;
@@ -1888,7 +1893,7 @@ interface ProviderSessionUsageReceipt {
 /** `ok` = the server has it (billed or already had it). `retry` = transient. `drop` = refused for good. */
 type ProviderUsageSendResult = "ok" | "retry" | "drop";
 /** The body the server accepts — bounded exactly as its model bounds it. */
-declare function providerSessionUsageBody(usage: ProviderSessionUsage): Record<string, string | number>;
+declare function providerSessionUsageBody(usage: ProviderSessionUsage): Record<string, string | number | Record<string, number>>;
 /** True when the unit carries nothing the server could price. */
 declare function isEmptyProviderUsage(usage: ProviderSessionUsage): boolean;
 /** One attempt over the transport. Never throws; the result says whether to try again. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-B6p8TJkh.js';
-export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-B6p8TJkh.js';
+import { M as MatrxStreamEnvelope, b as MatrxNdjsonIssue, U as UploadProgress, c as MatrxStreamEnvelopeObservation, d as MatrxSseFrame } from './index-A1nOdg4F.js';
+export { A as Api, e as ApiRequestInfo, a as ApiStream, f as AuthTier, g as CONTRACT_SHA256, C as CallOptions, h as CreateApiOptions, D as DEPLOYMENTS, i as DOMAINS, j as DeploymentName, E as Environment, H as HttpMethod, J as JsonOrStream, N as NdjsonEvent, O as OperationArgs, k as OperationDescriptor, l as OrgRule, S as SseEvent, m as StreamKind, n as createApi, o as isBinaryType, p as openJsonOrStream, q as openStream } from './index-A1nOdg4F.js';
 import { CredentialsPort } from '@ai-matrx/auth/credentials';
 export { API_KEY_PREFIX, CredentialsPort, CredentialsSetting, MATRX_HEADERS, MatrxCredential, MatrxCredentialKind, credentialToHeaders, toCredentialsPort } from '@ai-matrx/auth/credentials';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetErrorCode, NetworkError, OfflineError, ResilientFetchOptions, ResilientFetchResult, RetryOptions, StreamMonitorOptions, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, monitorStream, resilientFetch, toNetError, withRetry } from './net.js';
@@ -1819,7 +1819,7 @@ declare function followServerJob(transport: MatrxTransport, options: FollowServe
  */
 
 /** The providers whose sessions a browser holds directly (server allow-list). */
-type MatrxClientSessionProvider = "openai" | "xai" | "cartesia";
+type MatrxClientSessionProvider = "openai" | "xai" | "google" | "cartesia";
 interface ProviderSessionFailure {
     provider: MatrxClientSessionProvider;
     model?: string | null;
@@ -1879,6 +1879,11 @@ interface ProviderSessionUsage {
     cached_input_tokens?: number;
     characters?: number;
     seconds?: number;
+    /**
+     * Per-modality token counts (`input.audio`, `cached_input.audio`, `output.audio`, `input.image`…),
+     * each a subset of its flat count, priced at the catalog's `component_prices`.
+     */
+    components?: Record<string, number>;
 }
 interface ProviderSessionUsageReceipt {
     billed: boolean;
@@ -1888,7 +1893,7 @@ interface ProviderSessionUsageReceipt {
 /** `ok` = the server has it (billed or already had it). `retry` = transient. `drop` = refused for good. */
 type ProviderUsageSendResult = "ok" | "retry" | "drop";
 /** The body the server accepts — bounded exactly as its model bounds it. */
-declare function providerSessionUsageBody(usage: ProviderSessionUsage): Record<string, string | number>;
+declare function providerSessionUsageBody(usage: ProviderSessionUsage): Record<string, string | number | Record<string, number>>;
 /** True when the unit carries nothing the server could price. */
 declare function isEmptyProviderUsage(usage: ProviderSessionUsage): boolean;
 /** One attempt over the transport. Never throws; the result says whether to try again. */

package/dist/index.js

@@ -1,7 +1,7 @@
 export { monitorStream } from './chunk-YTEOFGFC.js';
 export { API_KEY_PREFIX, MATRX_HEADERS, credentialToHeaders, toCredentialsPort } from './chunk-7MZPBCFV.js';
-import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-KZD6TVJ4.js';
-export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isBinaryType, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-KZD6TVJ4.js';
+import { OrganizationContextError, sendOnWire, WIRE_FETCH_OPTION_KEYS, BackendApiError, parseHttpError, MatrxApiError, applyOrganizationContextHeader, extractMatrxErrorCode, extractMatrxErrorMessage, readMatrxNdjsonStream, readMatrxSseStream, requireOrganizationContext, StreamTransportError } from './chunk-X75SKCDS.js';
+export { BackendApiError, CONTRACT_SHA256, DEPLOYMENTS, DOMAINS, MatrxApiError, OrganizationContextError, StreamTransportError, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createApi, createOrganizationOperation, describeBackendFailure, extractMatrxErrorCode, extractMatrxErrorMessage, getUserMessage, isBinaryType, isGenericUserMessage, isStreamTransportLost, openJsonOrStream, openStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parsePersistedBackendError, parseStreamError, requireOrganizationContext, unwrapUpstreamError } from './chunk-X75SKCDS.js';
 import { isNetError, extractErrorMessage } from './chunk-KIEAFMKB.js';
 export { AbortedError, ConnectTimeoutError, HeartbeatTimeoutError, HttpError, NetError, NetworkError, OfflineError, TotalTimeoutError, extractErrorMessage, isNetError, isTransportFailure, resilientFetch, toNetError, withRetry } from './chunk-KIEAFMKB.js';
 import { formatDurationSeconds } from '@ai-matrx/kit/format';
@@ -1571,9 +1571,19 @@ function providerSessionUsageBody(usage) {
     output_tokens: count(usage.output_tokens),
     cached_input_tokens: count(usage.cached_input_tokens),
     characters: count(usage.characters),
-    seconds
+    seconds,
+    ...componentsBody(usage.components)
   };
 }
+var COMPONENT_KEY = /^(input|cached_input|output)\.[a-z_]{1,32}$/;
+function componentsBody(components) {
+  if (!components) return {};
+  const out = {};
+  for (const [key, value] of Object.entries(components)) {
+    if (COMPONENT_KEY.test(key) && count(value) > 0) out[key] = count(value);
+  }
+  return Object.keys(out).length > 0 ? { components: out } : {};
+}
 function isEmptyProviderUsage(usage) {
   return !usage.usage_id?.trim() || !usage.model?.trim() || count(usage.input_tokens) === 0 && count(usage.output_tokens) === 0 && count(usage.cached_input_tokens) === 0 && count(usage.characters) === 0 && !(typeof usage.seconds === "number" && usage.seconds > 0);
 }

package/dist/integrations.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkILAZVNEL_cjs = require('./chunk-ILAZVNEL.cjs');
+var chunk27ZEEIXM_cjs = require('./chunk-27ZEEIXM.cjs');
 require('./chunk-2SXAAKGV.cjs');
 
 // src/generated/integrations.ts
@@ -3240,6 +3240,26 @@ var $publicModel = { m: "GET", p: "/hugging-face/public/model", d: "aidream", a:
 function publicModel(api, args, options) {
   return api.call($publicModel, args, options);
 }
+var $hfConnectionStatus = { m: "GET", p: "/hugging-face/connection", d: "aidream", a: "guest", o: "required", n: "integrations.hf_connection_status" };
+function hfConnectionStatus(api, args, options) {
+  return api.call($hfConnectionStatus, args, options);
+}
+var $hfDisconnect = { m: "DELETE", p: "/hugging-face/connection", d: "aidream", a: "guest", o: "required", n: "integrations.hf_disconnect" };
+function hfDisconnect(api, args, options) {
+  return api.call($hfDisconnect, args, options);
+}
+var $hfPasteToken = { m: "POST", p: "/hugging-face/connection/token", d: "aidream", a: "guest", o: "required", n: "integrations.hf_paste_token" };
+function hfPasteToken(api, args, options) {
+  return api.call($hfPasteToken, args, options);
+}
+var $hfAuthorize = { m: "POST", p: "/hugging-face/oauth/authorize", d: "aidream", a: "guest", o: "required", n: "integrations.hf_authorize" };
+function hfAuthorize(api, args, options) {
+  return api.call($hfAuthorize, args, options);
+}
+var $hfComplete = { m: "POST", p: "/hugging-face/oauth/complete", d: "aidream", a: "guest", o: "required", n: "integrations.hf_complete" };
+function hfComplete(api, args, options) {
+  return api.call($hfComplete, args, options);
+}
 var $publicOaStatus = { m: "GET", p: "/unpaywall/public/oa-status", d: "aidream", a: "guest", o: "optional", n: "integrations.public_oa_status" };
 function publicOaStatus(api, args, options) {
   return api.call($publicOaStatus, args, options);
@@ -3654,15 +3674,15 @@ function bingIntegrationsDisconnect(api, args, options) {
 }
 var $importNotionZip = { m: "POST", p: "/notion-import/zip", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_notion_zip" };
 function importNotionZip(api, args, options) {
-  return chunkILAZVNEL_cjs.openStream(api, $importNotionZip, args, options);
+  return chunk27ZEEIXM_cjs.openStream(api, $importNotionZip, args, options);
 }
 var $importNotionConnected = { m: "POST", p: "/notion-import/connected", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_notion_connected" };
 function importNotionConnected(api, args, options) {
-  return chunkILAZVNEL_cjs.openStream(api, $importNotionConnected, args, options);
+  return chunk27ZEEIXM_cjs.openStream(api, $importNotionConnected, args, options);
 }
 var $importNotionConnection = { m: "POST", p: "/notion-import/connection", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_notion_connection" };
 function importNotionConnection(api, args, options) {
-  return chunkILAZVNEL_cjs.openStream(api, $importNotionConnection, args, options);
+  return chunk27ZEEIXM_cjs.openStream(api, $importNotionConnection, args, options);
 }
 var $syncState = { m: "GET", p: "/notion-import/sync", d: "aidream", a: "guest", o: "required", n: "integrations.sync_state" };
 function syncState(api, args, options) {
@@ -3678,7 +3698,7 @@ function listBases(api, args, options) {
 }
 var $importBases = { m: "POST", p: "/airtable-import/import", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "integrations.import_bases" };
 function importBases(api, args, options) {
-  return chunkILAZVNEL_cjs.openStream(api, $importBases, args, options);
+  return chunk27ZEEIXM_cjs.openStream(api, $importBases, args, options);
 }
 var $airtableImportSyncNow = { m: "POST", p: "/airtable-import/sync", d: "aidream", a: "guest", o: "required", n: "integrations.airtable_import_sync_now" };
 function airtableImportSyncNow(api, args, options) {
@@ -4496,6 +4516,11 @@ var TABLE = {
   "GET /openalex/public/work": $openalexIntegrationsPublicWork,
   "GET /figshare/public/item": $figshareIntegrationsPublicItem,
   "GET /hugging-face/public/model": $publicModel,
+  "GET /hugging-face/connection": $hfConnectionStatus,
+  "DELETE /hugging-face/connection": $hfDisconnect,
+  "POST /hugging-face/connection/token": $hfPasteToken,
+  "POST /hugging-face/oauth/authorize": $hfAuthorize,
+  "POST /hugging-face/oauth/complete": $hfComplete,
   "GET /unpaywall/public/oa-status": $publicOaStatus,
   "GET /artic/public/artwork": $articIntegrationsPublicArtwork,
   "GET /arxiv/public/publication": $arxivIntegrationsPublicPublication,
@@ -4946,6 +4971,11 @@ exports.helpshiftStatusIntegrationsPublicStatus = helpshiftStatusIntegrationsPub
 exports.helpwiseStatusIntegrationsPublicStatus = helpwiseStatusIntegrationsPublicStatus;
 exports.hepdataIntegrationsPublicRecord = hepdataIntegrationsPublicRecord;
 exports.hexPmIntegrationsPublicPackage = hexPmIntegrationsPublicPackage;
+exports.hfAuthorize = hfAuthorize;
+exports.hfComplete = hfComplete;
+exports.hfConnectionStatus = hfConnectionStatus;
+exports.hfDisconnect = hfDisconnect;
+exports.hfPasteToken = hfPasteToken;
 exports.higherLogicStatusIntegrationsPublicStatus = higherLogicStatusIntegrationsPublicStatus;
 exports.highspotStatusIntegrationsPublicStatus = highspotStatusIntegrationsPublicStatus;
 exports.hireezStatusIntegrationsPublicStatus = hireezStatusIntegrationsPublicStatus;