@augno/sdk 0.7.0 → 0.9.0

package/src/resources/catalog/unit-groups/unit-groups.ts

@@ -28,6 +28,8 @@ export class UnitGroups extends APIResource {
   /**
    * Returns a paginated list of unit groups, including system unit groups.
    *
+   * This endpoint requires the permission: `unit_groups:read`.
+   *
    * @example
    * ```ts
    * const listUnitGroup =
@@ -44,6 +46,8 @@ export class UnitGroups extends APIResource {
   /**
    * Returns a unit group by ID.
    *
+   * This endpoint requires the permission: `unit_groups:read`.
+   *
    * @example
    * ```ts
    * const unitGroup = await client.catalog.unitGroups.retrieve(
@@ -62,6 +66,8 @@ export class UnitGroups extends APIResource {
   /**
    * Creates a unit group with optional associated units.
    *
+   * This endpoint requires the permission: `unit_groups:create`.
+   *
    * @example
    * ```ts
    * const unitGroup = await client.catalog.unitGroups.create({
@@ -76,6 +82,8 @@ export class UnitGroups extends APIResource {
    *       customer_portal_visibility: 'visible',
    *     },
    *   ],
+   *   notes:
+   *     'Used for raw-material weight tracking across the warehouse.',
    * });
    * ```
    */
@@ -87,13 +95,24 @@ export class UnitGroups extends APIResource {
   /**
    * Partially updates a unit group. System unit groups cannot be updated.
    *
+   * This endpoint requires the permission: `unit_groups:update`.
+   *
    * @example
    * ```ts
    * const unitGroup = await client.catalog.unitGroups.update(
    *   'ug_01aad07abb8e41fd392d2d7013',
    *   {
+   *     associated_units: [
+   *       {
+   *         unit_id: 'un_01966263f74a5a0cae356000a1',
+   *         discount_percentage: 1,
+   *         discount_fixed: 0,
+   *         customer_portal_visibility: 'visible',
+   *       },
+   *     ],
    *     base_unit_id: 'un_01966263f74a5a0cae356000a1',
    *     name: 'Weight Units (Updated)',
+   *     notes: 'Added kilogram association for metric orders.',
    *   },
    * );
    * ```
@@ -108,8 +127,10 @@ export class UnitGroups extends APIResource {
   }
 
   /**
-   * Deletes a unit group and all associated unit conversions. System unit groups
-   * cannot be deleted.
+   * Deletes a unit group and all of its associated units. System unit groups cannot
+   * be deleted.
+   *
+   * This endpoint requires the permission: `unit_groups:delete`.
    *
    * @example
    * ```ts
@@ -140,7 +161,7 @@ export interface CreateUnitGroupRequest {
   name: string;
 
   /**
-   * Dimension shared by every unit in this group (e.g. `mass`, `volume`).
+   * Dimension shared by every unit in this group.
    *
    * All associated units must be of this dimension.
    */
@@ -252,7 +273,9 @@ export interface UnitGroup {
   created_at: string;
 
   /**
-   * Display name.
+   * Display name of the unit group.
+   *
+   * Unique within the account.
    */
   name: string;
 
@@ -396,7 +419,7 @@ export interface UnitGroupListParams {
   q?: string;
 
   /**
-   * Filter by unit dimension (e.g. `mass`).
+   * Filter by unit dimension.
    */
   type?: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
 }
@@ -423,8 +446,7 @@ export interface UnitGroupCreateParams {
   name: string;
 
   /**
-   * Body param: Dimension shared by every unit in this group (e.g. `mass`,
-   * `volume`).
+   * Body param: Dimension shared by every unit in this group.
    *
    * All associated units must be of this dimension.
    */

package/src/resources/catalog/unit-groups/units.ts

@@ -13,6 +13,8 @@ export class Units extends APIResource {
   /**
    * Returns a list of associated units within a unit group.
    *
+   * This endpoint requires the permission: `unit_groups:read`.
+   *
    * @example
    * ```ts
    * const listUnitGroupUnit =
@@ -32,6 +34,8 @@ export class Units extends APIResource {
   /**
    * Returns an associated unit within a unit group by ID.
    *
+   * This endpoint requires the permission: `unit_groups:read`.
+   *
    * @example
    * ```ts
    * const unitGroupUnit =
@@ -57,6 +61,8 @@ export class Units extends APIResource {
    * Adds a unit to a unit group. If the unit is already in the group, its existing
    * association is updated with the provided settings instead.
    *
+   * This endpoint requires the permission: `unit_groups:update`.
+   *
    * @example
    * ```ts
    * const unitGroupUnit =
@@ -86,6 +92,8 @@ export class Units extends APIResource {
   /**
    * Partially updates an associated unit within a unit group.
    *
+   * This endpoint requires the permission: `unit_groups:update`.
+   *
    * @example
    * ```ts
    * const unitGroupUnit =
@@ -93,6 +101,8 @@ export class Units extends APIResource {
    *     'un_01966263f74a5a0cae356000a1',
    *     {
    *       unit_group_id: 'ug_01aad07abb8e41fd392d2d7013',
+   *       customer_portal_visibility: 'visible',
+   *       discount_fixed: 2.5,
    *       discount_percentage: 0.9,
    *       unit_id: 'un_01966263f74a5a0cae356000a1',
    *     },
@@ -115,6 +125,8 @@ export class Units extends APIResource {
   /**
    * Removes a unit from a unit group. The unit itself is not deleted.
    *
+   * This endpoint requires the permission: `unit_groups:delete`.
+   *
    * @example
    * ```ts
    * const unit = await client.catalog.unitGroups.units.delete(

package/src/resources/catalog/units.ts

@@ -14,6 +14,8 @@ export class Units extends APIResource {
    * Returns a paginated list of units for the current account, including both
    * account-owned and global system units.
    *
+   * This endpoint requires the permission: `units:read`.
+   *
    * @example
    * ```ts
    * const listUnit = await client.catalog.units.list();
@@ -26,6 +28,8 @@ export class Units extends APIResource {
   /**
    * Returns a unit by ID, including both account-owned and global system units.
    *
+   * This endpoint requires the permission: `units:read`.
+   *
    * @example
    * ```ts
    * const unit = await client.catalog.units.retrieve(
@@ -44,6 +48,8 @@ export class Units extends APIResource {
   /**
    * Creates an account-owned unit.
    *
+   * This endpoint requires the permission: `units:create`.
+   *
    * @example
    * ```ts
    * const unit = await client.catalog.units.create({
@@ -65,11 +71,20 @@ export class Units extends APIResource {
   /**
    * Partially updates an account-owned unit; system units cannot be updated.
    *
+   * This endpoint requires the permission: `units:update`.
+   *
    * @example
    * ```ts
    * const unit = await client.catalog.units.update(
    *   'un_01966263f74a5a0cae356000a1',
-   *   { abbreviation: 'kg', name: 'Kilogram' },
+   *   {
+   *     abbreviation: 'kg',
+   *     name: 'Kilogram',
+   *     offset_denominator: '1',
+   *     offset_numerator: '0',
+   *     ratio_denominator: '1',
+   *     ratio_numerator: '1000',
+   *   },
    * );
    * ```
    */
@@ -83,8 +98,12 @@ export class Units extends APIResource {
   }
 
   /**
-   * Deletes an account-owned unit. Associated unit group memberships are also
-   * removed, and system units cannot be deleted.
+   * Deletes an account-owned unit.
+   *
+   * Associated unit group memberships are also removed, and system units cannot be
+   * deleted.
+   *
+   * This endpoint requires the permission: `units:delete`.
    *
    * @example
    * ```ts
@@ -117,28 +136,31 @@ export interface CreateUnitRequest {
   name: string;
 
   /**
-   * Conversion offset denominator, as a decimal string. Must not be zero.
+   * Conversion offset denominator.
+   *
+   * Must not be zero.
    */
   offset_denominator: string;
 
   /**
-   * Conversion offset numerator, as a decimal string.
+   * Conversion offset numerator, used for temperature-like conversions.
    */
   offset_numerator: string;
 
   /**
-   * Conversion ratio denominator relative to the base unit, as a decimal string.
+   * Conversion ratio denominator relative to the base unit.
+   *
    * Must not be zero.
    */
   ratio_denominator: string;
 
   /**
-   * Conversion ratio numerator relative to the base unit, as a decimal string.
+   * Conversion ratio numerator relative to the base unit.
    */
   ratio_numerator: string;
 
   /**
-   * Unit dimension (e.g. `mass`, `volume`, `currency`).
+   * Unit dimension.
    *
    * Units can only be converted to other units of the same dimension.
    */
@@ -267,22 +289,26 @@ export interface UpdateUnitRequest {
   name?: string;
 
   /**
-   * Conversion offset denominator, as a decimal string. Must not be zero.
+   * Conversion offset denominator.
+   *
+   * Must not be zero.
    */
   offset_denominator?: string;
 
   /**
-   * Conversion offset numerator, as a decimal string.
+   * Conversion offset numerator, used for temperature-like conversions.
    */
   offset_numerator?: string;
 
   /**
-   * Conversion ratio denominator, as a decimal string. Must not be zero.
+   * Conversion ratio denominator relative to the base unit.
+   *
+   * Must not be zero.
    */
   ratio_denominator?: string;
 
   /**
-   * Conversion ratio numerator, as a decimal string.
+   * Conversion ratio numerator relative to the base unit.
    */
   ratio_numerator?: string;
 }
@@ -318,7 +344,7 @@ export interface UnitListParams {
   q?: string;
 
   /**
-   * Filter by unit dimension (e.g. `mass`).
+   * Filter by unit dimension.
    */
   type?: 'currency' | 'quantity' | 'time' | 'mass' | 'volume' | 'length' | 'temperature' | 'area';
 
@@ -352,30 +378,31 @@ export interface UnitCreateParams {
   name: string;
 
   /**
-   * Body param: Conversion offset denominator, as a decimal string. Must not be
-   * zero.
+   * Body param: Conversion offset denominator.
+   *
+   * Must not be zero.
    */
   offset_denominator: string;
 
   /**
-   * Body param: Conversion offset numerator, as a decimal string.
+   * Body param: Conversion offset numerator, used for temperature-like conversions.
    */
   offset_numerator: string;
 
   /**
-   * Body param: Conversion ratio denominator relative to the base unit, as a decimal
-   * string. Must not be zero.
+   * Body param: Conversion ratio denominator relative to the base unit.
+   *
+   * Must not be zero.
    */
   ratio_denominator: string;
 
   /**
-   * Body param: Conversion ratio numerator relative to the base unit, as a decimal
-   * string.
+   * Body param: Conversion ratio numerator relative to the base unit.
    */
   ratio_numerator: string;
 
   /**
-   * Body param: Unit dimension (e.g. `mass`, `volume`, `currency`).
+   * Body param: Unit dimension.
    *
    * Units can only be converted to other units of the same dimension.
    */
@@ -410,23 +437,26 @@ export interface UnitUpdateParams {
   name?: string;
 
   /**
-   * Body param: Conversion offset denominator, as a decimal string. Must not be
-   * zero.
+   * Body param: Conversion offset denominator.
+   *
+   * Must not be zero.
    */
   offset_denominator?: string;
 
   /**
-   * Body param: Conversion offset numerator, as a decimal string.
+   * Body param: Conversion offset numerator, used for temperature-like conversions.
    */
   offset_numerator?: string;
 
   /**
-   * Body param: Conversion ratio denominator, as a decimal string. Must not be zero.
+   * Body param: Conversion ratio denominator relative to the base unit.
+   *
+   * Must not be zero.
    */
   ratio_denominator?: string;
 
   /**
-   * Body param: Conversion ratio numerator, as a decimal string.
+   * Body param: Conversion ratio numerator relative to the base unit.
    */
   ratio_numerator?: string;
 }

package/src/resources/core/addresses/actions.ts

@@ -21,6 +21,7 @@ export class Actions extends APIResource {
    *     country: 'US',
    *     postal_code: '62701',
    *     state: 'IL',
+   *     address_line_2: 'Suite 400',
    *   });
    * ```
    */

package/src/resources/core/audit-events.ts

@@ -14,6 +14,8 @@ export class AuditEvents extends APIResource {
   /**
    * Returns a paginated list of audit events for the current account.
    *
+   * This endpoint requires the permission: `audit_events:read`.
+   *
    * @example
    * ```ts
    * const listAuditEvent = await client.core.auditEvents.list();
@@ -29,6 +31,8 @@ export class AuditEvents extends APIResource {
   /**
    * Returns an audit event by ID.
    *
+   * This endpoint requires the permission: `audit_events:read`.
+   *
    * @example
    * ```ts
    * const auditEvent = await client.core.auditEvents.retrieve(
@@ -50,6 +54,8 @@ export class AuditEvents extends APIResource {
    * Values are plain strings, suitable for the `resource_types` filter when listing
    * audit events.
    *
+   * This endpoint requires the permission: `audit_events:read`.
+   *
    * @example
    * ```ts
    * const listObjectType =
@@ -78,18 +84,23 @@ export interface AuditEvent {
   account: APIKeysAPI.Account | null;
 
   /**
-   * Mutation type.
+   * The type of action this event records.
    *
    * - `create`: the resource was created.
    * - `update`: one or more fields were changed.
    * - `delete`: the resource was deleted.
    * - `restore`: a previously deleted resource was restored.
    * - `archive`: the resource was archived.
+   * - `approve`: a human approved a gated action, such as allowing a review-gated
+   *   agent tool to run.
+   * - `deny`: a human denied a gated action, such as rejecting a review-gated agent
+   *   tool.
    */
-  action: 'create' | 'update' | 'delete' | 'restore' | 'archive';
+  action: 'create' | 'update' | 'delete' | 'restore' | 'archive' | 'approve' | 'deny';
 
   /**
-   * Reference to an actor (user, API key, or agent).
+   * Reference to an actor — the user, API key, agent, or group identity associated
+   * with an action.
    */
   actor: RequestLogsAPI.Actor | null;
 
@@ -174,12 +185,31 @@ export interface AuditEvent {
     | 'agent_run_step'
     | 'agent_token_usage'
     | 'agent_memory'
-    | 'agent_alert'
+    | 'notification'
+    | 'notification_unread_count'
+    | 'notification_send_result'
+    | 'notification_unread_summary'
+    | 'announcement'
+    | 'conversation'
+    | 'conversation_participant'
+    | 'read_cursor'
+    | 'chat_message'
+    | 'notification_unread_summary_account'
+    | 'messaging_block'
+    | 'notification_preference'
+    | 'message_attachment'
+    | 'attachment_upload_target'
+    | 'scheduled_message'
+    | 'messaging_contact'
+    | 'message_report'
     | 'tool_group'
+    | 'model'
     | 'payment_term'
     | 'shipping_term'
     | 'quantity'
     | 'account_group'
+    | 'support_route'
+    | 'support_availability'
     | 'account_status'
     | 'geolocation'
     | 'account_user'
@@ -227,6 +257,8 @@ export interface AuditEvent {
     | 'location_type'
     | 'lot'
     | 'email_log'
+    | 'email_domain'
+    | 'email_inbox'
     | 'inventory_change_log'
     | 'invoice'
     | 'invoice_summary'
@@ -249,7 +281,6 @@ export interface AuditEvent {
     | 'transaction_type'
     | 'transaction_allocation'
     | 'usage_item'
-    | 'agent_token_detail'
     | 'account_usage_response'
     | 'subscription_info'
     | 'billing_portal_session_response'
@@ -346,7 +377,16 @@ export interface AuditEvent {
     | 'allocation_customer'
     | 'checkout_sales_order_response'
     | 'create_production_run_response'
-    | 'sales_order_price_quote';
+    | 'sales_order_price_quote'
+    | 'hubspot_sync_job'
+    | 'hubspot_sync_report'
+    | 'hubspot_company_review'
+    | 'hubspot_company_candidate'
+    | 'contact_match'
+    | 'reply_draft'
+    | 'conversation_link'
+    | 'messaging_group'
+    | 'messaging_group_member';
 
   /**
    * Originating client IP address.
@@ -468,12 +508,31 @@ export interface ListObjectType {
     | 'agent_run_step'
     | 'agent_token_usage'
     | 'agent_memory'
-    | 'agent_alert'
+    | 'notification'
+    | 'notification_unread_count'
+    | 'notification_send_result'
+    | 'notification_unread_summary'
+    | 'announcement'
+    | 'conversation'
+    | 'conversation_participant'
+    | 'read_cursor'
+    | 'chat_message'
+    | 'notification_unread_summary_account'
+    | 'messaging_block'
+    | 'notification_preference'
+    | 'message_attachment'
+    | 'attachment_upload_target'
+    | 'scheduled_message'
+    | 'messaging_contact'
+    | 'message_report'
     | 'tool_group'
+    | 'model'
     | 'payment_term'
     | 'shipping_term'
     | 'quantity'
     | 'account_group'
+    | 'support_route'
+    | 'support_availability'
     | 'account_status'
     | 'geolocation'
     | 'account_user'
@@ -521,6 +580,8 @@ export interface ListObjectType {
     | 'location_type'
     | 'lot'
     | 'email_log'
+    | 'email_domain'
+    | 'email_inbox'
     | 'inventory_change_log'
     | 'invoice'
     | 'invoice_summary'
@@ -543,7 +604,6 @@ export interface ListObjectType {
     | 'transaction_type'
     | 'transaction_allocation'
     | 'usage_item'
-    | 'agent_token_detail'
     | 'account_usage_response'
     | 'subscription_info'
     | 'billing_portal_session_response'
@@ -641,6 +701,15 @@ export interface ListObjectType {
     | 'checkout_sales_order_response'
     | 'create_production_run_response'
     | 'sales_order_price_quote'
+    | 'hubspot_sync_job'
+    | 'hubspot_sync_report'
+    | 'hubspot_company_review'
+    | 'hubspot_company_candidate'
+    | 'contact_match'
+    | 'reply_draft'
+    | 'conversation_link'
+    | 'messaging_group'
+    | 'messaging_group_member'
   >;
 
   /**
@@ -658,7 +727,7 @@ export interface AuditEventListParams {
   /**
    * Filter by the mutation type recorded on the event.
    */
-  actions?: Array<'create' | 'update' | 'delete' | 'restore' | 'archive'>;
+  actions?: Array<'create' | 'update' | 'delete' | 'restore' | 'archive' | 'approve' | 'deny'>;
 
   /**
    * Filter by the _acting_ account: the account that performed the mutation.
@@ -678,6 +747,11 @@ export interface AuditEventListParams {
    */
   actor_ids?: Array<string>;
 
+  /**
+   * Filter by the actor type.
+   */
+  actor_types?: Array<'user' | 'api_key' | 'agent' | 'group'>;
+
   /**
    * Opaque cursor token identifying where the page of results starts.
    *
@@ -757,12 +831,31 @@ export interface AuditEventListParams {
     | 'agent_run_step'
     | 'agent_token_usage'
     | 'agent_memory'
-    | 'agent_alert'
+    | 'notification'
+    | 'notification_unread_count'
+    | 'notification_send_result'
+    | 'notification_unread_summary'
+    | 'announcement'
+    | 'conversation'
+    | 'conversation_participant'
+    | 'read_cursor'
+    | 'chat_message'
+    | 'notification_unread_summary_account'
+    | 'messaging_block'
+    | 'notification_preference'
+    | 'message_attachment'
+    | 'attachment_upload_target'
+    | 'scheduled_message'
+    | 'messaging_contact'
+    | 'message_report'
     | 'tool_group'
+    | 'model'
     | 'payment_term'
     | 'shipping_term'
     | 'quantity'
     | 'account_group'
+    | 'support_route'
+    | 'support_availability'
     | 'account_status'
     | 'geolocation'
     | 'account_user'
@@ -810,6 +903,8 @@ export interface AuditEventListParams {
     | 'location_type'
     | 'lot'
     | 'email_log'
+    | 'email_domain'
+    | 'email_inbox'
     | 'inventory_change_log'
     | 'invoice'
     | 'invoice_summary'
@@ -832,7 +927,6 @@ export interface AuditEventListParams {
     | 'transaction_type'
     | 'transaction_allocation'
     | 'usage_item'
-    | 'agent_token_detail'
     | 'account_usage_response'
     | 'subscription_info'
     | 'billing_portal_session_response'
@@ -930,6 +1024,15 @@ export interface AuditEventListParams {
     | 'checkout_sales_order_response'
     | 'create_production_run_response'
     | 'sales_order_price_quote'
+    | 'hubspot_sync_job'
+    | 'hubspot_sync_report'
+    | 'hubspot_company_review'
+    | 'hubspot_company_candidate'
+    | 'contact_match'
+    | 'reply_draft'
+    | 'conversation_link'
+    | 'messaging_group'
+    | 'messaging_group_member'
   >;
 
   /**