@graph8/sdk 0.14.0 → 0.16.0

package/dist/react.d.mts

@@ -1552,6 +1552,8 @@ declare const createInboxClient: (apiKey: string, apiUrl?: string) => {
 };
 
 interface Deal {
+    /** Canonical CRM revision returned by a conditional update. */
+    revision?: number | null;
     id: string | null;
     name: string | null;
     description: string | null;
@@ -1616,6 +1618,8 @@ interface DealCreateParams {
     allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
+    /** Require this current CRM revision; a stale edit returns HTTP 409. */
+    expected_revision?: number;
     name?: string;
     description?: string;
     amount?: number;
@@ -1651,7 +1655,26 @@ interface DealUpdateParams {
     add_contact_ids?: number[];
     /** mashup_contact_ids to unlink. Idempotent. */
     remove_contact_ids?: number[];
+    /**
+     * Buying-committee role per contact on this deal, keyed by
+     * mashup_contact_id. JSON object keys are strings, so the key type is
+     * `string` even though the id is numeric: `{ "5500429": "champion" }`.
+     * `null` clears a contact's role.
+     *
+     * Applies to contacts already linked to the deal, and to contacts linked by
+     * `add_contact_ids` in the same call (roles are applied after the link). An
+     * id that is neither already linked nor being added is rejected with HTTP
+     * 422 naming the id, and the whole update is rolled back. A role outside the
+     * vocabulary is HTTP 422.
+     */
+    contact_roles?: Record<string, DealContactRole | null>;
 }
+/**
+ * Role a contact plays in a deal's buying committee
+ * (`cb_deal_contacts.role`). The same person can hold different roles on
+ * different deals, so this lives on the deal-contact link, not the contact.
+ */
+type DealContactRole = "champion" | "decision_maker" | "influencer" | "blocker" | "coach" | "end_user";
 interface DealListParams {
     page?: number;
     limit?: number;
@@ -1741,6 +1764,7 @@ declare const createDealsClient: (apiKey: string, apiUrl?: string) => {
     }>;
 };
 
+type CustomObjectIcon = "box" | "briefcase" | "building" | "calendar" | "flag" | "folder" | "globe" | "heart" | "layers" | "package" | "target" | "users";
 /** A custom object type in your workspace — a record type you define. */
 interface CustomObject {
     /** Stable API slug, e.g. `invoices`. */
@@ -1750,6 +1774,28 @@ interface CustomObject {
     /** True for object types graph8 ships; system objects cannot be deleted. */
     is_system: boolean;
     is_archived: boolean;
+    /** Presentation settings may be absent on older servers. */
+    description?: string | null;
+    icon?: string | null;
+    display_attribute_slug?: string | null;
+}
+/** Native schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObject {
+    slug: string;
+    singular_noun: string;
+    plural_noun: string;
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+}
+/** Omitted labels/state are preserved. The API slug is immutable. */
+interface UpdateCustomObject {
+    singular_noun?: string;
+    plural_noun?: string;
+    is_archived?: boolean;
+    /** Omit to preserve; null clears the setting. */
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+    display_attribute_slug?: string | null;
 }
 /**
  * One attribute on a custom object, and the rules its values must satisfy.
@@ -1762,6 +1808,15 @@ interface CustomObject {
  */
 interface CustomObjectAttribute {
     slug: string;
+    /** Customer-facing label. Display metadata is absent on older servers. */
+    title?: string;
+    description?: string | null;
+    /** Display order; ties are ordered by slug. */
+    sort_order?: number;
+    /** Protected system field rather than a customer-defined field. */
+    is_system?: boolean;
+    /** Archive state; absent on older servers. */
+    is_archived?: boolean;
     attribute_type: string;
     is_required: boolean;
     /** No two ACTIVE records may hold the same value. A collision returns 409. */
@@ -1774,6 +1829,24 @@ interface CustomObjectAttribute {
     /** Type-specific configuration, e.g. the allowed options for a `select`. */
     config: Record<string, unknown>;
 }
+/** Schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObjectAttribute {
+    slug: string;
+    title: string;
+    attribute_type: "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+    description?: string | null;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multiselect?: boolean;
+    is_default_value_enabled?: boolean;
+    default_value?: unknown;
+    config?: Record<string, unknown>;
+    sort_order?: number;
+}
+/** Omitted fields are preserved; explicit null can clear the configured default. */
+type UpdateCustomObjectAttribute = Partial<Omit<CreateCustomObjectAttribute, "slug" | "attribute_type">> & {
+    is_archived?: boolean;
+};
 /** One record, with its currently active attribute values. */
 interface CustomObjectRecord {
     id: string;
@@ -1804,6 +1877,29 @@ interface CustomObjectHistory {
     record_id: string;
     entries: CustomObjectHistoryEntry[];
 }
+interface CustomObjectMutation {
+    id: string;
+    action: "created" | "updated" | "archived" | "restored";
+    occurred_at: string;
+    revision: number;
+    actor_id: string | null;
+    actor_type: "user" | "api" | "app" | "integration" | "system";
+    source: string;
+    app_id: string | null;
+    changes: Record<string, {
+        before_present: boolean;
+        before: unknown;
+        after_present: boolean;
+        after: unknown;
+    }>;
+    was_archived: boolean;
+    is_archived: boolean;
+}
+interface CustomObjectMutations {
+    record_id: string;
+    entries: CustomObjectMutation[];
+    next_cursor: string | null;
+}
 interface ListRecordsParams {
     page?: number;
     /** 1-200, default 50. */
@@ -1868,16 +1964,33 @@ interface ObjectPagination {
  */
 declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
     /** List the custom object types in your workspace. */
-    list(): Promise<{
+    list(params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObject[];
     }>;
+    /** Create a native custom object. Requires objects:manage and Admin access. */
+    create(input: CreateCustomObject): Promise<CustomObject>;
+    /** Rename, archive or restore an object while preserving its slug and data. */
+    update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+    /** Archive the object without deleting records; restore with update({ is_archived: false }). */
+    archive(objectSlug: string): Promise<CustomObject>;
     /** Fetch one object type by slug. */
     get(objectSlug: string): Promise<CustomObject>;
     /** The object's attributes — the schema its records must satisfy. */
-    listAttributes(objectSlug: string): Promise<{
+    listAttributes(objectSlug: string, params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObjectAttribute[];
     }>;
-    /** Paginated records with their current values. Archived records are excluded. */
+    /** Create a field using the same schema rules as the customer UI. */
+    createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Edit or restore a field; its type and slug are immutable. */
+    updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Archive without deleting values; restore with updateAttribute({ is_archived: false }). */
+    archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
+    /** Paginated custom records or canonical deals with current values and revisions.
+     * Deal totals and related references respect current record access. */
     listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
         data: CustomObjectRecord[];
         pagination?: ObjectPagination;
@@ -1888,18 +2001,28 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * unique attribute is a 409.
      */
     createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
-    /** Fetch one record with its currently active values. */
+    /** Match a unique single-value key, creating or updating while preserving omitted fields. */
+    upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+        expectedRevision?: number;
+    }): Promise<CustomObjectRecord>;
+    /** Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID.
+     * Deals retain their UUIDs and expose company, primary-contact and contact_ids references only
+     * when permitted. Generic deal mutations are not yet supported.
+     */
     getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
     /**
      * Update a record. PARTIAL: only the attributes you send are touched, so
      * required attributes you omit are left alone rather than reported missing.
      * Sending an explicit `null` CLEARS that attribute.
      *
-     * Values are versioned rather than overwritten, so the previous value stays
-     * readable through `history`.
+     * Custom values retain generations through `history`. Canonical contacts and
+     * companies require expectedRevision from a fresh read and expose recorded
+     * mutations through `changes`. They do not yet support appendValues/removeValues.
      */
     updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
         expectedRevision?: number;
+        appendValues?: Record<string, unknown[]>;
+        removeValues?: Record<string, unknown[]>;
     }): Promise<CustomObjectRecord>;
     /**
      * Archive a record. It leaves listings, stays readable by id, and keeps its
@@ -1913,6 +2036,14 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * null is the value currently in force.
      */
     history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+    /** Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue.
+     * Canonical history respects current access/privacy; archived records and older
+     * unrecorded writes are not reconstructed. Store unavailability returns 503.
+     */
+    changes(objectSlug: string, recordId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CustomObjectMutations>;
 };
 
 /**
@@ -2781,7 +2912,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2789,7 +2920,7 @@ interface WebhookEventPayload {
     timestamp: string;
     data: Record<string, unknown>;
     org_id: string;
-    /** Stable per-delivery id (present once the backend adds it; for consumer dedup). */
+    /** Stable event ID for consumer deduplication; delivery ID is in X-Studio-Delivery-Id. */
     id?: string;
 }
 interface ConstructEventOptions {
@@ -2808,7 +2939,7 @@ declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) => {
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };
@@ -3915,7 +4046,7 @@ declare const useG8: () => {
         };
         get webhooks(): {
             baseUrl: string;
-            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
             constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
         };
         get contacts(): {
@@ -4077,25 +4208,44 @@ declare const useG8: () => {
             }>;
         };
         get objects(): {
-            list(): Promise<{
+            list(params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObject[];
             }>;
+            create(input: CreateCustomObject): Promise<CustomObject>;
+            update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+            archive(objectSlug: string): Promise<CustomObject>;
             get(objectSlug: string): Promise<CustomObject>;
-            listAttributes(objectSlug: string): Promise<{
+            listAttributes(objectSlug: string, params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObjectAttribute[];
             }>;
+            createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
             listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
                 data: CustomObjectRecord[];
                 pagination?: ObjectPagination;
             }>;
             createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
+            upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+                expectedRevision?: number;
+            }): Promise<CustomObjectRecord>;
             getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
                 expectedRevision?: number;
+                appendValues?: Record<string, unknown[]>;
+                removeValues?: Record<string, unknown[]>;
             }): Promise<CustomObjectRecord>;
             archiveRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             restoreRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+            changes(objectSlug: string, recordId: string, options?: {
+                limit?: number;
+                cursor?: string;
+            }): Promise<CustomObjectMutations>;
         };
         get deals(): {
             pipelines(): Promise<{

package/dist/react.d.ts

@@ -1552,6 +1552,8 @@ declare const createInboxClient: (apiKey: string, apiUrl?: string) => {
 };
 
 interface Deal {
+    /** Canonical CRM revision returned by a conditional update. */
+    revision?: number | null;
     id: string | null;
     name: string | null;
     description: string | null;
@@ -1616,6 +1618,8 @@ interface DealCreateParams {
     allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
+    /** Require this current CRM revision; a stale edit returns HTTP 409. */
+    expected_revision?: number;
     name?: string;
     description?: string;
     amount?: number;
@@ -1651,7 +1655,26 @@ interface DealUpdateParams {
     add_contact_ids?: number[];
     /** mashup_contact_ids to unlink. Idempotent. */
     remove_contact_ids?: number[];
+    /**
+     * Buying-committee role per contact on this deal, keyed by
+     * mashup_contact_id. JSON object keys are strings, so the key type is
+     * `string` even though the id is numeric: `{ "5500429": "champion" }`.
+     * `null` clears a contact's role.
+     *
+     * Applies to contacts already linked to the deal, and to contacts linked by
+     * `add_contact_ids` in the same call (roles are applied after the link). An
+     * id that is neither already linked nor being added is rejected with HTTP
+     * 422 naming the id, and the whole update is rolled back. A role outside the
+     * vocabulary is HTTP 422.
+     */
+    contact_roles?: Record<string, DealContactRole | null>;
 }
+/**
+ * Role a contact plays in a deal's buying committee
+ * (`cb_deal_contacts.role`). The same person can hold different roles on
+ * different deals, so this lives on the deal-contact link, not the contact.
+ */
+type DealContactRole = "champion" | "decision_maker" | "influencer" | "blocker" | "coach" | "end_user";
 interface DealListParams {
     page?: number;
     limit?: number;
@@ -1741,6 +1764,7 @@ declare const createDealsClient: (apiKey: string, apiUrl?: string) => {
     }>;
 };
 
+type CustomObjectIcon = "box" | "briefcase" | "building" | "calendar" | "flag" | "folder" | "globe" | "heart" | "layers" | "package" | "target" | "users";
 /** A custom object type in your workspace — a record type you define. */
 interface CustomObject {
     /** Stable API slug, e.g. `invoices`. */
@@ -1750,6 +1774,28 @@ interface CustomObject {
     /** True for object types graph8 ships; system objects cannot be deleted. */
     is_system: boolean;
     is_archived: boolean;
+    /** Presentation settings may be absent on older servers. */
+    description?: string | null;
+    icon?: string | null;
+    display_attribute_slug?: string | null;
+}
+/** Native schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObject {
+    slug: string;
+    singular_noun: string;
+    plural_noun: string;
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+}
+/** Omitted labels/state are preserved. The API slug is immutable. */
+interface UpdateCustomObject {
+    singular_noun?: string;
+    plural_noun?: string;
+    is_archived?: boolean;
+    /** Omit to preserve; null clears the setting. */
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+    display_attribute_slug?: string | null;
 }
 /**
  * One attribute on a custom object, and the rules its values must satisfy.
@@ -1762,6 +1808,15 @@ interface CustomObject {
  */
 interface CustomObjectAttribute {
     slug: string;
+    /** Customer-facing label. Display metadata is absent on older servers. */
+    title?: string;
+    description?: string | null;
+    /** Display order; ties are ordered by slug. */
+    sort_order?: number;
+    /** Protected system field rather than a customer-defined field. */
+    is_system?: boolean;
+    /** Archive state; absent on older servers. */
+    is_archived?: boolean;
     attribute_type: string;
     is_required: boolean;
     /** No two ACTIVE records may hold the same value. A collision returns 409. */
@@ -1774,6 +1829,24 @@ interface CustomObjectAttribute {
     /** Type-specific configuration, e.g. the allowed options for a `select`. */
     config: Record<string, unknown>;
 }
+/** Schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObjectAttribute {
+    slug: string;
+    title: string;
+    attribute_type: "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+    description?: string | null;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multiselect?: boolean;
+    is_default_value_enabled?: boolean;
+    default_value?: unknown;
+    config?: Record<string, unknown>;
+    sort_order?: number;
+}
+/** Omitted fields are preserved; explicit null can clear the configured default. */
+type UpdateCustomObjectAttribute = Partial<Omit<CreateCustomObjectAttribute, "slug" | "attribute_type">> & {
+    is_archived?: boolean;
+};
 /** One record, with its currently active attribute values. */
 interface CustomObjectRecord {
     id: string;
@@ -1804,6 +1877,29 @@ interface CustomObjectHistory {
     record_id: string;
     entries: CustomObjectHistoryEntry[];
 }
+interface CustomObjectMutation {
+    id: string;
+    action: "created" | "updated" | "archived" | "restored";
+    occurred_at: string;
+    revision: number;
+    actor_id: string | null;
+    actor_type: "user" | "api" | "app" | "integration" | "system";
+    source: string;
+    app_id: string | null;
+    changes: Record<string, {
+        before_present: boolean;
+        before: unknown;
+        after_present: boolean;
+        after: unknown;
+    }>;
+    was_archived: boolean;
+    is_archived: boolean;
+}
+interface CustomObjectMutations {
+    record_id: string;
+    entries: CustomObjectMutation[];
+    next_cursor: string | null;
+}
 interface ListRecordsParams {
     page?: number;
     /** 1-200, default 50. */
@@ -1868,16 +1964,33 @@ interface ObjectPagination {
  */
 declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
     /** List the custom object types in your workspace. */
-    list(): Promise<{
+    list(params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObject[];
     }>;
+    /** Create a native custom object. Requires objects:manage and Admin access. */
+    create(input: CreateCustomObject): Promise<CustomObject>;
+    /** Rename, archive or restore an object while preserving its slug and data. */
+    update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+    /** Archive the object without deleting records; restore with update({ is_archived: false }). */
+    archive(objectSlug: string): Promise<CustomObject>;
     /** Fetch one object type by slug. */
     get(objectSlug: string): Promise<CustomObject>;
     /** The object's attributes — the schema its records must satisfy. */
-    listAttributes(objectSlug: string): Promise<{
+    listAttributes(objectSlug: string, params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObjectAttribute[];
     }>;
-    /** Paginated records with their current values. Archived records are excluded. */
+    /** Create a field using the same schema rules as the customer UI. */
+    createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Edit or restore a field; its type and slug are immutable. */
+    updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Archive without deleting values; restore with updateAttribute({ is_archived: false }). */
+    archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
+    /** Paginated custom records or canonical deals with current values and revisions.
+     * Deal totals and related references respect current record access. */
     listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
         data: CustomObjectRecord[];
         pagination?: ObjectPagination;
@@ -1888,18 +2001,28 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * unique attribute is a 409.
      */
     createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
-    /** Fetch one record with its currently active values. */
+    /** Match a unique single-value key, creating or updating while preserving omitted fields. */
+    upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+        expectedRevision?: number;
+    }): Promise<CustomObjectRecord>;
+    /** Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID.
+     * Deals retain their UUIDs and expose company, primary-contact and contact_ids references only
+     * when permitted. Generic deal mutations are not yet supported.
+     */
     getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
     /**
      * Update a record. PARTIAL: only the attributes you send are touched, so
      * required attributes you omit are left alone rather than reported missing.
      * Sending an explicit `null` CLEARS that attribute.
      *
-     * Values are versioned rather than overwritten, so the previous value stays
-     * readable through `history`.
+     * Custom values retain generations through `history`. Canonical contacts and
+     * companies require expectedRevision from a fresh read and expose recorded
+     * mutations through `changes`. They do not yet support appendValues/removeValues.
      */
     updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
         expectedRevision?: number;
+        appendValues?: Record<string, unknown[]>;
+        removeValues?: Record<string, unknown[]>;
     }): Promise<CustomObjectRecord>;
     /**
      * Archive a record. It leaves listings, stays readable by id, and keeps its
@@ -1913,6 +2036,14 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * null is the value currently in force.
      */
     history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+    /** Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue.
+     * Canonical history respects current access/privacy; archived records and older
+     * unrecorded writes are not reconstructed. Store unavailability returns 503.
+     */
+    changes(objectSlug: string, recordId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CustomObjectMutations>;
 };
 
 /**
@@ -2781,7 +2912,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2789,7 +2920,7 @@ interface WebhookEventPayload {
     timestamp: string;
     data: Record<string, unknown>;
     org_id: string;
-    /** Stable per-delivery id (present once the backend adds it; for consumer dedup). */
+    /** Stable event ID for consumer deduplication; delivery ID is in X-Studio-Delivery-Id. */
     id?: string;
 }
 interface ConstructEventOptions {
@@ -2808,7 +2939,7 @@ declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) => {
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };
@@ -3915,7 +4046,7 @@ declare const useG8: () => {
         };
         get webhooks(): {
             baseUrl: string;
-            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled"];
+            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored"];
             constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
         };
         get contacts(): {
@@ -4077,25 +4208,44 @@ declare const useG8: () => {
             }>;
         };
         get objects(): {
-            list(): Promise<{
+            list(params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObject[];
             }>;
+            create(input: CreateCustomObject): Promise<CustomObject>;
+            update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+            archive(objectSlug: string): Promise<CustomObject>;
             get(objectSlug: string): Promise<CustomObject>;
-            listAttributes(objectSlug: string): Promise<{
+            listAttributes(objectSlug: string, params?: {
+                include_archived?: boolean;
+            }): Promise<{
                 data: CustomObjectAttribute[];
             }>;
+            createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+            archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
             listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
                 data: CustomObjectRecord[];
                 pagination?: ObjectPagination;
             }>;
             createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
+            upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+                expectedRevision?: number;
+            }): Promise<CustomObjectRecord>;
             getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
                 expectedRevision?: number;
+                appendValues?: Record<string, unknown[]>;
+                removeValues?: Record<string, unknown[]>;
             }): Promise<CustomObjectRecord>;
             archiveRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             restoreRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
             history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+            changes(objectSlug: string, recordId: string, options?: {
+                limit?: number;
+                cursor?: string;
+            }): Promise<CustomObjectMutations>;
         };
         get deals(): {
             pipelines(): Promise<{