@naturali/sdk 0.78.0 → 0.78.2

package/dist/index.cjs

@@ -634,7 +634,7 @@ var Actors = class {
 	/**
 	* List actors
 	*
-	* Returns all actors the caller has access to. If projectId is provided, returns only actors in that project. project keys are scoped to a single project automatically. JWT users without projectId receive actors across all their accessible projects.
+	* Returns all actors in the project named in the path.
 	*/
 	static listActors(options) {
 		return (options.client ?? client).get({
@@ -645,7 +645,7 @@ var Actors = class {
 	/**
 	* Create an actor
 	*
-	* Creates a new actor. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new actor in the project named in the path.
 	*/
 	static createActor(options) {
 		return (options.client ?? client).post({
@@ -1624,7 +1624,7 @@ var Conversations = class {
 	/**
 	* List conversations
 	*
-	* Returns all conversations the caller has access to. If projectId is provided, returns only conversations in that project. project keys are scoped to a single project automatically.
+	* Returns all conversations in the project named in the path.
 	*/
 	static listConversations(options) {
 		return (options.client ?? client).get({
@@ -1635,7 +1635,7 @@ var Conversations = class {
 	/**
 	* Create a conversation
 	*
-	* Creates a new conversation. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new conversation in the project named in the path.
 	*/
 	static createConversation(options) {
 		return (options.client ?? client).post({
@@ -1791,7 +1791,7 @@ var Documents = class {
 	/**
 	* List documents
 	*
-	* Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.
+	* Returns all documents in the project named in the path.
 	*/
 	static listDocuments(options) {
 		return (options.client ?? client).get({
@@ -1802,7 +1802,7 @@ var Documents = class {
 	/**
 	* Create a document
 	*
-	* Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.
 	*/
 	static createDocument(options) {
 		return (options.client ?? client).post({

package/dist/index.d.cts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;
@@ -16686,13 +16688,13 @@ declare class Actors {
   /**
    * List actors
    *
-   * Returns all actors the caller has access to. If projectId is provided, returns only actors in that project. project keys are scoped to a single project automatically. JWT users without projectId receive actors across all their accessible projects.
+   * Returns all actors in the project named in the path.
    */
   static listActors<ThrowOnError extends boolean = false>(options: Options<ListActorsData, ThrowOnError>): RequestResult<ListActorsResponses, ListActorsErrors, ThrowOnError>;
   /**
    * Create an actor
    *
-   * Creates a new actor. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new actor in the project named in the path.
    */
   static createActor<ThrowOnError extends boolean = false>(options: Options<CreateActorData, ThrowOnError>): RequestResult<CreateActorResponses, CreateActorErrors, ThrowOnError>;
   /**
@@ -17195,13 +17197,13 @@ declare class Conversations {
   /**
    * List conversations
    *
-   * Returns all conversations the caller has access to. If projectId is provided, returns only conversations in that project. project keys are scoped to a single project automatically.
+   * Returns all conversations in the project named in the path.
    */
   static listConversations<ThrowOnError extends boolean = false>(options: Options<ListConversationsData, ThrowOnError>): RequestResult<ListConversationsResponses, ListConversationsErrors, ThrowOnError>;
   /**
    * Create a conversation
    *
-   * Creates a new conversation. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new conversation in the project named in the path.
    */
   static createConversation<ThrowOnError extends boolean = false>(options: Options<CreateConversationData, ThrowOnError>): RequestResult<CreateConversationResponses, CreateConversationErrors, ThrowOnError>;
   /**
@@ -17278,13 +17280,13 @@ declare class Documents {
   /**
    * List documents
    *
-   * Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.
+   * Returns all documents in the project named in the path.
    */
   static listDocuments<ThrowOnError extends boolean = false>(options: Options<ListDocumentsData, ThrowOnError>): RequestResult<ListDocumentsResponses, ListDocumentsErrors, ThrowOnError>;
   /**
    * Create a document
    *
-   * Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.
    */
   static createDocument<ThrowOnError extends boolean = false>(options: Options<CreateDocumentData, ThrowOnError>): RequestResult<CreateDocumentResponses, CreateDocumentErrors, ThrowOnError>;
   /**

package/dist/index.d.mts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;
@@ -16686,13 +16688,13 @@ declare class Actors {
   /**
    * List actors
    *
-   * Returns all actors the caller has access to. If projectId is provided, returns only actors in that project. project keys are scoped to a single project automatically. JWT users without projectId receive actors across all their accessible projects.
+   * Returns all actors in the project named in the path.
    */
   static listActors<ThrowOnError extends boolean = false>(options: Options<ListActorsData, ThrowOnError>): RequestResult<ListActorsResponses, ListActorsErrors, ThrowOnError>;
   /**
    * Create an actor
    *
-   * Creates a new actor. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new actor in the project named in the path.
    */
   static createActor<ThrowOnError extends boolean = false>(options: Options<CreateActorData, ThrowOnError>): RequestResult<CreateActorResponses, CreateActorErrors, ThrowOnError>;
   /**
@@ -17195,13 +17197,13 @@ declare class Conversations {
   /**
    * List conversations
    *
-   * Returns all conversations the caller has access to. If projectId is provided, returns only conversations in that project. project keys are scoped to a single project automatically.
+   * Returns all conversations in the project named in the path.
    */
   static listConversations<ThrowOnError extends boolean = false>(options: Options<ListConversationsData, ThrowOnError>): RequestResult<ListConversationsResponses, ListConversationsErrors, ThrowOnError>;
   /**
    * Create a conversation
    *
-   * Creates a new conversation. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new conversation in the project named in the path.
    */
   static createConversation<ThrowOnError extends boolean = false>(options: Options<CreateConversationData, ThrowOnError>): RequestResult<CreateConversationResponses, CreateConversationErrors, ThrowOnError>;
   /**
@@ -17278,13 +17280,13 @@ declare class Documents {
   /**
    * List documents
    *
-   * Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.
+   * Returns all documents in the project named in the path.
    */
   static listDocuments<ThrowOnError extends boolean = false>(options: Options<ListDocumentsData, ThrowOnError>): RequestResult<ListDocumentsResponses, ListDocumentsErrors, ThrowOnError>;
   /**
    * Create a document
    *
-   * Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+   * Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.
    */
   static createDocument<ThrowOnError extends boolean = false>(options: Options<CreateDocumentData, ThrowOnError>): RequestResult<CreateDocumentResponses, CreateDocumentErrors, ThrowOnError>;
   /**

package/dist/index.mjs

@@ -633,7 +633,7 @@ var Actors = class {
 	/**
 	* List actors
 	*
-	* Returns all actors the caller has access to. If projectId is provided, returns only actors in that project. project keys are scoped to a single project automatically. JWT users without projectId receive actors across all their accessible projects.
+	* Returns all actors in the project named in the path.
 	*/
 	static listActors(options) {
 		return (options.client ?? client).get({
@@ -644,7 +644,7 @@ var Actors = class {
 	/**
 	* Create an actor
 	*
-	* Creates a new actor. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new actor in the project named in the path.
 	*/
 	static createActor(options) {
 		return (options.client ?? client).post({
@@ -1623,7 +1623,7 @@ var Conversations = class {
 	/**
 	* List conversations
 	*
-	* Returns all conversations the caller has access to. If projectId is provided, returns only conversations in that project. project keys are scoped to a single project automatically.
+	* Returns all conversations in the project named in the path.
 	*/
 	static listConversations(options) {
 		return (options.client ?? client).get({
@@ -1634,7 +1634,7 @@ var Conversations = class {
 	/**
 	* Create a conversation
 	*
-	* Creates a new conversation. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new conversation in the project named in the path.
 	*/
 	static createConversation(options) {
 		return (options.client ?? client).post({
@@ -1790,7 +1790,7 @@ var Documents = class {
 	/**
 	* List documents
 	*
-	* Returns all documents the caller has access to. If projectId is provided, returns only documents in that project. project keys are scoped to a single project automatically. JWT users without projectId receive documents across all their accessible projects.
+	* Returns all documents in the project named in the path.
 	*/
 	static listDocuments(options) {
 		return (options.client ?? client).get({
@@ -1801,7 +1801,7 @@ var Documents = class {
 	/**
 	* Create a document
 	*
-	* Creates a new text document and generates an embedding vector for semantic search. project keys automatically infer the project from the key's scope; JWT callers must supply projectId.
+	* Creates a new text document and generates an embedding vector for semantic search, in the project named in the path.
 	*/
 	static createDocument(options) {
 		return (options.client ?? client).post({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.78.0",
+  "version": "0.78.2",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.78.0"
+    "@naturali/api": "0.78.2"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",