@soat/cli 0.37.1 → 0.38.1

package/dist/index.mjs

@@ -13,7 +13,7 @@ import * as os from "node:os";
 import { createHmac, timingSafeEqual } from "node:crypto";
 
 //#region package.json
-var version = "0.37.1";
+var version = "0.38.1";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -2987,12 +2987,18 @@ var routes = {
   "create-embeddings": {
     serviceClass: "Embeddings",
     operationId: "createEmbeddings",
-    description: "Generates embedding vectors for one or more text inputs using the server's configured embedding model. Provide `input` for a single text or `inputs` for a batch. At least one is required. Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used.",
+    description: "Generates embedding vectors for one or more text inputs using the server's configured embedding model. Provide `input` for a single text or `inputs` for a batch. At least one is required. Returns `embedding` when `input` is used, and `embeddings` when `inputs` is used. `project_id` names the project the call's token usage is metered against, so embedding spend reaches the usage rollup and the project's `cost_usd` / `tokens` quotas. A project-scoped credential supplies its own project; a call that names none and is bound to none is served but not metered.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/embeddings",
     httpMethod: "post",
     pathParams: [],
     queryParams: [],
     flags: [{
+      "name": "project_id",
+      "description": "Project the call's usage is billed to. Optional; a project-scoped credential supplies its own. Requires write access to the named project.",
+      "required": false,
+      "type": "string",
+      "in": "body"
+    }, {
       "name": "input",
       "description": "Single text to embed.",
       "required": false,
@@ -7774,7 +7780,7 @@ var routes = {
       "in": "query"
     }, {
       "name": "source",
-      "description": "Filter by what the spend was incurred for. `eval` is an eval run's item generations and `eval_judge` an `llm_judge` scorer's own completion, so verification spend is `source` in (`eval`, `eval_judge`). Ordinary agent traffic carries no source and is matched by neither.\n",
+      "description": "Filter by what the spend was incurred for. `eval` is an eval run's item generations and `eval_judge` an `llm_judge` scorer's own completion, so verification spend is `source` in (`eval`, `eval_judge`); `embedding` is any embedding call. Ordinary agent traffic carries no source and is matched by none of them.\n",
       "required": false,
       "type": "string",
       "in": "query"
@@ -7795,11 +7801,11 @@ var routes = {
   "get-usage": {
     serviceClass: "Usage",
     operationId: "getUsage",
-    description: "Returns a project's usage rolled up over an optional `[from, to]` time window, bucketed by a single dimension and optionally narrowed to one `meter_type`. Each group and the grand total carry summed token counts, a measured `quantity` per component (so infra meters report their real amount, not zeros), and `cost_usd` (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw meter rows client-side.",
+    description: "Returns a project's usage rolled up over an optional `[from, to]` time window, bucketed by a single dimension and optionally narrowed to one `meter_type`. Each group and the grand total carry an `event_count`, summed token counts, a measured `quantity` per component (so infra meters report their real amount, not zeros), and `cost_usd` (null when no event in the bucket was priced). This is the per-project cost-by-range/by-category query — a monthly figure without scanning raw meter rows client-side. `groups` is paginated. Its `total` is the number of distinct buckets in the window, so \"how many runs this cycle\" is one small response rather than a page walk, and `totals` always describes the whole window — never the page above it.",
     moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
     httpMethod: "get",
     pathParams: [],
-    queryParams: ["project_id", "group_by", "from", "to", "meter_type"],
+    queryParams: ["project_id", "group_by", "from", "to", "meter_type", "limit", "offset"],
     flags: [{
       "name": "project_id",
       "description": "Project public ID to aggregate usage for",
@@ -7830,6 +7836,18 @@ var routes = {
       "required": false,
       "type": "string",
       "in": "query"
+    }, {
+      "name": "limit",
+      "description": "Maximum number of `groups` entries to return. Clamped to 100. Does not affect `totals` or `groups.total`, which describe the whole window.\n",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }, {
+      "name": "offset",
+      "description": "Number of `groups` entries to skip",
+      "required": false,
+      "type": "integer",
+      "in": "query"
     }]
   },
   "list-usage-thresholds": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.37.1",
+  "version": "0.38.1",
   "description": "CLI for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@inquirer/input": "^5.1.2",
     "@inquirer/password": "^5.1.1",
-    "@soat/sdk": "0.37.1",
+    "@soat/sdk": "0.38.1",
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1"