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

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

@@ -1,4 +1,5 @@
 import { App } from './app';
+import { Agent } from './agent';
 import { Category } from './category';
 import { CustomField } from './custom-field';
 import { CustomFieldSection } from './custom-field-section';
@@ -6,6 +7,7 @@ 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 { CustomSkill } from './custom-skill';
 import { Field } from './field';
 import { ListViewDef } from './list-view';
 import { ManifestBuilder, type ManifestComponent } from './manifest-builder';
@@ -85,6 +87,7 @@ function componentLabel(component: Record<string, any>): string {
     component['rule_id'] ??
     component['flow_id'] ??
     component['sdui_page_id'] ??
+    component['source_skill_id'] ??
     component['field_api_name'] ??
     component['section_id'] ??
     'unknown';
@@ -305,6 +308,15 @@ export class ExistingManifestContext {
     return this.loadFunctionComponent(component);
   }
 
+  loadCustomSkill(sourceSkillId: string): CustomSkill {
+    const component = this.findUnique(
+      'CUSTOM_SKILL',
+      (candidate) => candidate['source_skill_id'] === sourceSkillId,
+      `CUSTOM_SKILL ${sourceSkillId}`,
+    );
+    return this.loadCustomSkillComponent(component);
+  }
+
   loadSduiPage(sduiPageId: string): SduiPage {
     const component = this.findUnique(
       'SDUI_PAGE',
@@ -323,8 +335,19 @@ export class ExistingManifestContext {
     return this.loadAppComponent(component);
   }
 
+  loadAgent(apiName: string): Agent {
+    const component = this.findUnique(
+      'AGENT',
+      (candidate) => candidate['api_name'] === apiName,
+      `AGENT ${apiName}`,
+    );
+    return this.loadAgentComponent(component);
+  }
+
   private loadComponent(component: Record<string, any>): unknown {
     switch (component['type']) {
+      case 'AGENT':
+        return this.loadAgentComponent(component);
       case 'CUSTOM_CATEGORY':
         return this.loadCategoryComponent(component);
       case 'CUSTOM_OBJECT':
@@ -347,6 +370,8 @@ export class ExistingManifestContext {
         return this.loadValidationComponent(component);
       case 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW':
         return this.loadRuleComponent(component);
+      case 'CUSTOM_SKILL':
+        return this.loadCustomSkillComponent(component);
       case 'FUNCTION':
         return this.loadFunctionComponent(component);
       case 'SDUI_PAGE':
@@ -538,6 +563,18 @@ export class ExistingManifestContext {
     );
   }
 
+  private loadCustomSkillComponent(component: Record<string, any>): CustomSkill {
+    const sourceSkillId = requireStringComponentField(
+      component,
+      'source_skill_id',
+      CustomSkill.componentType,
+    );
+    const cacheKey = this.cacheKey('CUSTOM_SKILL', sourceSkillId);
+    return this.getOrLoad(cacheKey, () =>
+      CustomSkill._fromExistingComponent(this.getManifestBuilder(), component),
+    );
+  }
+
   private loadSduiPageComponent(component: Record<string, any>): SduiPage {
     const sduiPageId = requireStringComponentField(component, 'sdui_page_id', SduiPage.componentType);
     const cacheKey = this.cacheKey('SDUI_PAGE', sduiPageId);
@@ -557,6 +594,16 @@ export class ExistingManifestContext {
     });
   }
 
+  private loadAgentComponent(component: Record<string, any>): Agent {
+    const apiName = requireStringComponentField(component, 'api_name', Agent.componentType);
+    const cacheKey = this.cacheKey('AGENT', apiName);
+    return this.getOrLoad(cacheKey, () =>
+      Agent._fromExistingComponent(this.getManifestBuilder(), component, (sourceSkillId) =>
+        this.loadRequiredCustomSkillForAgent(sourceSkillId, apiName),
+      ),
+    );
+  }
+
   private loadRawComponent(component: Record<string, any>): ExistingRawComponent {
     const index = this.componentIndexes.get(component) ?? -1;
     const cacheKey = this.cacheKey('RAW', `${index}:${componentLabel(component)}`);
@@ -648,6 +695,20 @@ export class ExistingManifestContext {
     return this.loadFunctionComponent(functionComponent);
   }
 
+  private loadRequiredCustomSkillForAgent(sourceSkillId: string, agentApiName: string): CustomSkill {
+    const skillComponent = this.ofType('CUSTOM_SKILL').find(
+      (candidate) => candidate['source_skill_id'] === sourceSkillId,
+    );
+    if (skillComponent == null) {
+      throw new Error(
+        `AGENT ${agentApiName} references CUSTOM_SKILL ${sourceSkillId}, ` +
+          'but that custom skill component is not present. Pass the full existing component extraction ' +
+          'to ManifestBuilder.loadFromExistingJson(...).',
+      );
+    }
+    return this.loadCustomSkillComponent(skillComponent);
+  }
+
   private loadSyntheticFieldReference(customObjectApiName: string, fieldApiName: string): Field {
     const cacheKey = this.cacheKey('CUSTOM_OBJECT_FIELD_REF', `${customObjectApiName}.${fieldApiName}`);
     return this.getOrLoad(cacheKey, () => Field._syntheticReference(customObjectApiName, fieldApiName));

package/src/lib/manifest/index.ts

@@ -1,5 +1,7 @@
 /** Manifest builder public API (hand-written, not Stainless-generated). */
 
+export { Agent, type AgentIdentityMode, type AgentProps, type AgentSourceFile } from './agent';
+
 export {
   generateId,
   type EdgeType,
@@ -58,6 +60,13 @@ export {
   type IconConfig,
 } from './custom-object';
 
+export {
+  CustomSkill,
+  type CustomSkillProps,
+  type CustomSkillSourceType,
+  type CustomSkillStatus,
+} from './custom-skill';
+
 export {
   CustomObjectFieldSection,
   type CustomObjectFieldSectionLoadFromExistingOptions,

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

@@ -14,6 +14,7 @@ export interface ManifestComponent {
  * Wire-level component types supported by the manifest builder.
  */
 export type ManifestComponentType =
+  | 'AGENT'
   | 'CUSTOM_APP'
   | 'CUSTOM_CATEGORY'
   | 'CUSTOM_FIELD_SECTION'
@@ -26,6 +27,7 @@ export type ManifestComponentType =
   | 'CUSTOM_OBJECT_PAGE_LAYOUT'
   | 'CUSTOM_OBJECT_RECORD_TRIGGERED_FLOW'
   | 'CUSTOM_OBJECT_VALIDATION_RULE'
+  | 'CUSTOM_SKILL'
   | 'FUNCTION'
   | 'SDUI_PAGE'
   | 'WORKFLOW_DEFINITION';

package/src/resources/index.ts

@@ -462,7 +462,9 @@ export {
   type Team,
   type TeamRetrieveResponse,
   type TeamListParams,
+  type TeamCreateParams,
   type TeamRetrieveParams,
+  type TeamUpdateParams,
   type TeamsPageCursorURL,
 } from './teams';
 export {

package/src/resources/leave-program-evaluations.ts

@@ -26,9 +26,9 @@ export interface LeaveProgramEvaluationCreateResponse {
   leave_plan: unknown;
 
   /**
-   * Distinct evidence gaps reported by evaluated eligibility rules.
+   * Structured evidence gaps reported by evaluated eligibility rules.
    */
-  missing_evidence: Array<string>;
+  missing_evidence: Array<LeaveProgramEvaluationCreateResponse.MissingEvidence>;
 
   /**
    * Per-program rule outputs in evaluation order.
@@ -36,6 +36,30 @@ export interface LeaveProgramEvaluationCreateResponse {
   program_results: Array<unknown>;
 }
 
+export namespace LeaveProgramEvaluationCreateResponse {
+  export interface MissingEvidence {
+    /**
+     * Expected answer type for this evidence key.
+     */
+    answer_type: string;
+
+    /**
+     * Stable evidence key that can be supplied in supplemental_evidence.
+     */
+    key: string;
+
+    /**
+     * Human-readable label for the missing evidence.
+     */
+    label: string;
+
+    /**
+     * Leave program codes that reported this missing evidence.
+     */
+    program_codes: Array<string>;
+  }
+}
+
 export interface LeaveProgramEvaluationCreateParams {
   /**
    * Requested leave start date.
@@ -63,6 +87,12 @@ export interface LeaveProgramEvaluationCreateParams {
    */
   child_entered_family_date?: string;
 
+  /**
+   * Demo/test-company only evidence overrides for exercising eligibility scenarios
+   * when the role's real data would not qualify.
+   */
+  evidence_override?: unknown;
+
   /**
    * Optional parental leave relationship type for parental leave programs.
    */
@@ -78,6 +108,12 @@ export interface LeaveProgramEvaluationCreateParams {
    * program runs in dependency order.
    */
   program_codes?: Array<string>;
+
+  /**
+   * Answers for evidence keys returned in missing_evidence. These answers only fill
+   * facts that the evaluation reported as missing.
+   */
+  supplemental_evidence?: unknown;
 }
 
 export declare namespace LeaveProgramEvaluations {

package/src/resources/teams.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../core/resource';
 import * as BusinessPartnersAPI from './business-partners';
 import { APIPromise } from '../core/api-promise';
 import { PageCursorURL, PagePromise } from '../core/pagination';
+import { buildHeaders } from '../internal/headers';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
@@ -25,6 +26,13 @@ export class Teams extends APIResource {
     return this._client.getAPIList('/teams/', PageCursorURL<Team>, { query, ...options });
   }
 
+  /**
+   * Create a new team
+   */
+  create(body: TeamCreateParams, options?: RequestOptions): APIPromise<Team> {
+    return this._client.post('/teams/', { body, ...options });
+  }
+
   /**
    * Retrieve a specific team
    */
@@ -35,6 +43,27 @@ export class Teams extends APIResource {
   ): APIPromise<TeamRetrieveResponse> {
     return this._client.get(path`/teams/${id}/`, { query, ...options });
   }
+
+  /**
+   * Update a specific team.
+   */
+  update(
+    id: string,
+    body: TeamUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Team> {
+    return this._client.patch(path`/teams/${id}/`, { body, ...options });
+  }
+
+  /**
+   * Delete a team
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/teams/${id}/`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 export type TeamsPageCursorURL = PageCursorURL<Team>;
@@ -86,16 +115,42 @@ export interface TeamListParams {
   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 TeamCreateParams as TeamCreateParams,
     type TeamRetrieveParams as TeamRetrieveParams,
+    type TeamUpdateParams as TeamUpdateParams,
   };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.0-alpha.79'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.81'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.79";
+export declare const VERSION = "0.2.0-alpha.81";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0-alpha.79";
+export declare const VERSION = "0.2.0-alpha.81";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.2.0-alpha.79'; // x-release-please-version
+exports.VERSION = '0.2.0-alpha.81'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.0-alpha.79'; // x-release-please-version
+export const VERSION = '0.2.0-alpha.81'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map