@augno/sdk 0.7.1 → 0.10.0

package/src/resources/catalog/product-lines.ts

@@ -88,7 +88,12 @@ export class ProductLines extends APIResource {
    * const productLine =
    *   await client.catalog.productLines.update(
    *     'pl_01996357326a0d3f7b129542ea',
-   *     { name: 'Updated Product Line' },
+   *     {
+   *       commission_policy: 'commission_applied',
+   *       freight_policy: 'billed_freight',
+   *       name: 'Updated Product Line',
+   *       unit_group_id: 'ug_01aad07abb8e41fd392d2d7013',
+   *     },
    *   );
    * ```
    */

package/src/resources/catalog/products.ts

@@ -64,6 +64,23 @@ export class Products extends APIResource {
    *   category_id: 'ic_01ae7bd7bfd21ca0ab81e1357e',
    *   sku: 'ALM-2024-1001',
    *   type: 'sale',
+   *   attribute_ids: ['at_01c9493ec0c46bb0ed12708ae4'],
+   *   description:
+   *     'Wireless barcode scanner with charging cradle',
+   *   notes:
+   *     'Ships with a 2-year warranty; register for extended coverage.',
+   *   portal_visibility: 'visible',
+   *   product_line_id: 'pl_01996357326a0d3f7b129542ea',
+   *   unit_cost: {
+   *     value: '112.00',
+   *     numerator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *     denominator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *   },
+   *   unit_price: {
+   *     value: '199.00',
+   *     numerator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *     denominator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *   },
    * });
    * ```
    */
@@ -81,7 +98,19 @@ export class Products extends APIResource {
    * ```ts
    * const product = await client.catalog.products.update(
    *   'pd_013c29ab3f1518d0004094c316',
-   *   { sku: 'SKU-002' },
+   *   {
+   *     description:
+   *       'Wireless barcode scanner with charging cradle (v2)',
+   *     notes:
+   *       'Firmware 2.1 improves Bluetooth pairing reliability.',
+   *     portal_visibility: 'visible',
+   *     sku: 'SKU-002',
+   *     unit_price: {
+   *       value: '219.00',
+   *       numerator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *       denominator_unit_id: 'un_01966263f74a5a0cae356000a1',
+   *     },
+   *   },
    * );
    * ```
    */

package/src/resources/catalog/properties/attributes.ts

@@ -92,6 +92,8 @@ export class Attributes extends APIResource {
    *     'at_01c9493ec0c46bb0ed12708ae4',
    *     {
    *       property_id: 'pp_01e21344878064372f69e67093',
+   *       color: 'blue',
+   *       sort_order: 2,
    *       value: 'Blue',
    *     },
    *   );

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

@@ -82,6 +82,8 @@ export class UnitGroups extends APIResource {
    *       customer_portal_visibility: 'visible',
    *     },
    *   ],
+   *   notes:
+   *     'Used for raw-material weight tracking across the warehouse.',
    * });
    * ```
    */
@@ -100,8 +102,17 @@ export class UnitGroups extends APIResource {
    * 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.',
    *   },
    * );
    * ```

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

@@ -101,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',
    *     },

package/src/resources/catalog/units.ts

