@soat/cli 0.14.2 → 0.14.4

package/dist/index.mjs

@@ -11,7 +11,7 @@ import { load } from "js-yaml";
 import * as os from "node:os";
 
 //#region package.json
-var version = "0.14.2";
+var version = "0.14.4";
 
 //#endregion
 //#region src/cli-wrappers/wrappers/formations.ts
@@ -1009,6 +1009,12 @@ var routes = {
       "required": false,
       "type": "object",
       "in": "body"
+    }, {
+      "name": "action_id",
+      "description": "Logical action label recorded on the generation's usage meter, so spend can be rolled up per action (e.g. an A/B/C/D operating action).",
+      "required": false,
+      "type": "string",
+      "in": "body"
     }, {
       "name": "knowledge_config",
       "description": "Per-generation knowledge retrieval override. Array filters (memory_ids, memory_tags, document_ids, document_paths) are unioned with the agent's stored knowledge_config; scalar fields (min_score, limit) use the per-generation value when present.",
@@ -1203,6 +1209,42 @@ var routes = {
       "in": "path"
     }]
   },
+  "get-ai-provider-prices": {
+    serviceClass: "AIProviders",
+    operationId: "getAiProviderPrices",
+    description: "Returns the per-provider price overrides for this AI provider instance. An override prices this specific provider (e.g. an enterprise-negotiated rate or a gateway with markup) and wins over the global default at cost time. Authorized by the caller's access to the provider's project — so, unlike the global price book, a project's own overrides are visible here.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    pathParams: ["ai_provider_id"],
+    queryParams: [],
+    flags: [{
+      "name": "ai_provider_id",
+      "description": "AI Provider ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-ai-provider-prices": {
+    serviceClass: "AIProviders",
+    operationId: "updateAiProviderPrices",
+    description: "Upserts price overrides for this AI provider instance, keyed on (model, effective_from). The provider slug is taken from the AI provider itself, so only the model, rates, and effective_from are supplied. Authorized by the caller's access to the provider's project. `effective_from` must be in the future — past prices are immutable, so ship corrections as new future-dated rows.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/ai-providers",
+    pathParams: ["ai_provider_id"],
+    queryParams: [],
+    flags: [{
+      "name": "ai_provider_id",
+      "description": "AI Provider ID",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "prices",
+      "description": "",
+      "required": true,
+      "type": "array",
+      "in": "body"
+    }]
+  },
   "list-api-keys": {
     serviceClass: "APIKeys",
     operationId: "listApiKeys",
@@ -3921,6 +3963,42 @@ var routes = {
       "in": "query"
     }]
   },
+  "get-project-prices": {
+    serviceClass: "Projects",
+    operationId: "getProjectPrices",
+    description: "Returns the project's per-provider-slug price rows — the middle pricing tier that covers every one of the project's instances of a given provider slug. At cost time a per-provider-instance override wins over these, and these win over the global default. Authorized by the caller's access to the project.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    pathParams: ["project_id"],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Project public ID (proj_ prefix)",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }]
+  },
+  "update-project-prices": {
+    serviceClass: "Projects",
+    operationId: "updateProjectPrices",
+    description: "Upserts project + provider-slug price rows, keyed on (provider, model, effective_from). A row covers all of the project's instances of that provider slug. Authorized by the caller's access to the project. `effective_from` must be in the future — past prices are immutable, so ship corrections as new future-dated rows.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/projects",
+    pathParams: ["project_id"],
+    queryParams: [],
+    flags: [{
+      "name": "project_id",
+      "description": "Project public ID (proj_ prefix)",
+      "required": true,
+      "type": "string",
+      "in": "path"
+    }, {
+      "name": "prices",
+      "description": "",
+      "required": true,
+      "type": "array",
+      "in": "body"
+    }]
+  },
   "list-secrets": {
     serviceClass: "Secrets",
     operationId: "listSecrets",
@@ -4938,6 +5016,96 @@ var routes = {
       "in": "path"
     }]
   },
+  "list-usage-meters": {
+    serviceClass: "Usage",
+    operationId: "listUsageMeters",
+    description: "Returns the raw usage-meter rows the caller can access, most recent first, optionally filtered by agent and generation. Each row is the per-generation token usage as reported by the provider, for audit and reconciliation.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    pathParams: [],
+    queryParams: ["agent_id", "generation_id", "trace_id", "trigger_id", "action_id", "limit", "offset"],
+    flags: [{
+      "name": "agent_id",
+      "description": "Filter by agent public ID",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "generation_id",
+      "description": "Filter by generation public ID",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "trace_id",
+      "description": "Filter by trace public ID",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "trigger_id",
+      "description": "Filter by the trigger that initiated the generation",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "action_id",
+      "description": "Filter by logical action id",
+      "required": false,
+      "type": "string",
+      "in": "query"
+    }, {
+      "name": "limit",
+      "description": "",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }, {
+      "name": "offset",
+      "description": "",
+      "required": false,
+      "type": "integer",
+      "in": "query"
+    }]
+  },
+  "get-usage-receipt": {
+    serviceClass: "Usage",
+    operationId: "getUsageReceipt",
+    description: "Returns a billing receipt for a completed generation: per-model line items (tokens, the price-book version that priced them, and cost) plus totals.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    pathParams: [],
+    queryParams: ["generation_id"],
+    flags: [{
+      "name": "generation_id",
+      "description": "Generation public ID",
+      "required": true,
+      "type": "string",
+      "in": "query"
+    }]
+  },
+  "get-price-book": {
+    serviceClass: "Usage",
+    operationId: "getPriceBook",
+    description: "Returns the global price book — the versioned per-provider/model unit prices used to compute usage cost at write time. Readable by any authenticated user.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    pathParams: [],
+    queryParams: [],
+    flags: []
+  },
+  "upsert-price-book": {
+    serviceClass: "Usage",
+    operationId: "upsertPriceBook",
+    description: "Upserts price rows keyed on (provider, model, effective_from). Admin only. `effective_from` must be in the future — past prices are immutable so recorded costs stay explainable; ship corrections as new future-dated rows.",
+    moduleDocsUrl: "https://soat.ttoss.dev/docs/modules/usage",
+    pathParams: [],
+    queryParams: [],
+    flags: [{
+      "name": "prices",
+      "description": "",
+      "required": true,
+      "type": "array",
+      "in": "body"
+    }]
+  },
   "get-current-user": {
     serviceClass: "Users",
     operationId: "getCurrentUser",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/cli",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "type": "module",
   "dependencies": {
     "@inquirer/input": "^5.1.2",
@@ -8,7 +8,7 @@
     "@ttoss/logger": "^0.8.19",
     "commander": "^15.0.0",
     "js-yaml": "^5.2.1",
-    "@soat/sdk": "0.14.2"
+    "@soat/sdk": "0.14.4"
   },
   "devDependencies": {
     "@ttoss/config": "^1.37.17",