@deepraxis/sdk 0.1.0-dev.48c1ce8 → 0.1.0-dev.4cbfc1f

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

@@ -1421,6 +1421,9 @@ export type OpenaiTraceConfig = {
     trace_name?: string;
     [key: string]: unknown;
 };
+/**
+ * Extra output data the request can ask for through include; each value adds one kind of detail to the response, such as file search results or encrypted reasoning content.
+ */
 export type OpenaiResponseIncludesEnum = 'file_search_call.results' | 'message.input_image.image_url' | 'computer_call_output.output.image_url' | 'reasoning.encrypted_content' | 'code_interpreter_call.outputs';
 /**
  * Input for a response request - can be a string or array of items
@@ -27279,9 +27282,9 @@ export type UnarchiveAgentResponses = {
          */
         version: number;
         /**
-         * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+         * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
          */
-        kind: 'personal' | 'business';
+        kind: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -27759,7 +27762,7 @@ export type ListEndUsersData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
     };
@@ -27838,7 +27841,7 @@ export type DeleteEndUserData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -27888,7 +27891,7 @@ export type GetEndUserData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -27974,7 +27977,7 @@ export type GetEndUserDeletionData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -28060,7 +28063,7 @@ export type RevokeEndUserTokensData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -28105,7 +28108,7 @@ export type BlockEndUserData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -28174,7 +28177,7 @@ export type UnblockEndUserData = {
     body?: never;
     path: {
         /**
-         * Active business agent identifier from agent creation or listing.
+         * Active service agent identifier from agent creation or listing.
          */
         agent_id: string;
         /**
@@ -28283,7 +28286,7 @@ export type ExchangeEmbedCodeResponse = ExchangeEmbedCodeResponses[keyof Exchang
 export type CreateAnonymousEmbedTokenData = {
     body: {
         /**
-         * Public key created by the business agent owner; safe to include in browser code.
+         * Public key created by the service agent owner; safe to include in browser code.
          */
         publishable_key: string;
         /**
@@ -28352,7 +28355,7 @@ export type ListEmbedTokensData = {
     path?: never;
     query?: {
         /**
-         * Filter by business agent identifier (agent_ or agt_ prefix).
+         * Filter by service agent identifier (agent_ or agt_ prefix).
          */
         agent_id?: string;
         /**
@@ -28406,7 +28409,7 @@ export type ListEmbedTokensResponses = {
              */
             type: 'embed_token';
             /**
-             * Business agent identifier.
+             * Service agent identifier.
              */
             agent_id: string;
             /**
@@ -28461,7 +28464,7 @@ export type CreateEmbedTokenData = {
          */
         hosted?: boolean;
         /**
-         * Business agent ID or identity_number from agent retrieval; it must belong to your organization and be active.
+         * Service agent ID or identity_number from agent retrieval; it must belong to your organization and be active.
          */
         agent: string;
         /**
@@ -28531,7 +28534,7 @@ export type CreateEmbedTokenErrors = {
      */
     403: unknown;
     /**
-     * The business agent or requested version is unavailable to this caller; check the agent identifier and version.
+     * The service agent or requested version is unavailable to this caller; check the agent identifier and version.
      */
     404: unknown;
     /**
@@ -28606,7 +28609,7 @@ export type RevokeEmbedTokenResponses = {
          */
         type: 'embed_token';
         /**
-         * Business agent identifier.
+         * Service agent identifier.
          */
         agent_id: string;
         /**
@@ -32960,7 +32963,7 @@ export type GetEmbedAppearanceErrors = {
      */
     401: unknown;
     /**
-     * The credential's business agent is absent or archived; obtain credentials for an active business agent.
+     * The credential's service agent is absent or archived; obtain credentials for an active service agent.
      */
     404: unknown;
     /**
@@ -41120,9 +41123,9 @@ export type AgentsListData = {
         limit?: number;
         page?: null | string;
         /**
-         * Personal agents use a durable computer; business agents use a clean environment per session.
+         * Personal agents use a durable computer; service agents use a clean environment per session.
          */
-        kind?: 'personal' | 'business';
+        kind?: 'personal' | 'service';
     };
     url: '/agent/v1/agents';
 };