@@ -77,7 +77,14 @@ export class Units extends APIResource {
    * ```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',
+   *   },
    * );
    * ```
    */

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

@@ -192,6 +192,7 @@ export interface AuditEvent {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -514,6 +515,7 @@ export interface ListObjectType {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -836,6 +838,7 @@ export interface AuditEventListParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'

package/src/resources/core/core.ts

@@ -152,6 +152,7 @@ export interface Entity {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -447,6 +448,7 @@ export interface CoreRetrieveSearchParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'

package/src/resources/identity/account-users/account-users.ts

@@ -70,6 +70,7 @@ export class AccountUsers extends APIResource {
    * ```ts
    * const accountUser =
    *   await client.identity.accountUsers.create({
+   *     department_id: 'dp_01791c25ab59da4704cba61874',
    *     email: 'jdoe@augno.com',
    *     name: 'John Doe',
    *     password: 'QgS7Z8Hhj3&1',
@@ -109,8 +110,16 @@ export class AccountUsers extends APIResource {
    *     'acus_01ea9983ddb41dacc44ecf997c',
    *     {
    *       department_id: 'dp_01791c25ab59da4704cba61874',
+   *       email: 'jdoe@augno.com',
    *       name: 'John Doe',
+   *       preferences: [
+   *         {
+   *           notification_type: 'order_acknowledgement',
+   *           enabled: true,
+   *         },
+   *       ],
    *       role_id: 'rl_01c16d2eb637c0d1f3a372937c',
+   *       username: 'jdoe',
    *     },
    *   );
    * ```

package/src/resources/messaging/conversations/conversations.ts

@@ -80,10 +80,14 @@ export class Conversations extends APIResource {
    * ```ts
    * const conversation =
    *   await client.messaging.conversations.create({
-   *     type: 'direct_message',
+   *     type: 'group',
+   *     group_id: 'cvgp_018e88072d1320808dc97abc',
    *     participant_account_user_ids: [
    *       'acus_01ea9983ddb41dacc44ecf997c',
    *     ],
+   *     title: 'Order #1042 — shipping question',
+   *     topic_resource_id: 'or_01d5034136c3ccc048abecc312',
+   *     topic_resource_type: 'sales_order',
    *   });
    * ```
    */
@@ -925,6 +929,12 @@ export interface ConversationParticipant {
    */
   object: 'conversation_participant';
 
+  /**
+   * A participant's read position in a conversation — the basis for read receipts
+   * ("who has seen this").
+   */
+  read_cursor: ReadCursor;
+
   /**
    * The participant's permission level in the conversation.
    *
@@ -1031,6 +1041,7 @@ export interface CreateConversationRequest {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -1503,7 +1514,10 @@ export interface Message {
   streaming_state: string | null;
 
   /**
-   * The email subject of a customer-reply `draft` on an email-bridged case.
+   * The email subject line
+   *
+   * On an email-bridged case, the original subject of an inbound email, or the
+   * subject a customer-reply `draft`/outbound message is sent with.
    */
   subject: string | null;
 
@@ -1654,6 +1668,40 @@ export interface MessagingGroupMember {
   object: 'messaging_group_member';
 }
 
+/**
+ * A participant's read position in a conversation — the basis for read receipts
+ * ("who has seen this").
+ */
+export interface ReadCursor {
+  /**
+   * The id of the last message the participant has read.
+   *
+   * `null` if they have not read any message yet.
+   */
+  message_id: string | null;
+
+  /**
+   * Resource type identifier.
+   */
+  object: 'read_cursor';
+
+  /**
+   * When the participant last advanced their read cursor.
+   *
+   * `null` if they have not read any message yet.
+   */
+  read_at: string | null;
+
+  /**
+   * The sequence number of the last message the participant has read in the
+   * conversation.
+   *
+   * A message is "seen" by this participant when its `sequence` is `<=` this value.
+   * `0` means they have not read any message in the conversation yet.
+   */
+  sequence: number;
+}
+
 /**
  * Trigger-type-specific configuration.
  *
@@ -1796,6 +1844,7 @@ export interface ConversationCreateParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -2104,6 +2153,7 @@ export interface ConversationListParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -2389,6 +2439,7 @@ export declare namespace Conversations {
     type MessageAttachment as MessageAttachment,
     type MessagingGroup as MessagingGroup,
     type MessagingGroupMember as MessagingGroupMember,
+    type ReadCursor as ReadCursor,
     type TriggerConfig as TriggerConfig,
     type UpdateConversationRequest as UpdateConversationRequest,
     type ConversationCreateParams as ConversationCreateParams,

package/src/resources/messaging/conversations/index.ts

@@ -46,6 +46,7 @@ export {
   type MessageAttachment,
   type MessagingGroup,
   type MessagingGroupMember,
+  type ReadCursor,
   type TriggerConfig,
   type UpdateConversationRequest,
   type ConversationCreateParams,

package/src/resources/messaging/conversations/links.ts

@@ -134,6 +134,7 @@ export interface AddConversationLinkRequest {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -436,6 +437,7 @@ export interface LinkCreateParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'

package/src/resources/messaging/conversations/messages.ts

@@ -30,6 +30,27 @@ export class Messages extends APIResource {
    *     {
    *       body: 'Sounds good — shipping it today.',
    *       client_message_id: 'client_msg_8c7d2f',
+   *       attachments: [
+   *         {
+   *           kind: 'file',
+   *           s3_key: 'uploads/acme/quote.pdf',
+   *           filename: 'quote.pdf',
+   *           content_type: 'application/pdf',
+   *           size_bytes: 20480,
+   *         },
+   *       ],
+   *       audience: 'customer',
+   *       cc: ['ap@acme.com'],
+   *       channel: 'email',
+   *       link_resource_id: 'or_01d5034136c3ccc048abecc312',
+   *       link_resource_type: 'sales_order',
+   *       mentions: ['acus_01ea9983ddb41dacc44ecf997c'],
+   *       mode: 'send',
+   *       reply_to_message_id: 'mg_01h9z8q1w2e3r4t5y6u7i8mg',
+   *       scheduled_at: '2026-05-10T15:00:00Z',
+   *       source_thread_message_id:
+   *         'mg_01h9z8q1w2e3r4t5y6u7i8mg',
+   *       subject: 'Re: Order #1042',
    *     },
    *   );
    * ```
@@ -237,6 +258,7 @@ export interface SendMessageRequest {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -596,6 +618,7 @@ export interface MessageCreateParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'

package/src/resources/messaging/email-inboxes.ts

@@ -23,6 +23,10 @@ export class EmailInboxes extends APIResource {
    *   await client.messaging.emailInboxes.create({
    *     address: 'support@acme.com',
    *     email_domain_id: 'emdom_018e88072d1320808dc9aaa01',
+   *     agent_config_id: 'agdf_01b9ef28feb99e6954201aca63',
+   *     agent_trigger_keywords: ['invoice', 'refund'],
+   *     agent_trigger_policy: 'keyword',
+   *     from_name: 'Acme Support',
    *   });
    * ```
    */
@@ -80,7 +84,13 @@ export class EmailInboxes extends APIResource {
    * const emailInbox =
    *   await client.messaging.emailInboxes.update(
    *     'eminb_018e88072d1320808dc9bbb02',
-   *     { status: 'active' },
+   *     {
+   *       status: 'active',
+   *       agent_config_id: 'agdf_01b9ef28feb99e6954201aca63',
+   *       agent_trigger_keywords: ['invoice', 'refund'],
+   *       agent_trigger_policy: 'keyword',
+   *       from_name: 'Acme Support',
+   *     },
    *   );
    * ```
    */
@@ -152,6 +162,12 @@ export interface CreateEmailInboxRequest {
    * Display name for the `From` header of outbound mail.
    */
   from_name?: string;
+
+  /**
+   * The messaging group (roster) whose members are seated on every conversation this
+   * inbox opens.
+   */
+  group_id?: string;
 }
 
 /**
@@ -208,11 +224,31 @@ export interface EmailInbox {
    */
   email_domain: EmailDomainsAPI.EmailDomain | null;
 
+  /**
+   * A forwarding address on an Augno-owned domain that also routes to this inbox.
+   *
+   * Use this when your domain's mail is hosted elsewhere (e.g. Google Workspace,
+   * Microsoft 365) and you cannot point its MX records at Augno: forward mail from
+   * `address` to this address instead, and it will still be threaded into a
+   * conversation. `null` when domain forwarding is not configured.
+   */
+  forwarding_address: string | null;
+
   /**
    * The display name used in the `From` header of outbound mail.
    */
   from_name: string | null;
 
+  /**
+   * The messaging group (roster) whose members are added to every conversation this
+   * inbox opens.
+   *
+   * Everyone in the group — the human team plus any agents — is seated on each new
+   * email thread so they can read, edit, and approve replies alongside the bound
+   * agent. `null` when no group is set.
+   */
+  group_id: string | null;
+
   /**
    * Resource type identifier.
    */
@@ -289,6 +325,12 @@ export interface UpdateEmailInboxRequest {
    * Display name for the `From` header of outbound mail.
    */
   from_name?: string;
+
+  /**
+   * The messaging group (roster) whose members are seated on every conversation this
+   * inbox opens.
+   */
+  group_id?: string;
 }
 
 export interface EmailInboxDeleteResponse {}
@@ -335,6 +377,12 @@ export interface EmailInboxCreateParams {
    * Body param: Display name for the `From` header of outbound mail.
    */
   from_name?: string;
+
+  /**
+   * Body param: The messaging group (roster) whose members are seated on every
+   * conversation this inbox opens.
+   */
+  group_id?: string;
 }
 
 export interface EmailInboxListParams {
@@ -391,6 +439,12 @@ export interface EmailInboxUpdateParams {
    * Body param: Display name for the `From` header of outbound mail.
    */
   from_name?: string;
+
+  /**
+   * Body param: The messaging group (roster) whose members are seated on every
+   * conversation this inbox opens.
+   */
+  group_id?: string;
 }
 
 export declare namespace EmailInboxes {

package/src/resources/messaging/groups/groups.ts

@@ -29,6 +29,9 @@ export class Groups extends APIResource {
    *     member_account_user_ids: [
    *       'acus_01ea9983ddb41dacc44ecf997c',
    *     ],
+   *     member_agent_config_ids: [
+   *       'agdf_01b9ef28feb99e6954201aca63',
+   *     ],
    *   },
    * );
    * ```

package/src/resources/messaging/groups/members.ts

@@ -23,6 +23,7 @@ export class Members extends APIResource {
    *     {
    *       member_type: 'user',
    *       account_user_id: 'acus_01ea9983ddb41dacc44ecf997c',
+   *       agent_config_id: 'agdf_01b9ef28feb99e6954201aca63',
    *     },
    *   );
    * ```

package/src/resources/messaging/index.ts

@@ -54,6 +54,7 @@ export {
   type MessageAttachment,
   type MessagingGroup,
   type MessagingGroupMember,
+  type ReadCursor,
   type TriggerConfig,
   type UpdateConversationRequest,
   type ConversationCreateParams,

package/src/resources/messaging/messages/messages.ts

@@ -31,6 +31,7 @@ export class Messages extends APIResource {
    *   'mg_01h9z8q1w2e3r4t5y6u7i8mg',
    *   {
    *     body: 'Hi Joe — good news, your order ships tomorrow.',
+   *     subject: 'Re: Order #1042',
    *   },
    * );
    * ```

package/src/resources/messaging/messaging.ts

@@ -85,6 +85,7 @@ import {
   MessageAttachment,
   MessagingGroup,
   MessagingGroupMember,
+  ReadCursor,
   TriggerConfig,
   UpdateConversationRequest,
 } from './conversations/conversations';
@@ -271,6 +272,7 @@ export declare namespace Messaging {
     type MessageAttachment as MessageAttachment,
     type MessagingGroup as MessagingGroup,
     type MessagingGroupMember as MessagingGroupMember,
+    type ReadCursor as ReadCursor,
     type TriggerConfig as TriggerConfig,
     type UpdateConversationRequest as UpdateConversationRequest,
     type ConversationCreateParams as ConversationCreateParams,

package/src/resources/messaging/notifications/notifications.ts

@@ -41,6 +41,10 @@ export class Notifications extends APIResource {
    *       id: 'acus_01ea9983ddb41dacc44ecf997c',
    *     },
    *     title: 'Order updated',
+   *     body: 'Order #1042 was updated.',
+   *     link_resource_id: 'or_01d5034136c3ccc048abecc312',
+   *     link_resource_type: 'sales_order',
+   *     priority: 'high',
    *   });
    * ```
    */
@@ -462,6 +466,7 @@ export interface SendNotificationRequest {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'
@@ -755,6 +760,7 @@ export interface NotificationCreateParams {
     | 'announcement'
     | 'conversation'
     | 'conversation_participant'
+    | 'read_cursor'
     | 'chat_message'
     | 'notification_unread_summary_account'
     | 'messaging_block'

package/src/resources/operations/carriers/carriers.ts

@@ -94,7 +94,10 @@ export class Carriers extends APIResource {
    * ```ts
    * const carrier = await client.operations.carriers.update(
    *   'cr_01784fd54c9ba197bb4e42f0e6',
-   *   { name: 'FedEx Express' },
+   *   {
+   *     customer_portal_visibility: 'visible',
+   *     name: 'FedEx Express',
+   *   },
    * );
    * ```
    */

package/src/resources/operations/carriers/service-levels.ts

@@ -73,6 +73,7 @@ export class ServiceLevels extends APIResource {
    *       code: 'ground',
    *       is_default: false,
    *       name: 'Ground Shipping',
+   *       customer_portal_visibility: 'visible',
    *     },
    *   );
    * ```
@@ -104,6 +105,8 @@ export class ServiceLevels extends APIResource {
    *     'crop_01cfaf03f104e90ef9680e2a30',
    *     {
    *       carrier_id: 'cr_01784fd54c9ba197bb4e42f0e6',
+   *       code: 'express',
+   *       customer_portal_visibility: 'visible',
    *       name: 'Express Shipping',
    *     },
    *   );

package/src/resources/operations/locations.ts

@@ -58,6 +58,8 @@ export class Locations extends APIResource {
    * const location = await client.operations.locations.create({
    *   name: 'Warehouse A',
    *   type: 'building',
+   *   child_ids: ['lc_014d187d99b31926f0c74af9d8'],
+   *   parent_id: 'lc_014d187d99b31926f0c74af9d8',
    * });
    * ```
    */
@@ -75,7 +77,12 @@ export class Locations extends APIResource {
    * ```ts
    * const location = await client.operations.locations.update(
    *   'lc_014d187d99b31926f0c74af9d8',
-   *   { name: 'Warehouse B' },
+   *   {
+   *     child_ids: ['lc_014d187d99b31926f0c74af9d8'],
+   *     name: 'Warehouse B',
+   *     parent_id: 'lc_014d187d99b31926f0c74af9d8',
+   *     type: 'section',
+   *   },
    * );
    * ```
    */

package/src/resources/operations/scanning-stations.ts

@@ -67,6 +67,7 @@ export class ScanningStations extends APIResource {
    *     type: 'init_batch',
    *     label_size: '1x1',
    *     label_type: 'tag',
+   *     notes: 'Primary intake station on the receiving dock.',
    *   });
    * ```
    */
@@ -91,7 +92,13 @@ export class ScanningStations extends APIResource {
    * const scanningStation =
    *   await client.operations.scanningStations.update(
    *     'scst_0129335dd6286056a97024fcc1',
-   *     { name: 'Station B' },
+   *     {
+   *       label_size: '1x1',
+   *       label_type: 'tag',
+   *       name: 'Station B',
+   *       notes: 'Relocated to the finishing area.',
+   *       operator_requirement: 'material_check',
+   *     },
    *   );
    * ```
    */