@rippling/rippling-sdk 0.2.0-alpha.73 → 0.2.0-alpha.75

package/resources/worker-changes.d.ts

@@ -0,0 +1,267 @@
+import { APIResource } from "../core/resource.js";
+import * as BusinessPartnersAPI from "./business-partners.js";
+import * as WorkersAPI from "./workers.js";
+import { APIPromise } from "../core/api-promise.js";
+import { PageCursorURL, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Historical changes to worker data over time
+ */
+export declare class WorkerChanges extends APIResource {
+    /**
+     * A list of worker changes.
+     *
+     * - Requires: `Worker Changes API`
+     * - Filterable fields: `worker_id`, `applied_on`, `effective_on`, `changed_by_id`,
+     *   `reason_code`, `field_key`, `event_type`
+     * - Expandable fields: `worker`, `changed_by`
+     * - Sortable fields: `id`, `created_at`, `updated_at`, `applied_on`,
+     *   `effective_on`
+     */
+    list(query?: WorkerChangeListParams | null | undefined, options?: RequestOptions): PagePromise<WorkerChangeListResponsesPageCursorURL, WorkerChangeListResponse>;
+    /**
+     * Retrieve a specific worker change
+     */
+    retrieve(id: string, query?: WorkerChangeRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<WorkerChangeRetrieveResponse>;
+}
+export type WorkerChangeListResponsesPageCursorURL = PageCursorURL<WorkerChangeListResponse>;
+export interface WorkerChangeListResponse {
+    /**
+     * Identifier field
+     */
+    id: string;
+    /**
+     * When the change was persisted (approval time for changes that went through an
+     * approval workflow). UTC. Monotonically increasing as new commits land; use as
+     * the cursor axis for incremental polling.
+     */
+    applied_on: string;
+    /**
+     * Field-level changes captured by this event. Per-field REDACTED entries appear
+     * for fields the caller cannot read so consumers can detect that a change occurred
+     * even when the value is hidden. Events where every changed field is invisible to
+     * the caller — either internal fields not exposed via the public Object Graph, or
+     * fields the caller's role has zero read permission on — are dropped from the
+     * response entirely (they never appear with an all-REDACTED changes array).
+     */
+    changes: Array<WorkerChangeListResponse.Change>;
+    /**
+     * Record creation date
+     */
+    created_at: string;
+    /**
+     * When the change is true in the business domain. Can be past, present, or future.
+     * Independent of applied_on. UTC.
+     */
+    effective_on: string;
+    /**
+     * The lifecycle event type this change represents. CHANGE is the catch-all for
+     * non-lifecycle field edits.
+     */
+    event_type: 'HIRE' | 'CHANGE' | 'SCHEDULED_CHANGE' | 'OFFBOARD' | 'SCHEDULED_OFFBOARD' | 'IMPORT' | 'UNDO' | 'EFFECTIVE_DATE_AMENDMENT';
+    /**
+     * Record update date
+     */
+    updated_at: string;
+    /**
+     * The worker affected by this change.
+     */
+    worker_id: string;
+    /**
+     * The actor as the current Worker DTO. Returned only when expand=changed_by is
+     * requested.
+     *
+     * Expandable field
+     */
+    changed_by?: WorkersAPI.Worker;
+    /**
+     * Actor who made the change. Null for system-initiated events.
+     */
+    changed_by_id?: string;
+    /**
+     * INITIAL (census import at company onboarding) or HISTORICAL (historical data
+     * imported later). Set only when event_type is IMPORT.
+     */
+    import_type?: 'INITIAL' | 'HISTORICAL';
+    /**
+     * Structured transition reason (e.g. 'PROMOTION', 'MARKET_ADJUSTMENT'). Populated
+     * only when the company has configured transition reasons and the change went
+     * through a role transition with one selected. Null for most companies and events.
+     */
+    reason_code?: string;
+    /**
+     * For amendments or undos, the id of the worker-change event being modified.
+     */
+    referenced_transaction_id?: string;
+    /**
+     * The affected worker as the current Worker DTO. Returned only when expand=worker
+     * is requested. Includes terminated employees.
+     *
+     * Expandable field
+     */
+    worker?: WorkersAPI.Worker;
+}
+export declare namespace WorkerChangeListResponse {
+    interface Change {
+        /**
+         * VISIBLE or REDACTED. REDACTED means the caller's role lacks permission to read
+         * this field; from_value/to_value are null but the entry still appears so
+         * consumers know a change occurred.
+         */
+        display_type: 'VISIBLE' | 'REDACTED';
+        /**
+         * UI label for the field (English).
+         */
+        field_display_name: string;
+        /**
+         * Field key in snake_case.
+         */
+        field_key: string;
+        /**
+         * The underlying value type of this field. Populated regardless of display_type so
+         * consumers can interpret from_value / to_value or anticipate a future typed
+         * representation.
+         */
+        value_type: 'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'CURRENCY' | 'ENUM' | 'REFERENCE';
+        /**
+         * Value before the change, rendered as a display string (locale- and
+         * currency-formatted per the activity-log convention). Null when display_type is
+         * REDACTED. Typed JSON values are tracked as a future addition; consult value_type
+         * to interpret the rendering.
+         */
+        from_value?: string;
+        /**
+         * Value after the change, rendered as a display string. Null when display_type is
+         * REDACTED. See from_value for notes on typed-value plans.
+         */
+        to_value?: string;
+    }
+}
+/**
+ * Meta information for the response.
+ */
+export interface WorkerChangeRetrieveResponse extends BusinessPartnersAPI.Meta {
+    /**
+     * Identifier field
+     */
+    id: string;
+    /**
+     * When the change was persisted (approval time for changes that went through an
+     * approval workflow). UTC. Monotonically increasing as new commits land; use as
+     * the cursor axis for incremental polling.
+     */
+    applied_on: string;
+    /**
+     * Field-level changes captured by this event. Per-field REDACTED entries appear
+     * for fields the caller cannot read so consumers can detect that a change occurred
+     * even when the value is hidden. Events where every changed field is invisible to
+     * the caller — either internal fields not exposed via the public Object Graph, or
+     * fields the caller's role has zero read permission on — are dropped from the
+     * response entirely (they never appear with an all-REDACTED changes array).
+     */
+    changes: Array<WorkerChangeRetrieveResponse.Change>;
+    /**
+     * Record creation date
+     */
+    created_at: string;
+    /**
+     * When the change is true in the business domain. Can be past, present, or future.
+     * Independent of applied_on. UTC.
+     */
+    effective_on: string;
+    /**
+     * The lifecycle event type this change represents. CHANGE is the catch-all for
+     * non-lifecycle field edits.
+     */
+    event_type: 'HIRE' | 'CHANGE' | 'SCHEDULED_CHANGE' | 'OFFBOARD' | 'SCHEDULED_OFFBOARD' | 'IMPORT' | 'UNDO' | 'EFFECTIVE_DATE_AMENDMENT';
+    /**
+     * Record update date
+     */
+    updated_at: string;
+    /**
+     * The worker affected by this change.
+     */
+    worker_id: string;
+    /**
+     * The actor as the current Worker DTO. Returned only when expand=changed_by is
+     * requested.
+     *
+     * Expandable field
+     */
+    changed_by?: WorkersAPI.Worker;
+    /**
+     * Actor who made the change. Null for system-initiated events.
+     */
+    changed_by_id?: string;
+    /**
+     * INITIAL (census import at company onboarding) or HISTORICAL (historical data
+     * imported later). Set only when event_type is IMPORT.
+     */
+    import_type?: 'INITIAL' | 'HISTORICAL';
+    /**
+     * Structured transition reason (e.g. 'PROMOTION', 'MARKET_ADJUSTMENT'). Populated
+     * only when the company has configured transition reasons and the change went
+     * through a role transition with one selected. Null for most companies and events.
+     */
+    reason_code?: string;
+    /**
+     * For amendments or undos, the id of the worker-change event being modified.
+     */
+    referenced_transaction_id?: string;
+    /**
+     * The affected worker as the current Worker DTO. Returned only when expand=worker
+     * is requested. Includes terminated employees.
+     *
+     * Expandable field
+     */
+    worker?: WorkersAPI.Worker;
+}
+export declare namespace WorkerChangeRetrieveResponse {
+    interface Change {
+        /**
+         * VISIBLE or REDACTED. REDACTED means the caller's role lacks permission to read
+         * this field; from_value/to_value are null but the entry still appears so
+         * consumers know a change occurred.
+         */
+        display_type: 'VISIBLE' | 'REDACTED';
+        /**
+         * UI label for the field (English).
+         */
+        field_display_name: string;
+        /**
+         * Field key in snake_case.
+         */
+        field_key: string;
+        /**
+         * The underlying value type of this field. Populated regardless of display_type so
+         * consumers can interpret from_value / to_value or anticipate a future typed
+         * representation.
+         */
+        value_type: 'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATETIME' | 'CURRENCY' | 'ENUM' | 'REFERENCE';
+        /**
+         * Value before the change, rendered as a display string (locale- and
+         * currency-formatted per the activity-log convention). Null when display_type is
+         * REDACTED. Typed JSON values are tracked as a future addition; consult value_type
+         * to interpret the rendering.
+         */
+        from_value?: string;
+        /**
+         * Value after the change, rendered as a display string. Null when display_type is
+         * REDACTED. See from_value for notes on typed-value plans.
+         */
+        to_value?: string;
+    }
+}
+export interface WorkerChangeListParams {
+    cursor?: string;
+    expand?: string;
+    filter?: string;
+    order_by?: string;
+}
+export interface WorkerChangeRetrieveParams {
+    expand?: string;
+}
+export declare namespace WorkerChanges {
+    export { type WorkerChangeListResponse as WorkerChangeListResponse, type WorkerChangeRetrieveResponse as WorkerChangeRetrieveResponse, type WorkerChangeListResponsesPageCursorURL as WorkerChangeListResponsesPageCursorURL, type WorkerChangeListParams as WorkerChangeListParams, type WorkerChangeRetrieveParams as WorkerChangeRetrieveParams, };
+}
+//# sourceMappingURL=worker-changes.d.ts.map

package/resources/worker-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-changes.d.ts","sourceRoot":"","sources":["../src/resources/worker-changes.ts"],"names":[],"mappings":"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"}

package/resources/worker-changes.js

@@ -0,0 +1,36 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerChanges = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Historical changes to worker data over time
+ */
+class WorkerChanges extends resource_1.APIResource {
+    /**
+     * A list of worker changes.
+     *
+     * - Requires: `Worker Changes API`
+     * - Filterable fields: `worker_id`, `applied_on`, `effective_on`, `changed_by_id`,
+     *   `reason_code`, `field_key`, `event_type`
+     * - Expandable fields: `worker`, `changed_by`
+     * - Sortable fields: `id`, `created_at`, `updated_at`, `applied_on`,
+     *   `effective_on`
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/worker-changes/', (pagination_1.PageCursorURL), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Retrieve a specific worker change
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get((0, path_1.path) `/worker-changes/${id}/`, { query, ...options });
+    }
+}
+exports.WorkerChanges = WorkerChanges;
+//# sourceMappingURL=worker-changes.js.map

package/resources/worker-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-changes.js","sourceRoot":"","sources":["../src/resources/worker-changes.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,sDAAgE;AAEhE,oDAA8C;AAE9C;;GAEG;AACH,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;OASG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,0BAAuC,CAAA,EAAE;YAC1F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AA/BD,sCA+BC"}

package/resources/worker-changes.mjs

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { PageCursorURL } from "../core/pagination.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Historical changes to worker data over time
+ */
+export class WorkerChanges extends APIResource {
+    /**
+     * A list of worker changes.
+     *
+     * - Requires: `Worker Changes API`
+     * - Filterable fields: `worker_id`, `applied_on`, `effective_on`, `changed_by_id`,
+     *   `reason_code`, `field_key`, `event_type`
+     * - Expandable fields: `worker`, `changed_by`
+     * - Sortable fields: `id`, `created_at`, `updated_at`, `applied_on`,
+     *   `effective_on`
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/worker-changes/', (PageCursorURL), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Retrieve a specific worker change
+     */
+    retrieve(id, query = {}, options) {
+        return this._client.get(path `/worker-changes/${id}/`, { query, ...options });
+    }
+}
+//# sourceMappingURL=worker-changes.mjs.map

package/resources/worker-changes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-changes.mjs","sourceRoot":"","sources":["../src/resources/worker-changes.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,aAAa,EAAe,+BAA2B;AAEhE,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;OASG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,aAAuC,CAAA,EAAE;YAC1F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,mBAAmB,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/src/client.ts

@@ -515,6 +515,19 @@ import {
   WorkLocations,
   WorkLocationsPageCursorURL,
 } from './resources/work-locations';
+import {
+  WorkerChangeFieldListResponse,
+  WorkerChangeFieldListResponsesPageCursorURL,
+  WorkerChangeFields,
+} from './resources/worker-change-fields';
+import {
+  WorkerChangeListParams,
+  WorkerChangeListResponse,
+  WorkerChangeListResponsesPageCursorURL,
+  WorkerChangeRetrieveParams,
+  WorkerChangeRetrieveResponse,
+  WorkerChanges,
+} from './resources/worker-changes';
 import {
   WorkerTimeSplitCreateParams,
   WorkerTimeSplitCreateResponse,
@@ -1576,6 +1589,14 @@ export class RipplingSDK {
    * Unassigned shifts that are part of a schedule
    */
   unassignedshifts: API.Unassignedshifts = new API.Unassignedshifts(this);
+  /**
+   * Historical changes to worker data over time
+   */
+  workerChanges: API.WorkerChanges = new API.WorkerChanges(this);
+  /**
+   * Historical changes to worker data over time
+   */
+  workerChangeFields: API.WorkerChangeFields = new API.WorkerChangeFields(this);
   /**
    * Job related information for the company
    */
@@ -1661,6 +1682,8 @@ RipplingSDK.Shiftassignments = Shiftassignments;
 RipplingSDK.SoftwareDeployments = SoftwareDeployments;
 RipplingSDK.Titles = Titles;
 RipplingSDK.Unassignedshifts = Unassignedshifts;
+RipplingSDK.WorkerChanges = WorkerChanges;
+RipplingSDK.WorkerChangeFields = WorkerChangeFields;
 RipplingSDK.WorkerTimeSplits = WorkerTimeSplits;
 RipplingSDK.WorkflowActionExecutions = WorkflowActionExecutions;
 RipplingSDK.ShiftAssignments = ShiftAssignments;
@@ -2283,6 +2306,21 @@ export declare namespace RipplingSDK {
     type UnassignedshiftUpdateParams as UnassignedshiftUpdateParams,
   };
 
+  export {
+    WorkerChanges as WorkerChanges,
+    type WorkerChangeListResponse as WorkerChangeListResponse,
+    type WorkerChangeRetrieveResponse as WorkerChangeRetrieveResponse,
+    type WorkerChangeListResponsesPageCursorURL as WorkerChangeListResponsesPageCursorURL,
+    type WorkerChangeListParams as WorkerChangeListParams,
+    type WorkerChangeRetrieveParams as WorkerChangeRetrieveParams,
+  };
+
+  export {
+    WorkerChangeFields as WorkerChangeFields,
+    type WorkerChangeFieldListResponse as WorkerChangeFieldListResponse,
+    type WorkerChangeFieldListResponsesPageCursorURL as WorkerChangeFieldListResponsesPageCursorURL,
+  };
+
   export {
     WorkerTimeSplits as WorkerTimeSplits,
     type WorkerTimeSplitListResponse as WorkerTimeSplitListResponse,

package/src/lib/manifest/custom-object-action.ts

@@ -0,0 +1,100 @@
+import { generateId } from './_helpers';
+import type { CustomObject } from './custom-object';
+import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
+import type { ManifestComponentDeletion } from './manifest-builder';
+import type { ManifestFunction } from './manifest-function';
+import { requireArrayComponentField, requireStringComponentField } from './_existing-component-fields';
+
+export type CustomObjectActionVisibilityPreference = 'LIST_VIEW' | 'DETAIL_VIEW';
+
+export interface CustomObjectActionDeletionIdentifier {
+  actionId: string;
+  objectRqlName: string;
+}
+
+export interface CustomObjectActionProps {
+  /** Stable identifier for this action. Auto-generated when omitted. */
+  actionId?: string;
+  /** Display name shown in the list or detail view. */
+  name: string;
+  /** Function invoked by the action. */
+  function: ManifestFunction;
+  /** Views where the action is shown. */
+  visibilityPreferences: CustomObjectActionVisibilityPreference[];
+}
+
+export interface CustomObjectActionLoadFromExistingOptions extends ExistingManifestContextOptions {
+  customObjectApiName?: string;
+}
+
+/** Defines an action shown on a custom object's list or detail view. */
+export class CustomObjectAction {
+  static readonly componentType = 'CUSTOM_OBJECT_ACTION' as const;
+
+  static toDeletionIdentifier(identifier: CustomObjectActionDeletionIdentifier): ManifestComponentDeletion {
+    return {
+      type: CustomObjectAction.componentType,
+      action_id: identifier.actionId,
+      object_rql_name: identifier.objectRqlName,
+    };
+  }
+
+  private readonly _actionId: string;
+  private readonly _objectRqlName: string;
+  private readonly _name: string;
+  private readonly _functionApiName: string;
+  private readonly _visibilityPreferences: CustomObjectActionVisibilityPreference[];
+
+  constructor(customObject: CustomObject, props: CustomObjectActionProps) {
+    if (!props.name.trim()) throw new Error('CustomObjectAction: name cannot be empty');
+    this._actionId = props.actionId ?? generateId('action');
+    this._objectRqlName = customObject.getApiName();
+    this._name = props.name;
+    this._functionApiName = props.function.getApiName();
+    this._visibilityPreferences = [...props.visibilityPreferences];
+    customObject._register(this);
+  }
+
+  static loadFromExisting(
+    actionId: string,
+    options: CustomObjectActionLoadFromExistingOptions = {},
+  ): CustomObjectAction {
+    return getExistingManifestContext(options).loadCustomObjectAction(actionId, options);
+  }
+
+  /** @internal Hydrates an action from existing manifest wire JSON. */
+  static _fromExistingComponent(
+    customObject: CustomObject,
+    component: Record<string, any>,
+    resolveFunction: (apiName: string) => ManifestFunction,
+  ): CustomObjectAction {
+    return new CustomObjectAction(customObject, {
+      actionId: requireStringComponentField(component, 'action_id', CustomObjectAction.componentType),
+      name: requireStringComponentField(component, 'name', CustomObjectAction.componentType),
+      function: resolveFunction(
+        requireStringComponentField(component, 'function_api_name', CustomObjectAction.componentType),
+      ),
+      visibilityPreferences: requireArrayComponentField<CustomObjectActionVisibilityPreference>(
+        component,
+        'visibility_preferences',
+        CustomObjectAction.componentType,
+      ),
+    });
+  }
+
+  getActionId(): string {
+    return this._actionId;
+  }
+
+  toDict(): Record<string, any> {
+    return {
+      type: CustomObjectAction.componentType,
+      action_id: this._actionId,
+      object_rql_name: this._objectRqlName,
+      name: this._name,
+      function_api_name: this._functionApiName,
+      object_type: 'CUSTOM',
+      visibility_preferences: this._visibilityPreferences,
+    };
+  }
+}

package/src/lib/manifest/custom-object-page-layout.ts

@@ -8,7 +8,6 @@ import type {
 import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
 import type { Field } from './field';
 import type { ManifestComponentDeletion } from './manifest-builder';
-import type { ManifestFunction } from './manifest-function';
 import { requireStringComponentField } from './_existing-component-fields';
 
 export interface PageLayoutDeletionIdentifier {
@@ -25,7 +24,6 @@ export type HeaderFieldKey = string;
 export type FieldRqlName = string;
 export type RelatedObjectRqlName = string;
 export type CanvasCompositionId = string;
-type HeaderButtonKey = string;
 
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
@@ -88,8 +86,6 @@ export interface HeaderEdits {
   newFields?: NewHeaderField[];
   /** Ordered list of header field RQL names. Custom header keys are accepted and converted. Optional. */
   headerFieldsOrder?: FieldRqlName[];
-  /** Action functions to show in the header. Optional. */
-  buttons?: ManifestFunction[];
 }
 
 interface SerializedSystemHeaderFieldEdit extends Omit<SystemHeaderFieldEdit, 'newRqlField'> {
@@ -97,11 +93,10 @@ interface SerializedSystemHeaderFieldEdit extends Omit<SystemHeaderFieldEdit, 'n
 }
 
 interface SerializedHeaderEdits
-  extends Omit<HeaderEdits, 'newTitleField' | 'newDescriptionField' | 'systemFieldEdits' | 'buttons'> {
+  extends Omit<HeaderEdits, 'newTitleField' | 'newDescriptionField' | 'systemFieldEdits'> {
   newTitleField?: FieldRqlName | null;
   newDescriptionField?: FieldRqlName | null;
   systemFieldEdits?: Record<HeaderFieldKey, SerializedSystemHeaderFieldEdit>;
-  buttons?: HeaderButtonKey[];
 }
 
 // ---------------------------------------------------------------------------
@@ -562,7 +557,7 @@ export interface CustomObjectPageLayoutProps {
    */
   tabEdits?: TabEdits;
   /**
-   * Header configuration — title field, description field, and action buttons.
+   * Header configuration — title and description fields.
    *
    * Optional. @default `{}`
    */
@@ -905,7 +900,6 @@ const HEADER_EDIT_KEYS = new Set([
   'systemFieldEdits',
   'newFields',
   'headerFieldsOrder',
-  'buttons',
 ]);
 
 const SYSTEM_HEADER_FIELD_EDIT_KEYS = new Set(['newRqlField', 'deleted']);
@@ -972,9 +966,7 @@ function normalizeHeaderEdits(headerEdits: HeaderEdits): SerializedHeaderEdits {
     );
   }
 
-  const { buttons, ...rest } = headerEdits;
-  const normalized: SerializedHeaderEdits = { ...rest };
-  if (buttons != null) normalized.buttons = buttons.map((button) => button.getApiName());
+  const normalized: SerializedHeaderEdits = { ...headerEdits };
 
   if (headerEdits.headerFieldsOrder == null) return normalized;
   return {

package/src/lib/manifest/existing-manifest-context.ts

@@ -1,6 +1,7 @@
 import { App } from './app';
 import { Category } from './category';
 import { CustomObject } from './custom-object';
+import { CustomObjectAction } from './custom-object-action';
 import { CustomObjectFieldSection } from './custom-object-field-section';
 import { CustomObjectPageLayout } from './custom-object-page-layout';
 import { Field } from './field';
@@ -78,6 +79,7 @@ function componentLabel(component: Record<string, any>): string {
     component['api_name'] ??
     component['layout_id'] ??
     component['view_id'] ??
+    component['action_id'] ??
     component['rule_id'] ??
     component['flow_id'] ??
     component['sdui_page_id'] ??
@@ -223,6 +225,18 @@ export class ExistingManifestContext {
     return this.loadListViewComponent(component);
   }
 
+  loadCustomObjectAction(actionId: string, options: ExistingManifestObjectOptions = {}): CustomObjectAction {
+    const objectApiName = options.customObjectApiName;
+    const component = this.findUnique(
+      'CUSTOM_OBJECT_ACTION',
+      (candidate) =>
+        candidate['action_id'] === actionId &&
+        (objectApiName == null || candidate['object_rql_name'] === objectApiName),
+      `CUSTOM_OBJECT_ACTION ${objectApiName != null ? `${objectApiName}.` : ''}${actionId}`,
+    );
+    return this.loadCustomObjectActionComponent(component);
+  }
+
   loadPageLayout(
     layoutIdOrApiName: string,
     options: ExistingManifestObjectOptions = {},
@@ -295,6 +309,8 @@ export class ExistingManifestContext {
         return this.loadCategoryComponent(component);
       case 'CUSTOM_OBJECT':
         return this.loadCustomObjectComponent(component);
+      case 'CUSTOM_OBJECT_ACTION':
+        return this.loadCustomObjectActionComponent(component);
       case 'CUSTOM_OBJECT_FIELD_SECTION':
         return this.loadFieldSectionComponent(component);
       case 'CUSTOM_OBJECT_FIELD':
@@ -408,6 +424,21 @@ export class ExistingManifestContext {
     });
   }
 
+  private loadCustomObjectActionComponent(component: Record<string, any>): CustomObjectAction {
+    const objectApiName = requireStringComponentField(
+      component,
+      'object_rql_name',
+      CustomObjectAction.componentType,
+    );
+    const actionId = requireStringComponentField(component, 'action_id', CustomObjectAction.componentType);
+    const cacheKey = this.cacheKey('CUSTOM_OBJECT_ACTION', `${objectApiName}.${actionId}`);
+    return this.getOrLoad(cacheKey, () =>
+      CustomObjectAction._fromExistingComponent(this.loadCustomObject(objectApiName), component, (apiName) =>
+        this.loadFunction(apiName),
+      ),
+    );
+  }
+
   private loadPageLayoutComponent(component: Record<string, any>): CustomObjectPageLayout {
     const layoutId = requireStringComponentField(
       component,

package/src/lib/manifest/index.ts

@@ -144,6 +144,14 @@ export {
   type SummaryFieldProps,
 } from './field';
 
+export {
+  CustomObjectAction,
+  type CustomObjectActionDeletionIdentifier,
+  type CustomObjectActionLoadFromExistingOptions,
+  type CustomObjectActionProps,
+  type CustomObjectActionVisibilityPreference,
+} from './custom-object-action';
+
 export {
   ExistingManifestContext,
   type ExistingManifest,

package/src/lib/manifest/manifest-builder.ts

@@ -17,6 +17,7 @@ export type ManifestComponentType =
   | 'CUSTOM_APP'
   | 'CUSTOM_CATEGORY'
   | 'CUSTOM_OBJECT'
+  | 'CUSTOM_OBJECT_ACTION'
   | 'CUSTOM_OBJECT_FIELD'
   | 'CUSTOM_OBJECT_FIELD_SECTION'
   | 'CUSTOM_OBJECT_LIST_VIEW'