@soat/sdk 0.45.0 → 0.47.0

package/dist/index.mjs

@@ -2630,7 +2630,7 @@ var Knowledge = class {
 	/**
 	* Search knowledge
 	*
-	* Searches across documents and memory entries using semantic search, file paths, document IDs, or memory IDs/tags. At least one of `query`, `document_paths`, `document_ids`, `memory_ids`, or `memory_tags` must be provided.
+	* Searches across documents and memory entries using semantic search, file paths, document IDs, memory IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_ids` must be provided.
 	*/
 	static searchKnowledge(options) {
 		return (options.client ?? client).post({
@@ -2707,6 +2707,47 @@ var Memories = class {
 			}
 		});
 	}
+	/**
+	* Get memory tags
+	*
+	* Returns all tags attached to the memory
+	*/
+	static getMemoryTags(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/memories/{memory_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge memory tags
+	*
+	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeMemoryTags(options) {
+		return (options.client ?? client).patch({
+			url: "/api/v1/memories/{memory_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace memory tags
+	*
+	* Replaces all tags on the memory with the provided tags (not merged)
+	*/
+	static replaceMemoryTags(options) {
+		return (options.client ?? client).put({
+			url: "/api/v1/memories/{memory_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var MemoryEntries = class {
 	/**
@@ -2772,6 +2813,47 @@ var MemoryEntries = class {
 			}
 		});
 	}
+	/**
+	* Get memory entry tags
+	*
+	* Returns all tags attached to the memory entry
+	*/
+	static getMemoryEntryTags(options) {
+		return (options.client ?? client).get({
+			url: "/api/v1/memory-entries/{entry_id}/tags",
+			...options
+		});
+	}
+	/**
+	* Merge memory entry tags
+	*
+	* Merges provided tags with existing tags (existing tags are preserved unless overridden)
+	*/
+	static mergeMemoryEntryTags(options) {
+		return (options.client ?? client).patch({
+			url: "/api/v1/memory-entries/{entry_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Replace memory entry tags
+	*
+	* Replaces all tags on the memory entry with the provided tags (not merged)
+	*/
+	static replaceMemoryEntryTags(options) {
+		return (options.client ?? client).put({
+			url: "/api/v1/memory-entries/{entry_id}/tags",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var ModelRoutes = class {
 	/**
@@ -3415,7 +3497,7 @@ var Sessions = class {
 	/**
 	* Get a session
 	*
-	* Returns details of a single session.
+	* Returns details of a single session, including a `usage` roll-up of what its generations cost. The listing omits `usage`; for a window, a split by day or model, or one end user across every session, narrow the usage aggregate with `session_id` / `actor_id` instead.
 	*/
 	static getSession(options) {
 		return (options.client ?? client).get({
@@ -3946,7 +4028,9 @@ var Usage = class {
 	/**
 	* List usage events
 	*
-	* Returns the raw usage events the caller can access, most recent first, optionally filtered by agent, generation, trace, actor, session, or `source`. Each event is the per-generation token usage as reported by the provider, for audit and reconciliation.
+	* Returns the raw usage events the caller can access, most recent first, narrowed by any combination of the same filters the aggregate takes — agent, generation, trace, actor, session, AI provider, orchestration run, orchestration, trigger, action, meter type, model or `source` — so a rollup and the events behind it are addressed the same way. Each event is the per-generation token usage as reported by the provider, for audit and reconciliation.
+	*
+	* An id naming nothing in scope yields an empty page rather than dropping the filter, so a mistyped narrowing can never widen the list past what was asked for.
 	*
 	*/
 	static listUsageEvents(options) {
@@ -3958,9 +4042,11 @@ var Usage = class {
 	/**
 	* Get aggregated usage for a project
 	*
-	* 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 usage events client-side.
+	* Returns a project's usage rolled up over an optional `[from, to]` time window, optionally bucketed by a single dimension and narrowed by any combination of thirteen filters — session, actor, agent, AI provider, orchestration run, orchestration, generation, trace, meter type, model, source, trigger and action. That is how "what did this conversation cost", "what has this end user cost" and "what did this agent cost" are answered. 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 usage events client-side.
+	*
+	* Narrowings intersect and apply to the whole rollup — every bucket, `totals` and `totals.distinct` alike — so each composes with any `group_by`, and all thirteen are echoed back under `filters`. The eight naming a resource are resolved against the project, and one naming nothing there empties the rollup rather than being dropped: a mistyped id must never read back as the project's whole spend. The other five are matched against the value the event recorded.
 	*
-	* `groups` is paginated. Its `total` is the number of distinct buckets in the window — bucket cardinality, including a null bucket for the events the dimension does not apply to, and never a count of entities. To count entities, send `include=distinct` and read `totals.distinct`. `totals` always describes the whole window — never the page above it.
+	* `groups` is paginated. Its `total` is the number of distinct buckets in the window — bucket cardinality, including a null bucket for the events the dimension does not apply to, and never a count of entities. To count entities, send `include=distinct` and read `totals.distinct`. `totals` always describes the whole window — never the page above it, and never the bucketing: omit `group_by` and `totals` is unchanged while `groups` is empty.
 	*
 	*/
 	static getUsageAggregate(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "TypeScript SDK for SOAT — open-source infrastructure for production-ready AI agents.",
   "keywords": [
     "ai-agents",