@rippling/rippling-sdk 0.2.0-alpha.79 → 0.2.0-alpha.81

package/resources/teams.d.ts

@@ -15,10 +15,22 @@ export declare class Teams extends APIResource {
      * - Sortable fields: `id`, `created_at`, `updated_at`
      */
     list(query?: TeamListParams | null | undefined, options?: RequestOptions): PagePromise<TeamsPageCursorURL, Team>;
+    /**
+     * Create a new team
+     */
+    create(body: TeamCreateParams, options?: RequestOptions): APIPromise<Team>;
     /**
      * Retrieve a specific team
      */
     retrieve(id: string, query?: TeamRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<TeamRetrieveResponse>;
+    /**
+     * Update a specific team.
+     */
+    update(id: string, body?: TeamUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Team>;
+    /**
+     * Delete a team
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
 }
 export type TeamsPageCursorURL = PageCursorURL<Team>;
 export interface Team {
@@ -59,10 +71,30 @@ export interface TeamListParams {
     expand?: string;
     order_by?: string;
 }
+export interface TeamCreateParams {
+    /**
+     * The name of the team.
+     */
+    name: string;
+    /**
+     * The parent team
+     */
+    parent_id?: string;
+}
 export interface TeamRetrieveParams {
     expand?: string;
 }
+export interface TeamUpdateParams {
+    /**
+     * The name of the team.
+     */
+    name?: string;
+    /**
+     * The parent team
+     */
+    parent_id?: string;
+}
 export declare namespace Teams {
-    export { type Team as Team, type TeamRetrieveResponse as TeamRetrieveResponse, type TeamsPageCursorURL as TeamsPageCursorURL, type TeamListParams as TeamListParams, type TeamRetrieveParams as TeamRetrieveParams, };
+    export { type Team as Team, type TeamRetrieveResponse as TeamRetrieveResponse, type TeamsPageCursorURL as TeamsPageCursorURL, type TeamListParams as TeamListParams, type TeamCreateParams as TeamCreateParams, type TeamRetrieveParams as TeamRetrieveParams, type TeamUpdateParams as TeamUpdateParams, };
 }
 //# sourceMappingURL=teams.d.ts.map

package/resources/teams.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,mBAAmB,+BAA4B;AAC3D,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,8BAA2B;AAChE,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAIxC;;OAEG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;CAGpC;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB,CAAC,IAAI,EAAE,IAAI;CAAG;AAE/E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,KAAK,mBAAmB,+BAA4B;AAC3D,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,8BAA2B;AAEhE,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAIxC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAI1E;;OAEG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,kBAAkB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,oBAAoB,CAAC;IAInC;;OAEG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,IAAI,CAAC;IAInB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAM/D;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AAErD,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB,CAAC,IAAI,EAAE,IAAI;CAAG;AAE/E,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,IAAI,IAAI,IAAI,EACjB,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}

package/resources/teams.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Teams = void 0;
 const resource_1 = require("../core/resource.js");
 const pagination_1 = require("../core/pagination.js");
+const headers_1 = require("../internal/headers.js");
 const path_1 = require("../internal/utils/path.js");
 /**
  * Teams at the company
@@ -19,12 +20,33 @@ class Teams extends resource_1.APIResource {
     list(query = {}, options) {
         return this._client.getAPIList('/teams/', (pagination_1.PageCursorURL), { query, ...options });
     }
+    /**
+     * Create a new team
+     */
+    create(body, options) {
+        return this._client.post('/teams/', { body, ...options });
+    }
     /**
      * Retrieve a specific team
      */
     retrieve(id, query = {}, options) {
         return this._client.get((0, path_1.path) `/teams/${id}/`, { query, ...options });
     }
+    /**
+     * Update a specific team.
+     */
+    update(id, body = {}, options) {
+        return this._client.patch((0, path_1.path) `/teams/${id}/`, { body, ...options });
+    }
+    /**
+     * Delete a team
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/teams/${id}/`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
 }
 exports.Teams = Teams;
 //# sourceMappingURL=teams.js.map

package/resources/teams.js.map

@@ -1 +1 @@
-{"version":3,"file":"teams.js","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAgE;AAEhE,oDAA8C;AAE9C;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,0BAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAzBD,sBAyBC"}
+{"version":3,"file":"teams.js","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAAgE;AAChE,oDAAmD;AAEnD,oDAA8C;AAE9C;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,0BAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,EAAU,EACV,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,UAAU,EAAE,GAAG,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AArDD,sBAqDC"}

package/resources/teams.mjs

@@ -1,6 +1,7 @@
 // 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 { buildHeaders } from "../internal/headers.mjs";
 import { path } from "../internal/utils/path.mjs";
 /**
  * Teams at the company
@@ -16,11 +17,32 @@ export class Teams extends APIResource {
     list(query = {}, options) {
         return this._client.getAPIList('/teams/', (PageCursorURL), { query, ...options });
     }
+    /**
+     * Create a new team
+     */
+    create(body, options) {
+        return this._client.post('/teams/', { body, ...options });
+    }
     /**
      * Retrieve a specific team
      */
     retrieve(id, query = {}, options) {
         return this._client.get(path `/teams/${id}/`, { query, ...options });
     }
+    /**
+     * Update a specific team.
+     */
+    update(id, body = {}, options) {
+        return this._client.patch(path `/teams/${id}/`, { body, ...options });
+    }
+    /**
+     * Delete a team
+     */
+    delete(id, options) {
+        return this._client.delete(path `/teams/${id}/`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
 }
 //# sourceMappingURL=teams.mjs.map

package/resources/teams.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"teams.mjs","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,aAAa,EAAe,+BAA2B;AAEhE,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,aAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}
+{"version":3,"file":"teams.mjs","sourceRoot":"","sources":["../src/resources/teams.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,aAAa,EAAe,+BAA2B;AAChE,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAEnD,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;OAMG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,aAAmB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,EAAU,EACV,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,UAAU,EAAE,GAAG,EAAE;YAC9C,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/src/client.ts

@@ -445,9 +445,11 @@ import {
 import { SSOMe, SSOMeListParams, SSOMeResource } from './resources/sso-me';
 import {
   Team,
+  TeamCreateParams,
   TeamListParams,
   TeamRetrieveParams,
   TeamRetrieveResponse,
+  TeamUpdateParams,
   Teams,
   TeamsPageCursorURL,
 } from './resources/teams';
@@ -1880,7 +1882,9 @@ export declare namespace RipplingSDK {
     type TeamRetrieveResponse as TeamRetrieveResponse,
     type TeamsPageCursorURL as TeamsPageCursorURL,
     type TeamListParams as TeamListParams,
+    type TeamCreateParams as TeamCreateParams,
     type TeamRetrieveParams as TeamRetrieveParams,
+    type TeamUpdateParams as TeamUpdateParams,
   };
 
   export {

package/src/lib/manifest/agent.ts

@@ -0,0 +1,141 @@
+import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
+import type { ManifestScope } from './manifest-builder';
+import type { CustomSkill } from './custom-skill';
+import { requireArrayComponentField, requireStringComponentField } from './_existing-component-fields';
+
+export type AgentIdentityMode = 'runner' | 'user';
+
+export interface AgentSourceFile {
+  path: string;
+  content: string;
+  kind: string;
+}
+
+/**
+ * Initialization properties for {@link Agent}.
+ */
+export interface AgentProps {
+  /** Stable system name for this agent. */
+  apiName: string;
+  /** Display name shown in Rippling. */
+  name: string;
+  /** Human-readable description of the agent. */
+  description?: string;
+  /** Identity used when the agent runs. Defaults to `runner`. */
+  identityMode?: AgentIdentityMode;
+  /** Role used when `identityMode` is `user`. */
+  identityRoleId?: string;
+  /** Source files for the agent's latest revision. */
+  files: AgentSourceFile[];
+  /** Path of the source file that starts the agent. */
+  entrypoint: string;
+  /** Existing Custom Skills included in the agent's latest revision. */
+  skills?: CustomSkill[];
+}
+
+/**
+ * Defines an agent and its latest source revision in a single manifest component.
+ *
+ * Reinstalling a component with the same `apiName` updates the agent metadata and
+ * creates a new source revision when its source or skills change.
+ */
+export class Agent {
+  static readonly componentType = 'AGENT' as const;
+
+  private readonly _apiName: string;
+  private _name: string;
+  private _description: string | undefined;
+  private _identityMode: AgentIdentityMode | undefined;
+  private _identityRoleId: string | undefined;
+  private _files: AgentSourceFile[];
+  private _entrypoint: string;
+  private _skills: CustomSkill[] | undefined;
+
+  constructor(scope: ManifestScope, props: AgentProps) {
+    this._apiName = props.apiName;
+    this._name = props.name;
+    this._description = props.description;
+    this._identityMode = props.identityMode;
+    this._identityRoleId = props.identityRoleId;
+    this._files = props.files;
+    this._entrypoint = props.entrypoint;
+    this._skills = props.skills == null ? undefined : [...props.skills];
+    scope._register(this);
+  }
+
+  /** Loads this agent from the active existing-manifest JSON context. */
+  static loadFromExisting(apiName: string, options: ExistingManifestContextOptions = {}): Agent {
+    return getExistingManifestContext(options).loadAgent(apiName);
+  }
+
+  /** @internal Hydrates an agent from existing manifest wire JSON. */
+  static _fromExistingComponent(
+    scope: ManifestScope,
+    component: Record<string, any>,
+    resolveSkill: (sourceSkillId: string) => CustomSkill,
+  ): Agent {
+    const props: AgentProps = {
+      apiName: requireStringComponentField(component, 'api_name', Agent.componentType),
+      name: requireStringComponentField(component, 'name', Agent.componentType),
+      files: component['files'] ?? [],
+      entrypoint: requireStringComponentField(component, 'entrypoint', Agent.componentType),
+    };
+    if (component['description'] !== undefined) props.description = component['description'];
+    if (component['identity_mode'] !== undefined) props.identityMode = component['identity_mode'];
+    if (component['identity_role_id'] !== undefined) props.identityRoleId = component['identity_role_id'];
+    if (component['skill_ids'] !== undefined) {
+      props.skills = requireArrayComponentField<string>(component, 'skill_ids', Agent.componentType).map(
+        resolveSkill,
+      );
+    }
+    return new Agent(scope, props);
+  }
+
+  getApiName(): string {
+    return this._apiName;
+  }
+
+  setName(name: string): this {
+    this._name = name;
+    return this;
+  }
+
+  setDescription(description: string): this {
+    this._description = description;
+    return this;
+  }
+
+  setIdentity(identityMode: AgentIdentityMode, identityRoleId?: string): this {
+    this._identityMode = identityMode;
+    this._identityRoleId = identityRoleId;
+    return this;
+  }
+
+  setSource(files: AgentSourceFile[], entrypoint: string): this {
+    this._files = files;
+    this._entrypoint = entrypoint;
+    return this;
+  }
+
+  setSkills(skills: CustomSkill[]): this {
+    this._skills = [...skills];
+    return this;
+  }
+
+  toDict(): Record<string, any> {
+    const component: Record<string, any> = {
+      type: Agent.componentType,
+      api_name: this._apiName,
+      name: this._name,
+      files: this._files,
+      entrypoint: this._entrypoint,
+    };
+    if (this._description !== undefined) component['description'] = this._description;
+    if (this._identityMode !== undefined) component['identity_mode'] = this._identityMode;
+    if (this._identityRoleId !== undefined) component['identity_role_id'] = this._identityRoleId;
+    if (this._skills !== undefined) {
+      component['skill_ids'] = this._skills.map((skill) => skill.getSourceSkillId());
+    }
+    return component;
+  }
+}

package/src/lib/manifest/custom-field.ts

@@ -86,7 +86,7 @@ type NonSensitiveCustomFieldPermissionClassification = Exclude<
 >;
 
 /** Permission properties required for every Employee custom field. */
-export type EmployeeCustomFieldPermissionProps = { applicableGroup: string } & (
+export type EmployeeCustomFieldPermissionProps = { applicableGroupId: string } & (
   | {
       fieldReadAccess: 'ALL_ACCESS';
       fieldPermissionClassification: NonSensitiveCustomFieldPermissionClassification;
@@ -101,7 +101,7 @@ export type EmployeeCustomFieldPermissionProps = { applicableGroup: string } & (
 export interface NonEmployeeCustomFieldPermissionProps {
   fieldPermissionClassification?: CustomFieldPermissionClassification | null;
   fieldReadAccess?: CustomFieldReadAccess | null;
-  applicableGroup?: string | null;
+  applicableGroupId?: string | null;
 }
 
 export type CustomFieldPermissionProps<ModelRqlName extends string = string> =
@@ -236,7 +236,7 @@ export class CustomField<const ModelRqlName extends string = string> {
       fieldPermissionClassification?: CustomFieldPermissionClassification | null;
       fieldReadAccess?: CustomFieldReadAccess | null;
       fieldWriteAccess?: CustomFieldWriteAccess | null;
-      applicableGroup?: string | null;
+      applicableGroupId?: string | null;
       collectDuring?: CustomFieldCollectionTiming | null;
       rqlDefinitionFormula?: string | null;
     };
@@ -257,11 +257,11 @@ export class CustomField<const ModelRqlName extends string = string> {
         runtimeProps.fieldPermissionClassification == null ||
         runtimeProps.fieldReadAccess == null ||
         runtimeProps.fieldWriteAccess == null ||
-        runtimeProps.applicableGroup == null
+        runtimeProps.applicableGroupId == null
       ) {
         throw new Error(
           `Employee custom field "${props.apiName}" requires fieldPermissionClassification, ` +
-            `fieldReadAccess, fieldWriteAccess, and applicableGroup.`,
+            `fieldReadAccess, fieldWriteAccess, and applicableGroupId.`,
         );
       }
       if (
@@ -307,10 +307,10 @@ export class CustomField<const ModelRqlName extends string = string> {
     const dataType = requireObjectComponentField(component, 'data_type', CustomField.componentType);
     const defaultValue = component['default_value'] as Record<string, any> | null | undefined;
     const formula = component['rql_definition_formula'];
-    const applicableGroup =
-      component['applicable_group'] == null ?
+    const applicableGroupId =
+      component['applicable_group_id'] == null ?
         null
-      : requireObjectComponentField(component, 'applicable_group', CustomField.componentType);
+      : requireStringComponentField(component, 'applicable_group_id', CustomField.componentType);
     const common = {
       fieldId: requireStringComponentField(component, 'obj_id', CustomField.componentType),
       name: requireStringComponentField(component, 'name', CustomField.componentType),
@@ -330,10 +330,7 @@ export class CustomField<const ModelRqlName extends string = string> {
       fieldReadAccess: (component['field_read_access'] as CustomFieldReadAccess | null | undefined) ?? null,
       fieldWriteAccess:
         (component['field_write_access'] as CustomFieldWriteAccess | null | undefined) ?? null,
-      applicableGroup:
-        applicableGroup == null ? null : (
-          requireStringComponentField(applicableGroup, 'me_obj_id', CustomField.componentType)
-        ),
+      applicableGroupId,
       description: (component['description'] as string | null | undefined) ?? null,
       displayOrder: (component['display_order'] as number | null | undefined) ?? null,
     };
@@ -403,7 +400,7 @@ export class CustomField<const ModelRqlName extends string = string> {
       field_read_access: this.props.fieldReadAccess ?? null,
       field_write_access: this.props.fieldWriteAccess ?? null,
       collect_during: this.props.collectDuring ?? null,
-      applicable_group: this.props.applicableGroup ?? null,
+      applicable_group_id: this.props.applicableGroupId ?? null,
       description: this.props.description ?? null,
       required: this.props.required ?? null,
       tip: this.props.tip ?? null,

package/src/lib/manifest/custom-skill.ts

@@ -0,0 +1,205 @@
+import { generateId } from './_helpers';
+import { getExistingManifestContext, type ExistingManifestContextOptions } from './existing-manifest-context';
+import type { ManifestComponentDeletion, ManifestScope } from './manifest-builder';
+import { requireStringComponentField } from './_existing-component-fields';
+
+export type CustomSkillStatus = 'active' | 'inactive';
+export type CustomSkillSourceType = 'user' | 'company';
+
+/**
+ * Initialization properties for {@link CustomSkill}.
+ */
+export interface CustomSkillProps {
+  /**
+   * Source-side identifier for this Custom Skill.
+   *
+   * For a new skill, omit this field and the SDK generates a temporary handle
+   * that Composer maps to the skill's generated database UUID during deploy.
+   *
+   * For an existing skill, use the `source_skill_id` loaded from component
+   * search/extraction.
+   *
+   * Optional. Auto-generated when omitted. @default generateId('skill')
+   */
+  sourceSkillId?: string;
+  /**
+   * Display name shown in Rippling AI.
+   *
+   * Required.
+   */
+  name: string;
+  /**
+   * Description used to explain when the skill applies.
+   *
+   * Required. Use `null` to clear this field when updating an existing skill.
+   */
+  description: string | null;
+  /**
+   * Markdown instruction content for the skill.
+   *
+   * Required.
+   */
+  content: string;
+  /**
+   * Optional folder path for organizing skills. Use `null` to clear this field
+   * when updating an existing skill.
+   */
+  path?: string | null;
+  /**
+   * Whether the skill is active or inactive.
+   *
+   * Required.
+   */
+  status: CustomSkillStatus;
+  /**
+   * Skill visibility. `user` creates a personal skill; `company` creates a
+   * company skill.
+   *
+   * Optional create-time visibility. Do not set when updating an existing
+   * skill; use `CustomSkill.loadFromExisting(...)` so the extracted value can
+   * round-trip unchanged.
+   */
+  sourceType?: CustomSkillSourceType;
+}
+
+/**
+ * Defines a Rippling AI Custom Skill and registers it with the manifest.
+ */
+export class CustomSkill {
+  static readonly componentType = 'CUSTOM_SKILL' as const;
+
+  static toDeletionIdentifier(sourceSkillId: string): ManifestComponentDeletion {
+    return {
+      type: CustomSkill.componentType,
+      source_skill_id: sourceSkillId,
+    };
+  }
+
+  private readonly _sourceSkillId: string;
+  private _name: string;
+  private _description: string | null | undefined;
+  private _content: string;
+  private _path: string | null | undefined;
+  private _status: CustomSkillStatus;
+  private _sourceType: CustomSkillSourceType | undefined;
+
+  /**
+   * @param scope - The manifest to register this skill with.
+   * @param props - Initialization properties.
+   */
+  constructor(scope: ManifestScope, props: CustomSkillProps) {
+    if (props.sourceSkillId != null && props.sourceType != null) {
+      throw new Error(
+        'CustomSkill sourceType is create-time only. Omit sourceType when constructing an existing skill; ' +
+          'use CustomSkill.loadFromExisting(...) to update extracted skills.',
+      );
+    }
+    this._sourceSkillId = props.sourceSkillId ?? generateId('skill');
+    this._name = props.name;
+    this._description = props.description;
+    this._content = props.content;
+    this._path = props.path;
+    this._status = props.status;
+    this._sourceType = props.sourceType;
+    scope._register(this);
+  }
+
+  /**
+   * Loads this skill from the active existing-manifest JSON context.
+   */
+  static loadFromExisting(sourceSkillId: string, options: ExistingManifestContextOptions = {}): CustomSkill {
+    return getExistingManifestContext(options).loadCustomSkill(sourceSkillId);
+  }
+
+  /** @internal Hydrates a custom skill from existing manifest wire JSON. */
+  static _fromExistingComponent(scope: ManifestScope, component: Record<string, any>): CustomSkill {
+    const props: CustomSkillProps = {
+      sourceSkillId: requireStringComponentField(component, 'source_skill_id', CustomSkill.componentType),
+      name: requireStringComponentField(component, 'name', CustomSkill.componentType),
+      description:
+        component['description'] == null ?
+          null
+        : requireStringComponentField(component, 'description', CustomSkill.componentType),
+      content: requireStringComponentField(component, 'content', CustomSkill.componentType),
+      status: requireStringComponentField(
+        component,
+        'status',
+        CustomSkill.componentType,
+      ) as CustomSkillStatus,
+    };
+    if (typeof component['path'] === 'string') props.path = component['path'];
+    if (typeof component['source_type'] === 'string') {
+      props.sourceType = component['source_type'] as CustomSkillSourceType;
+    }
+    const { sourceType, ...loadProps } = props;
+    const skill = new CustomSkill(scope, loadProps);
+    skill._sourceType = sourceType;
+    return skill;
+  }
+
+  /**
+   * Returns this skill's source-side manifest identifier. New skills use a
+   * generated temporary handle; extracted skills use their database UUID.
+   */
+  getSourceSkillId(): string {
+    return this._sourceSkillId;
+  }
+
+  /**
+   * Replaces the display name for this skill.
+   */
+  setName(name: string): this {
+    this._name = name;
+    return this;
+  }
+
+  /**
+   * Replaces the description for this skill. Pass `null` to clear it.
+   */
+  setDescription(description: string | null): this {
+    this._description = description;
+    return this;
+  }
+
+  /**
+   * Replaces the plaintext markdown instruction content for this skill.
+   */
+  setContent(content: string): this {
+    this._content = content;
+    return this;
+  }
+
+  /**
+   * Replaces the optional folder path for this skill. Pass `null` to clear it,
+   * or `undefined` to omit it from the serialized manifest.
+   */
+  setPath(path: string | null | undefined): this {
+    this._path = path;
+    return this;
+  }
+
+  /**
+   * Replaces whether this skill is active or inactive.
+   */
+  setStatus(status: CustomSkillStatus): this {
+    this._status = status;
+    return this;
+  }
+
+  /**
+   * Serializes this skill to the wire format consumed by the manifest install endpoint.
+   */
+  toDict(): Record<string, any> {
+    const component: Record<string, any> = {
+      type: CustomSkill.componentType,
+      source_skill_id: this._sourceSkillId,
+      name: this._name,
+      content: this._content,
+      status: this._status,
+    };
+    if (this._description !== undefined) component['description'] = this._description;
+    if (this._path !== undefined) component['path'] = this._path;
+    if (this._sourceType != null) component['source_type'] = this._sourceType;
+    return component;
+  }
+}