@@ -41227,9 +41230,9 @@ export type AgentsListResponses = {
              */
             version: number;
             /**
-             * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+             * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
              */
-            kind: 'personal' | 'business';
+            kind: 'personal' | 'service';
             /**
              * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
              */
@@ -41679,9 +41682,9 @@ export type AgentsCreateData = {
          */
         tools?: Array<AgentManaged15 | AgentManaged29 | AgentManaged32>;
         /**
-         * Immutable agent kind. personal requires computer_id; business cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
+         * Immutable agent kind. personal requires computer_id; service cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
          */
-        kind?: 'personal' | 'business';
+        kind?: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined.
          */
@@ -42144,9 +42147,9 @@ export type AgentsCreateResponses = {
          */
         version: number;
         /**
-         * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+         * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
          */
-        kind: 'personal' | 'business';
+        kind: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -42624,9 +42627,9 @@ export type AgentsRetrieveResponses = {
          */
         version: number;
         /**
-         * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+         * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
          */
-        kind: 'personal' | 'business';
+        kind: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -43081,9 +43084,9 @@ export type AgentsUpdateData = {
          */
         version?: number;
         /**
-         * Immutable agent kind. personal requires computer_id; business cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
+         * Immutable agent kind. personal requires computer_id; service cannot bind a computer. Omit on create to infer from computer_id. On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
          */
-        kind?: 'personal' | 'business';
+        kind?: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined.
          */
@@ -43551,9 +43554,9 @@ export type AgentsUpdateResponses = {
          */
         version: number;
         /**
-         * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+         * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
          */
-        kind: 'personal' | 'business';
+        kind: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -44025,9 +44028,9 @@ export type AgentsArchiveResponses = {
          */
         version: number;
         /**
-         * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+         * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
          */
-        kind: 'personal' | 'business';
+        kind: 'personal' | 'service';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -44509,9 +44512,9 @@ export type AgentsVersionsListResponses = {
              */
             version: number;
             /**
-             * Immutable agent kind. personal uses a durable computer; business uses a clean environment per session. Historical agents infer kind from their computer binding.
+             * Immutable agent kind. personal uses a durable computer; service uses a clean environment per session. Historical agents infer kind from their computer binding.
              */
-            kind: 'personal' | 'business';
+            kind: 'personal' | 'service';
             /**
              * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
              */
@@ -54455,7 +54458,7 @@ export type DatabaseDeleteData = {
          */
         'Range-Unit'?: string;
         /**
-         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default uses field defaults for missing batch columns (otherwise NULL). Unknown preferences are ignored unless handling=strict (400 PGRST122).
+         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default skips null-filling of missing batch columns: inserts use field defaults (or null without a default), while conflict merges preserve omitted columns. Otherwise, holes in the batch key union are filled with null and can clear values during merge. Explicit null stays null. resolution=merge-duplicates updates supplied columns on conflict; resolution=ignore-duplicates leaves conflicting rows unchanged. Unknown preferences are ignored unless handling=strict (400 PGRST122).
          */
         Prefer?: string;
         /**
@@ -54479,7 +54482,7 @@ export type DatabaseDeleteData = {
          */
         select?: string;
         /**
-         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. See the filter operator matrix.
+         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. Supported operators: eq (equal), neq (not equal; ne is not supported), gt/gte/lt/lte (comparisons), like (case-sensitive text pattern), ilike (case-insensitive text pattern), in (membership), is (null/boolean test), cs (contains), cd (contained by), and ov (array overlap). For like/ilike, * or % matches any sequence and _ matches one character, e.g. title=ilike.*spring*; URL-encode a literal % as %25. Use days=in.(1,2,3), title=is.null, active=is.true or active=is.false; is.not_null and is.unknown are also accepted (unknown means null). Negate a condition with not., e.g. title=not.eq.draft. Multiple filters are ANDed; use or=(title.eq.a,title.eq.b), and=(days.gte.1,days.lte.3), not.or=(...) or not.and=(...), with nested and(...) and or(...) groups as needed. cs/cd accept JSON objects or arrays on JSON fields; cs also accepts a JSON scalar. For array values or multi-link fields, use cs.{a,b}, cd.{a,b} or ov.{a,b}. JSON paths use -> for JSON and ->> for text, e.g. attributes->>has_onsen=eq.true or attributes->tags=cs.[1,2]; chain -> segments and end with ->> for text. Dot paths such as attributes.has_onsen are unsupported. Full-text, regex, range operators and any/all modifiers are unsupported.
          */
         '{column}'?: string;
         /**
@@ -54511,7 +54514,7 @@ export type DatabaseDeleteData = {
          */
         offset?: number;
         /**
-         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
+         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. With resolution=merge-duplicates, a conflicting row keeps columns omitted from the request; supplied values replace the whole field value (including JSON objects), and explicit null clears a nullable field. With resolution=ignore-duplicates, a conflicting row is left unchanged. Without a conflict, both modes insert a new row using field defaults for omitted fields. In a batch, a key present in another row is filled with null when omitted in this row unless missing=default is set; that null can overwrite a value during merge. With missing=default, omitted keys stay omitted for conflict merges (existing values are preserved); new rows use defaults, or null when no default exists. Explicit null never invokes a default. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
          */
         on_conflict?: string;
         /**
@@ -54571,7 +54574,7 @@ export type DatabaseSelectData = {
          */
         'Range-Unit'?: string;
         /**
-         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default uses field defaults for missing batch columns (otherwise NULL). Unknown preferences are ignored unless handling=strict (400 PGRST122).
+         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default skips null-filling of missing batch columns: inserts use field defaults (or null without a default), while conflict merges preserve omitted columns. Otherwise, holes in the batch key union are filled with null and can clear values during merge. Explicit null stays null. resolution=merge-duplicates updates supplied columns on conflict; resolution=ignore-duplicates leaves conflicting rows unchanged. Unknown preferences are ignored unless handling=strict (400 PGRST122).
          */
         Prefer?: string;
         /**
@@ -54599,7 +54602,7 @@ export type DatabaseSelectData = {
          */
         select?: string;
         /**
-         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. See the filter operator matrix.
+         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. Supported operators: eq (equal), neq (not equal; ne is not supported), gt/gte/lt/lte (comparisons), like (case-sensitive text pattern), ilike (case-insensitive text pattern), in (membership), is (null/boolean test), cs (contains), cd (contained by), and ov (array overlap). For like/ilike, * or % matches any sequence and _ matches one character, e.g. title=ilike.*spring*; URL-encode a literal % as %25. Use days=in.(1,2,3), title=is.null, active=is.true or active=is.false; is.not_null and is.unknown are also accepted (unknown means null). Negate a condition with not., e.g. title=not.eq.draft. Multiple filters are ANDed; use or=(title.eq.a,title.eq.b), and=(days.gte.1,days.lte.3), not.or=(...) or not.and=(...), with nested and(...) and or(...) groups as needed. cs/cd accept JSON objects or arrays on JSON fields; cs also accepts a JSON scalar. For array values or multi-link fields, use cs.{a,b}, cd.{a,b} or ov.{a,b}. JSON paths use -> for JSON and ->> for text, e.g. attributes->>has_onsen=eq.true or attributes->tags=cs.[1,2]; chain -> segments and end with ->> for text. Dot paths such as attributes.has_onsen are unsupported. Full-text, regex, range operators and any/all modifiers are unsupported.
          */
         '{column}'?: string;
         /**
@@ -54631,7 +54634,7 @@ export type DatabaseSelectData = {
          */
         offset?: number;
         /**
-         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
+         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. With resolution=merge-duplicates, a conflicting row keeps columns omitted from the request; supplied values replace the whole field value (including JSON objects), and explicit null clears a nullable field. With resolution=ignore-duplicates, a conflicting row is left unchanged. Without a conflict, both modes insert a new row using field defaults for omitted fields. In a batch, a key present in another row is filled with null when omitted in this row unless missing=default is set; that null can overwrite a value during merge. With missing=default, omitted keys stay omitted for conflict merges (existing values are preserved); new rows use defaults, or null when no default exists. Explicit null never invokes a default. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
          */
         on_conflict?: string;
         /**
@@ -54691,7 +54694,7 @@ export type DatabaseHeadData = {
          */
         'Range-Unit'?: string;
         /**
-         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default uses field defaults for missing batch columns (otherwise NULL). Unknown preferences are ignored unless handling=strict (400 PGRST122).
+         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default skips null-filling of missing batch columns: inserts use field defaults (or null without a default), while conflict merges preserve omitted columns. Otherwise, holes in the batch key union are filled with null and can clear values during merge. Explicit null stays null. resolution=merge-duplicates updates supplied columns on conflict; resolution=ignore-duplicates leaves conflicting rows unchanged. Unknown preferences are ignored unless handling=strict (400 PGRST122).
          */
         Prefer?: string;
         /**
@@ -54719,7 +54722,7 @@ export type DatabaseHeadData = {
          */
         select?: string;
         /**
-         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. See the filter operator matrix.
+         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. Supported operators: eq (equal), neq (not equal; ne is not supported), gt/gte/lt/lte (comparisons), like (case-sensitive text pattern), ilike (case-insensitive text pattern), in (membership), is (null/boolean test), cs (contains), cd (contained by), and ov (array overlap). For like/ilike, * or % matches any sequence and _ matches one character, e.g. title=ilike.*spring*; URL-encode a literal % as %25. Use days=in.(1,2,3), title=is.null, active=is.true or active=is.false; is.not_null and is.unknown are also accepted (unknown means null). Negate a condition with not., e.g. title=not.eq.draft. Multiple filters are ANDed; use or=(title.eq.a,title.eq.b), and=(days.gte.1,days.lte.3), not.or=(...) or not.and=(...), with nested and(...) and or(...) groups as needed. cs/cd accept JSON objects or arrays on JSON fields; cs also accepts a JSON scalar. For array values or multi-link fields, use cs.{a,b}, cd.{a,b} or ov.{a,b}. JSON paths use -> for JSON and ->> for text, e.g. attributes->>has_onsen=eq.true or attributes->tags=cs.[1,2]; chain -> segments and end with ->> for text. Dot paths such as attributes.has_onsen are unsupported. Full-text, regex, range operators and any/all modifiers are unsupported.
          */
         '{column}'?: string;
         /**
@@ -54751,7 +54754,7 @@ export type DatabaseHeadData = {
          */
         offset?: number;
         /**
-         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
+         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. With resolution=merge-duplicates, a conflicting row keeps columns omitted from the request; supplied values replace the whole field value (including JSON objects), and explicit null clears a nullable field. With resolution=ignore-duplicates, a conflicting row is left unchanged. Without a conflict, both modes insert a new row using field defaults for omitted fields. In a batch, a key present in another row is filled with null when omitted in this row unless missing=default is set; that null can overwrite a value during merge. With missing=default, omitted keys stay omitted for conflict merges (existing values are preserved); new rows use defaults, or null when no default exists. Explicit null never invokes a default. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
          */
         on_conflict?: string;
         /**
@@ -54812,7 +54815,7 @@ export type DatabaseUpdateData = {
          */
         'Range-Unit'?: string;
         /**
-         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default uses field defaults for missing batch columns (otherwise NULL). Unknown preferences are ignored unless handling=strict (400 PGRST122).
+         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default skips null-filling of missing batch columns: inserts use field defaults (or null without a default), while conflict merges preserve omitted columns. Otherwise, holes in the batch key union are filled with null and can clear values during merge. Explicit null stays null. resolution=merge-duplicates updates supplied columns on conflict; resolution=ignore-duplicates leaves conflicting rows unchanged. Unknown preferences are ignored unless handling=strict (400 PGRST122).
          */
         Prefer?: string;
         /**
@@ -54836,7 +54839,7 @@ export type DatabaseUpdateData = {
          */
         select?: string;
         /**
-         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. See the filter operator matrix.
+         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. Supported operators: eq (equal), neq (not equal; ne is not supported), gt/gte/lt/lte (comparisons), like (case-sensitive text pattern), ilike (case-insensitive text pattern), in (membership), is (null/boolean test), cs (contains), cd (contained by), and ov (array overlap). For like/ilike, * or % matches any sequence and _ matches one character, e.g. title=ilike.*spring*; URL-encode a literal % as %25. Use days=in.(1,2,3), title=is.null, active=is.true or active=is.false; is.not_null and is.unknown are also accepted (unknown means null). Negate a condition with not., e.g. title=not.eq.draft. Multiple filters are ANDed; use or=(title.eq.a,title.eq.b), and=(days.gte.1,days.lte.3), not.or=(...) or not.and=(...), with nested and(...) and or(...) groups as needed. cs/cd accept JSON objects or arrays on JSON fields; cs also accepts a JSON scalar. For array values or multi-link fields, use cs.{a,b}, cd.{a,b} or ov.{a,b}. JSON paths use -> for JSON and ->> for text, e.g. attributes->>has_onsen=eq.true or attributes->tags=cs.[1,2]; chain -> segments and end with ->> for text. Dot paths such as attributes.has_onsen are unsupported. Full-text, regex, range operators and any/all modifiers are unsupported.
          */
         '{column}'?: string;
         /**
@@ -54868,7 +54871,7 @@ export type DatabaseUpdateData = {
          */
         offset?: number;
         /**
-         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
+         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. With resolution=merge-duplicates, a conflicting row keeps columns omitted from the request; supplied values replace the whole field value (including JSON objects), and explicit null clears a nullable field. With resolution=ignore-duplicates, a conflicting row is left unchanged. Without a conflict, both modes insert a new row using field defaults for omitted fields. In a batch, a key present in another row is filled with null when omitted in this row unless missing=default is set; that null can overwrite a value during merge. With missing=default, omitted keys stay omitted for conflict merges (existing values are preserved); new rows use defaults, or null when no default exists. Explicit null never invokes a default. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
          */
         on_conflict?: string;
         /**
@@ -54932,7 +54935,7 @@ export type DatabaseInsertData = {
          */
         'Range-Unit'?: string;
         /**
-         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default uses field defaults for missing batch columns (otherwise NULL). Unknown preferences are ignored unless handling=strict (400 PGRST122).
+         * Comma-separated preferences. count=exact|planned|estimated: unfiltered counts are exact; filtered planned reports *, estimated falls back to * when predicted over budget. missing=default skips null-filling of missing batch columns: inserts use field defaults (or null without a default), while conflict merges preserve omitted columns. Otherwise, holes in the batch key union are filled with null and can clear values during merge. Explicit null stays null. resolution=merge-duplicates updates supplied columns on conflict; resolution=ignore-duplicates leaves conflicting rows unchanged. Unknown preferences are ignored unless handling=strict (400 PGRST122).
          */
         Prefer?: string;
         /**
@@ -54956,7 +54959,7 @@ export type DatabaseInsertData = {
          */
         select?: string;
         /**
-         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. See the filter operator matrix.
+         * Horizontal filter: replace {column} with a field name or JSON path, e.g. title=eq.summary. Repeat for more columns. Supported operators: eq (equal), neq (not equal; ne is not supported), gt/gte/lt/lte (comparisons), like (case-sensitive text pattern), ilike (case-insensitive text pattern), in (membership), is (null/boolean test), cs (contains), cd (contained by), and ov (array overlap). For like/ilike, * or % matches any sequence and _ matches one character, e.g. title=ilike.*spring*; URL-encode a literal % as %25. Use days=in.(1,2,3), title=is.null, active=is.true or active=is.false; is.not_null and is.unknown are also accepted (unknown means null). Negate a condition with not., e.g. title=not.eq.draft. Multiple filters are ANDed; use or=(title.eq.a,title.eq.b), and=(days.gte.1,days.lte.3), not.or=(...) or not.and=(...), with nested and(...) and or(...) groups as needed. cs/cd accept JSON objects or arrays on JSON fields; cs also accepts a JSON scalar. For array values or multi-link fields, use cs.{a,b}, cd.{a,b} or ov.{a,b}. JSON paths use -> for JSON and ->> for text, e.g. attributes->>has_onsen=eq.true or attributes->tags=cs.[1,2]; chain -> segments and end with ->> for text. Dot paths such as attributes.has_onsen are unsupported. Full-text, regex, range operators and any/all modifiers are unsupported.
          */
         '{column}'?: string;
         /**
@@ -54988,7 +54991,7 @@ export type DatabaseInsertData = {
          */
         offset?: number;
         /**
-         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
+         * POST upsert: id or one unique field with resolution=merge-duplicates|ignore-duplicates. With resolution=merge-duplicates, a conflicting row keeps columns omitted from the request; supplied values replace the whole field value (including JSON objects), and explicit null clears a nullable field. With resolution=ignore-duplicates, a conflicting row is left unchanged. Without a conflict, both modes insert a new row using field defaults for omitted fields. In a batch, a key present in another row is filled with null when omitted in this row unless missing=default is set; that null can overwrite a value during merge. With missing=default, omitted keys stay omitted for conflict merges (existing values are preserved); new rows use defaults, or null when no default exists. Explicit null never invokes a default. POST accepts an optional client id matching [A-Za-z0-9_-]{1,64}; omitted ids are generated. PATCH cannot change id.
          */
         on_conflict?: string;
         /**

package/dist/helpers/database-count.d.ts

@@ -0,0 +1,17 @@
+import type { Transport } from '../core/transport.js';
+export interface CountInput {
+    /** Database ID from database list/create; not its display name. */
+    database_id: string;
+    /** Existing table name or ID from the database table APIs. */
+    table: string;
+    /** PostgREST query filters, as in databaseSelect; omitted means all rows. */
+    filters?: Record<string, string>;
+    /** exact counts within budget (default); filtered planned returns null; estimated may return null over budget. Unfiltered counts are exact in every mode. */
+    count?: 'exact' | 'planned' | 'estimated';
+}
+export interface CountResult {
+    /** Matching total, or null when the server reports an unknown total. */
+    count: number | null;
+}
+/** Count matching rows without retrieving row data. */
+export declare function count(transport: Pick<Transport, 'requestWithResponse'>, input: CountInput): Promise<CountResult>;

package/dist/helpers/database-count.js

@@ -0,0 +1,11 @@
+import { databaseHead } from "../generated/sdk.gen.js";
+/** Count matching rows without retrieving row data. */
+export async function count(transport, input) {
+    const { response } = await transport.requestWithResponse(databaseHead, {
+        path: { database_id: input.database_id, table: input.table },
+        query: input.filters,
+        headers: { Prefer: `count=${input.count ?? 'exact'}` },
+    });
+    const total = response.headers.get('Content-Range')?.split('/')[1];
+    return { count: total === undefined || total === '*' ? null : Number(total) };
+}

package/dist/index.d.ts

@@ -7,3 +7,5 @@ export { parseSSE } from './core/sse.js';
 export type { SSEEvent, SSEOptions } from './core/sse.js';
 export { publish } from './helpers/application-publish.js';
 export type { PublishInput, PublishResult, AssetsConfig } from './helpers/application-publish.js';
+export { count } from './helpers/database-count.js';
+export type { CountInput, CountResult } from './helpers/database-count.js';

package/dist/index.js

@@ -3,3 +3,4 @@ export { PraxisError, PraxisConnectionError, PraxisTimeoutError } from "./core/e
 export { Page } from "./core/pagination.js";
 export { parseSSE } from "./core/sse.js";
 export { publish } from "./helpers/application-publish.js";
+export { count } from "./helpers/database-count.js";