@deepraxis/sdk 0.1.1-dev.b176367 → 0.1.1-dev.d25d171

package/dist/generated/sdk.gen.d.ts

@@ -102,7 +102,7 @@ export declare const unblockEndUser: <ThrowOnError extends boolean = false>(opti
  *
  * Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.
  *
- * Call this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget_cents, system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {"customer_id":"cus_8f2a91","origin":"https://shop.example.com"}.
+ * Call this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget (US dollars, at most 2 decimals), system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {"customer_id":"cus_8f2a91","origin":"https://shop.example.com"}.
  */
 export declare const createCustomerGrantCode: <ThrowOnError extends boolean = false>(options: Options<CreateCustomerGrantCodeData, ThrowOnError>) => RequestResult<CreateCustomerGrantCodeResponses, CreateCustomerGrantCodeErrors, ThrowOnError>;
 /**

package/dist/generated/sdk.gen.js

@@ -226,7 +226,7 @@ export const unblockEndUser = (options) => (options.client ?? client).post({
  *
  * Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.
  *
- * Call this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget_cents, system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {"customer_id":"cus_8f2a91","origin":"https://shop.example.com"}.
+ * Call this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget (US dollars, at most 2 decimals), system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {"customer_id":"cus_8f2a91","origin":"https://shop.example.com"}.
  */
 export const createCustomerGrantCode = (options) => (options.client ?? client).post({
     security: [{

package/dist/generated/types.gen.d.ts

@@ -4215,7 +4215,7 @@ export type AgentManaged57 = {
     type: 'custom';
 };
 /**
- * Session spending limit, {type: "limit", max_list_cost: {amount, currency}}; null when unlimited. Creation defaults to a limit of 2000 US cents (USD 20.00) when omitted. amount is a positive integer string of US cents; removing the limit with null prevents setting it again for that session.
+ * Session spending limit, {type: "limit", max_list_cost: {amount, currency}}; null when unlimited. amount is in US dollars: send an integer or up to 2 decimals ("0.50"), and responses carry exactly 2 decimals ("20.00"). Creation defaults to USD 20.00 when omitted. More decimals, zero or a number return 400. Removing the limit with null prevents setting it again for that session.
  */
 export type AgentManaged76 = {
     /**
@@ -4408,6 +4408,19 @@ export type AgentManaged179 = {
      * Cumulative count of server-executed tool invocations, broken down by tool.
      */
     server_tool_use?: null | AgentManaged181;
+    /**
+     * Praxis extension: priced runtime of this session (the time it was running), billed separately from list_cost and not counted against the budget. amount is in US dollars as a decimal string with exactly 6 decimals, e.g. "0.000280". Each thread's runtime is reported on that thread. /agent/v1 only.
+     */
+    runtime_cost?: {
+        /**
+         * Runtime cost in US dollars, decimal string with exactly 6 decimals.
+         */
+        amount: string;
+        /**
+         * Always USD.
+         */
+        currency: 'USD';
+    };
 };
 export type AgentManaged183 = {
     [key: string]: null | string;
@@ -18102,11 +18115,11 @@ export type AgentManaged33 = {
     [key: string]: unknown;
 };
 /**
- * Largest list-price cost the session may reach, as {amount, currency}. amount is a string of US cents, not dollars.
+ * Largest list-price cost the session may reach, as {amount, currency}. amount is in US dollars with at most 2 decimals, not cents.
  */
 export type AgentManaged77 = {
     /**
-     * Cost ceiling in US cents, as a positive integer string with no leading zeros: "2000" is USD 20.00 and "50" is fifty cents. Decimals and JSON numbers return 400.
+     * Amount in US dollars as a decimal string. Costs (usage.list_cost) carry exactly 6 decimals, e.g. "0.000345"; budgets (budget.max_list_cost) carry exactly 2 decimals, e.g. "20.00", and accept an integer or up to 2 decimals on input.
      */
     amount: string;
     /**
@@ -29819,9 +29832,18 @@ export type ListEndUsersResponses = {
              */
             session_count: number;
             /**
-             * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+             * Accumulated recorded cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
              */
-            cost_micro_usd: number;
+            cost: {
+                /**
+                 * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
+                 */
+                amount: string;
+                /**
+                 * Always USD.
+                 */
+                currency: 'USD';
+            };
             /**
              * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
              */
@@ -29945,9 +29967,18 @@ export type GetEndUserResponses = {
          */
         session_count: number;
         /**
-         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         * Accumulated recorded cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
          */
-        cost_micro_usd: number;
+        cost: {
+            /**
+             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
+             */
+            amount: string;
+            /**
+             * Always USD.
+             */
+            currency: 'USD';
+        };
         /**
          * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
          */
@@ -30185,9 +30216,18 @@ export type BlockEndUserResponses = {
          */
         session_count: number;
         /**
-         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         * Accumulated recorded cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
          */
-        cost_micro_usd: number;
+        cost: {
+            /**
+             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
+             */
+            amount: string;
+            /**
+             * Always USD.
+             */
+            currency: 'USD';
+        };
         /**
          * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
          */
@@ -30255,9 +30295,18 @@ export type UnblockEndUserResponses = {
          */
         session_count: number;
         /**
-         * Accumulated recorded session cost in millionths of a US dollar; zero when no cost has been recorded.
+         * Accumulated recorded cost of this customer's sessions on this agent: model usage (threads included) plus session runtime; amount "0.000000" when nothing has been recorded.
          */
-        cost_micro_usd: number;
+        cost: {
+            /**
+             * Amount in US dollars, as a decimal string with exactly 6 decimals and no exponent, e.g. "0.000345" or "12.500000".
+             */
+            amount: string;
+            /**
+             * Always USD.
+             */
+            currency: 'USD';
+        };
         /**
          * Whether the embed policy currently prevents this user from receiving tokens and creating sessions.
          */
@@ -30276,9 +30325,27 @@ export type CreateCustomerGrantCodeData = {
          */
         version?: number;
         /**
-         * Budget in cents for each session the customer starts. Defaults to the embed policy session budget and cannot exceed its maximum.
+         * Budget for each session the customer starts, in the same shape as a session budget. Defaults to the embed policy session budget and cannot exceed its maximum.
          */
-        budget_cents?: number;
+        budget?: {
+            /**
+             * Budget kind; always limit.
+             */
+            type: 'limit';
+            /**
+             * Spending limit of each session the customer starts.
+             */
+            max_list_cost: {
+                /**
+                 * Largest list cost of each session, in US dollars, as a decimal string with at most 2 fraction digits, e.g. "0.50". "0" lets the customer sign in without spending.
+                 */
+                amount: string;
+                /**
+                 * Always USD.
+                 */
+                currency: 'USD';
+            };
+        };
         /**
          * Optional context the agent receives at the start of each session, as text blocks, limited to 8192 UTF-8 bytes in total.
          */
@@ -36159,6 +36226,19 @@ export type ForkSessionResponses = {
                  */
                 web_search_requests?: number;
             };
+            /**
+             * Praxis extension: priced runtime of this session (the time it was running), billed separately from list_cost and not counted against the budget. amount is in US dollars as a decimal string with exactly 6 decimals, e.g. "0.000280". Each thread's runtime is reported on that thread. /agent/v1 only.
+             */
+            runtime_cost?: {
+                /**
+                 * Runtime cost in US dollars, decimal string with exactly 6 decimals.
+                 */
+                amount: string;
+                /**
+                 * Always USD.
+                 */
+                currency: 'USD';
+            };
         };
         /**
          * Vault IDs attached to the session at creation. Empty when no vaults were

package/dist/operations.generated.d.ts

@@ -406,7 +406,7 @@ export declare const operations: readonly [{
     readonly resource: "agent.agents.customers.auth.grantCodes";
     readonly method: "create";
     readonly summary: "Create customer grant code";
-    readonly description: "Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.\n\nCall this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget_cents, system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {\"customer_id\":\"cus_8f2a91\",\"origin\":\"https://shop.example.com\"}.";
+    readonly description: "Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.\n\nCall this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget (US dollars, at most 2 decimals), system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {\"customer_id\":\"cus_8f2a91\",\"origin\":\"https://shop.example.com\"}.";
     readonly http: "POST";
     readonly path: "/agent/v1/agents/{agent_id}/customers/auth/grant_codes";
     readonly streaming: "no";
@@ -430,10 +430,10 @@ export declare const operations: readonly [{
             readonly required: false;
             readonly description: "Existing agent version that every token of this sign-in pins. Defaults to the agent's active_version when the code is issued.";
         }, {
-            readonly name: "budget_cents";
-            readonly type: "integer";
+            readonly name: "budget";
+            readonly type: "object";
             readonly required: false;
-            readonly description: "Budget in cents for each session the customer starts. Defaults to the embed policy session budget and cannot exceed its maximum.";
+            readonly description: "Budget for each session the customer starts, in the same shape as a session budget. Defaults to the embed policy session budget and cannot exceed its maximum.";
         }, {
             readonly name: "system_message";
             readonly type: "array";
@@ -1692,7 +1692,7 @@ export declare const operations: readonly [{
             readonly name: "budget";
             readonly type: "object";
             readonly required: false;
-            readonly description: "Session spending limit, {type: \"limit\", max_list_cost: {amount, currency}}; null when unlimited. Creation defaults to a limit of 2000 US cents (USD 20.00) when omitted. amount is a positive integer string of US cents; removing the limit with null prevents setting it again for that session.";
+            readonly description: "Session spending limit, {type: \"limit\", max_list_cost: {amount, currency}}; null when unlimited. amount is in US dollars: send an integer or up to 2 decimals (\"0.50\"), and responses carry exactly 2 decimals (\"20.00\"). Creation defaults to USD 20.00 when omitted. More decimals, zero or a number return 400. Removing the limit with null prevents setting it again for that session.";
         }, {
             readonly name: "initial_events";
             readonly type: "array";

package/dist/operations.generated.js

@@ -504,7 +504,7 @@ export const operations = [
         "resource": "agent.agents.customers.auth.grantCodes",
         "method": "create",
         "summary": "Create customer grant code",
-        "description": "Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.\n\nCall this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget_cents, system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {\"customer_id\":\"cus_8f2a91\",\"origin\":\"https://shop.example.com\"}.",
+        "description": "Sign your logged-in customer in to a service agent from your backend with a one-time grant code that Agent Kit exchanges for a customer access token.\n\nCall this from your backend with your API key after your own login succeeds, then pass the returned code to Agent Kit in the browser; never call it from the browser. Customer authorization follows Shopify Storefront customer access tokens (Multipass-style sign-in, a short-lived token, renewal and logout), so that experience applies. customer_id is your own identifier for the customer: use an opaque id such as your database user id, not an email address or phone number. The value auth is reserved, and ids starting with anon_ are reserved for anonymous customers. The code works once and expires after expires_in seconds (default 900). The sign-in it starts lasts max_session_seconds (default 7 days); version, budget (US dollars, at most 2 decimals), system_message, agent_override and metadata apply to every token of the sign-in. Unlike Shopify, origin binds the whole sign-in to one page origin, and anonymous_access_token merges the conversations of the anonymous visitor who chatted before signing in into this customer. Example body: {\"customer_id\":\"cus_8f2a91\",\"origin\":\"https://shop.example.com\"}.",
         "http": "POST",
         "path": "/agent/v1/agents/{agent_id}/customers/auth/grant_codes",
         "streaming": "no",
@@ -533,10 +533,10 @@ export const operations = [
                     "description": "Existing agent version that every token of this sign-in pins. Defaults to the agent's active_version when the code is issued."
                 },
                 {
-                    "name": "budget_cents",
-                    "type": "integer",
+                    "name": "budget",
+                    "type": "object",
                     "required": false,
-                    "description": "Budget in cents for each session the customer starts. Defaults to the embed policy session budget and cannot exceed its maximum."
+                    "description": "Budget for each session the customer starts, in the same shape as a session budget. Defaults to the embed policy session budget and cannot exceed its maximum."
                 },
                 {
                     "name": "system_message",
@@ -2076,7 +2076,7 @@ export const operations = [
                     "name": "budget",
                     "type": "object",
                     "required": false,
-                    "description": "Session spending limit, {type: \"limit\", max_list_cost: {amount, currency}}; null when unlimited. Creation defaults to a limit of 2000 US cents (USD 20.00) when omitted. amount is a positive integer string of US cents; removing the limit with null prevents setting it again for that session."
+                    "description": "Session spending limit, {type: \"limit\", max_list_cost: {amount, currency}}; null when unlimited. amount is in US dollars: send an integer or up to 2 decimals (\"0.50\"), and responses carry exactly 2 decimals (\"20.00\"). Creation defaults to USD 20.00 when omitted. More decimals, zero or a number return 400. Removing the limit with null prevents setting it again for that session."
                 },
                 {
                     "name": "initial_events",

package/dist/resources.generated.d.ts

@@ -360,7 +360,10 @@ export declare function createAgent(transport: Transport): {
                     first_seen_at: string | null;
                     last_active_at: string | null;
                     session_count: number;
-                    cost_micro_usd: number;
+                    cost: {
+                        amount: string;
+                        currency: "USD";
+                    };
                     blocked: boolean;
                 }>;
             };
@@ -374,7 +377,10 @@ export declare function createAgent(transport: Transport): {
                     first_seen_at: string | null;
                     last_active_at: string | null;
                     session_count: number;
-                    cost_micro_usd: number;
+                    cost: {
+                        amount: string;
+                        currency: "USD";
+                    };
                     blocked: boolean;
                 }>;
                 next_page: string | null;
@@ -384,7 +390,10 @@ export declare function createAgent(transport: Transport): {
                 first_seen_at: string | null;
                 last_active_at: string | null;
                 session_count: number;
-                cost_micro_usd: number;
+                cost: {
+                    amount: string;
+                    currency: "USD";
+                };
                 blocked: boolean;
                 recent_sessions: Array<{
                     id: string;
@@ -420,7 +429,10 @@ export declare function createAgent(transport: Transport): {
                     first_seen_at: string | null;
                     last_active_at: string | null;
                     session_count: number;
-                    cost_micro_usd: number;
+                    cost: {
+                        amount: string;
+                        currency: "USD";
+                    };
                     blocked: boolean;
                 }>;
             };
@@ -3213,6 +3225,10 @@ export declare function createAgent(transport: Transport): {
                     web_fetch_requests?: number;
                     web_search_requests?: number;
                 };
+                runtime_cost?: {
+                    amount: string;
+                    currency: "USD";
+                };
             };
             vault_ids: Array<string>;
             deployment_id?: null | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/sdk",
-  "version": "0.1.1-dev.b176367",
+  "version": "0.1.1-dev.d25d171",
   "type": "module",
   "sideEffects": false,
   "exports": {