@proveanything/smartlinks 2.0.36 → 2.0.37

package/dist/api/ai.d.ts

@@ -111,8 +111,8 @@ declare namespace aiInternal {
         }>;
     }
     /**
-     * AI usage / cost report for a collection, grouped by any of model/serviceTier/appId/feature/mode
-     * over an optional date window. `costUnits` are OPAQUE internal units, never provider currency.
+     * AI usage for a collection (daily totals), grouped by any of model/appId/feature/mode/surface/provider/day
+     * over an optional date window (YYYY-MM-DD). Usage only — requests, tokens, images; no cost figures.
      */
     function usage(collectionId: string, params?: {
         groupBy?: string | string[];

package/dist/api/ai.js

@@ -224,8 +224,8 @@ var aiInternal;
         sessions.clear = clear;
     })(sessions = aiInternal.sessions || (aiInternal.sessions = {}));
     /**
-     * AI usage / cost report for a collection, grouped by any of model/serviceTier/appId/feature/mode
-     * over an optional date window. `costUnits` are OPAQUE internal units, never provider currency.
+     * AI usage for a collection (daily totals), grouped by any of model/appId/feature/mode/surface/provider/day
+     * over an optional date window (YYYY-MM-DD). Usage only — requests, tokens, images; no cost figures.
      */
     async function usage(collectionId, params) {
         const groupBy = Array.isArray(params === null || params === void 0 ? void 0 : params.groupBy) ? params.groupBy.join(',') : params === null || params === void 0 ? void 0 : params.groupBy;

package/dist/context.js

@@ -40,6 +40,21 @@ export function readContext(overrides) {
             if (window.location.search)
                 readSearchParamsInto(out, new URLSearchParams(window.location.search));
         }
+        // 4. the SITE the page is served as (lowest precedence). When an app runs as a public website at
+        //    its own hostname (an "app site"), the host page injects window.__SMARTLINKS_SITE__ =
+        //    { collectionId, appId, channel, host } — so a site knows its collection with no URL params.
+        const site = globalThis.__SMARTLINKS_SITE__;
+        if (site && typeof site === 'object') {
+            const fill = (key, value) => { if (out[key] == null && typeof value === 'string' && value)
+                out[key] = value; };
+            fill('collectionId', site.collectionId);
+            fill('appId', site.appId);
+            // A site on a pre-release channel calls that channel's server functions (stable needs no channel).
+            if (site.channel && site.channel !== 'stable') {
+                fill('appChannel', site.channel);
+                fill('appChannelApp', site.appId);
+            }
+        }
     }
     catch (_a) {
         /* non-browser / bad URL — return what we have */

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.36  |  Generated: 2026-10-03T15:04:37.396Z
+Version: 2.0.37  |  Generated: 2026-10-04T09:59:59.885Z
 
 This is a concise summary of all available API functions and types.
 
@@ -918,8 +918,20 @@ interface AiUsageReport {
   groupBy: string[]
   from?: string | null
   to?: string | null
-  totals: { promptTokens: number; outputTokens: number; totalTokens: number; requests: number; costUnits: number }
-  groups: Array<Record<string, any> & { promptTokens: number; outputTokens: number; totalTokens: number; requests: number; costUnits: number }>
+  totals: AiUsageTotals
+  groups: Array<Record<string, any> & AiUsageTotals>
+}
+```
+
+**AiUsageTotals** (interface)
+```typescript
+interface AiUsageTotals {
+  promptTokens: number
+  outputTokens: number
+  cachedTokens: number
+  totalTokens: number
+  requests: number
+  images: number
 }
 ```
 

package/dist/docs/server-functions.md

@@ -275,7 +275,7 @@ await SL.functions.call(collectionId, 'pressCounter', {}, { channel: null })   /
 ```
 
 **Public address on the collection's own site (webhooks, integrations).** Every collection has a
-site host — `<name>.smartlinks.host` once a name is claimed, else `c-<shortId>.smartlinks.host` —
+site host — `<name>.smartlinks.host` once a name is claimed, else `c-<collectionId>.smartlinks.host` —
 returned as `collection.siteHost`. App functions are reachable there:
 
 ```

package/dist/openapi.yaml

@@ -1347,7 +1347,7 @@ paths:
     get:
       tags:
         - sessions
-      summary: AI usage / cost report for a collection, grouped by any of model/serviceTier/appId/feature/mode over an optional date window.
+      summary: AI usage for a collection (daily totals), grouped by any of model/appId/feature/mode/surface/provider/day over an optional date window (YYYY-MM-DD).
       operationId: sessions_usage
       security:
         - bearerAuth: []
@@ -16327,17 +16327,37 @@ components:
         to:
           type: string
         totals:
-          type: object
-          additionalProperties: true
+          $ref: "#/components/schemas/AiUsageTotals"
         groups:
           type: array
           items:
-            type: object
-            additionalProperties: true
+            $ref: "#/components/schemas/AiUsageTotals"
       required:
         - groupBy
         - totals
         - groups
+    AiUsageTotals:
+      type: object
+      properties:
+        promptTokens:
+          type: number
+        outputTokens:
+          type: number
+        cachedTokens:
+          type: number
+        totalTokens:
+          type: number
+        requests:
+          type: number
+        images:
+          type: number
+      required:
+        - promptTokens
+        - outputTokens
+        - cachedTokens
+        - totalTokens
+        - requests
+        - images
     VoiceSessionRequest:
       type: object
       properties:

package/dist/types/ai.d.ts

@@ -412,25 +412,22 @@ export interface AiSessionCreate {
     /** Seed items (e.g. a system/instruction turn). */
     items?: ResponseInputItem[];
 }
-/** Per-collection AI usage/cost report. `costUnits` are OPAQUE internal units, never provider currency. */
+/** Per-collection AI usage report (daily totals). Usage only — requests, tokens, images; no cost figures. */
 export interface AiUsageReport {
     groupBy: string[];
     from?: string | null;
     to?: string | null;
-    totals: {
-        promptTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-        requests: number;
-        costUnits: number;
-    };
-    groups: Array<Record<string, any> & {
-        promptTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-        requests: number;
-        costUnits: number;
-    }>;
+    totals: AiUsageTotals;
+    groups: Array<Record<string, any> & AiUsageTotals>;
+}
+/** Summed usage for a report group (or the whole window). */
+export interface AiUsageTotals {
+    promptTokens: number;
+    outputTokens: number;
+    cachedTokens: number;
+    totalTokens: number;
+    requests: number;
+    images: number;
 }
 /** Voice session request */
 export interface VoiceSessionRequest {

package/dist/types/collection.d.ts

@@ -48,7 +48,7 @@ export interface Collection {
     hubCustomDomain?: string;
     /**
      * The collection's SITE HOST on the tenant domain — computed by the server, never stored:
-     * `<hubName>.smartlinks.host` when a name is claimed, else the default `c-<shortId>.smartlinks.host`.
+     * `<hubName>.smartlinks.host` when a name is claimed, else the default `c-<collectionId>.smartlinks.host`.
      * Hub serves it, and app functions are reachable under it at `https://<siteHost>/_fn/…`
      * (see SL.functions.siteUrl).
      */

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.36  |  Generated: 2026-10-03T15:04:37.396Z
+Version: 2.0.37  |  Generated: 2026-10-04T09:59:59.885Z
 
 This is a concise summary of all available API functions and types.
 
@@ -918,8 +918,20 @@ interface AiUsageReport {
   groupBy: string[]
   from?: string | null
   to?: string | null
-  totals: { promptTokens: number; outputTokens: number; totalTokens: number; requests: number; costUnits: number }
-  groups: Array<Record<string, any> & { promptTokens: number; outputTokens: number; totalTokens: number; requests: number; costUnits: number }>
+  totals: AiUsageTotals
+  groups: Array<Record<string, any> & AiUsageTotals>
+}
+```
+
+**AiUsageTotals** (interface)
+```typescript
+interface AiUsageTotals {
+  promptTokens: number
+  outputTokens: number
+  cachedTokens: number
+  totalTokens: number
+  requests: number
+  images: number
 }
 ```
 

package/docs/server-functions.md

@@ -275,7 +275,7 @@ await SL.functions.call(collectionId, 'pressCounter', {}, { channel: null })   /
 ```
 
 **Public address on the collection's own site (webhooks, integrations).** Every collection has a
-site host — `<name>.smartlinks.host` once a name is claimed, else `c-<shortId>.smartlinks.host` —
+site host — `<name>.smartlinks.host` once a name is claimed, else `c-<collectionId>.smartlinks.host` —
 returned as `collection.siteHost`. App functions are reachable there:
 
 ```

package/openapi.yaml

@@ -1347,7 +1347,7 @@ paths:
     get:
       tags:
         - sessions
-      summary: AI usage / cost report for a collection, grouped by any of model/serviceTier/appId/feature/mode over an optional date window.
+      summary: AI usage for a collection (daily totals), grouped by any of model/appId/feature/mode/surface/provider/day over an optional date window (YYYY-MM-DD).
       operationId: sessions_usage
       security:
         - bearerAuth: []
@@ -16327,17 +16327,37 @@ components:
         to:
           type: string
         totals:
-          type: object
-          additionalProperties: true
+          $ref: "#/components/schemas/AiUsageTotals"
         groups:
           type: array
           items:
-            type: object
-            additionalProperties: true
+            $ref: "#/components/schemas/AiUsageTotals"
       required:
         - groupBy
         - totals
         - groups
+    AiUsageTotals:
+      type: object
+      properties:
+        promptTokens:
+          type: number
+        outputTokens:
+          type: number
+        cachedTokens:
+          type: number
+        totalTokens:
+          type: number
+        requests:
+          type: number
+        images:
+          type: number
+      required:
+        - promptTokens
+        - outputTokens
+        - cachedTokens
+        - totalTokens
+        - requests
+        - images
     VoiceSessionRequest:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.36",
+  "version": "2.0.37",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",