@rippling/rippling-sdk 0.2.0-alpha.78 → 0.2.0-alpha.80

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

@@ -68,38 +68,106 @@ export type CustomFieldDefaultValue =
   | { value: string; rqlDefinitionFormula?: never }
   | { value?: never; rqlDefinitionFormula: string };
 
-interface CustomFieldCommonProps {
+/** Properties shared by formula and user-input custom fields. */
+export interface CustomFieldBaseProps<ModelRqlName extends string = string> {
   fieldId?: string;
   name: string;
   section: CustomFieldSection;
-  modelRqlName: string;
+  modelRqlName: ModelRqlName;
   dataType: CustomFieldDataType;
   apiName: CustomFieldApiName;
+  description?: string | null;
+  displayOrder?: number | null;
+}
+
+type NonSensitiveCustomFieldPermissionClassification = Exclude<
+  CustomFieldPermissionClassification,
+  'SENSITIVE_PERSONAL_INFO' | 'SENSITIVE_EMPLOYMENT_INFO'
+>;
+
+/** Permission properties required for every Employee custom field. */
+export type EmployeeCustomFieldPermissionProps = { applicableGroup: string } & (
+  | {
+      fieldReadAccess: 'ALL_ACCESS';
+      fieldPermissionClassification: NonSensitiveCustomFieldPermissionClassification;
+    }
+  | {
+      fieldReadAccess: 'ADMIN_ACCESS' | 'ADMIN_AND_EMPLOYEE_ACCESS';
+      fieldPermissionClassification: CustomFieldPermissionClassification;
+    }
+);
+
+/** Optional permission properties used by non-Employee custom fields. */
+export interface NonEmployeeCustomFieldPermissionProps {
   fieldPermissionClassification?: CustomFieldPermissionClassification | null;
   fieldReadAccess?: CustomFieldReadAccess | null;
-  fieldWriteAccess?: CustomFieldWriteAccess | null;
   applicableGroup?: string | null;
-  description?: string | null;
-  displayOrder?: number | null;
 }
 
-export type CustomFieldProps = CustomFieldCommonProps &
-  (
-    | {
-        rqlDefinitionFormula: string;
-        collectDuring?: null;
-        required?: null;
-        tip?: null;
-        defaultValue?: null;
-      }
-    | {
-        rqlDefinitionFormula?: null;
-        collectDuring?: CustomFieldCollectionTiming | null;
-        required?: boolean | null;
-        tip?: string | null;
-        defaultValue?: CustomFieldDefaultValue | null;
-      }
-  );
+export type CustomFieldPermissionProps<ModelRqlName extends string = string> =
+  ModelRqlName extends 'Employee' ? EmployeeCustomFieldPermissionProps
+  : NonEmployeeCustomFieldPermissionProps;
+
+interface CustomFieldUserInputOptions {
+  rqlDefinitionFormula?: null;
+  required?: boolean | null;
+  tip?: string | null;
+  defaultValue?: CustomFieldDefaultValue | null;
+}
+
+type EmployeeCustomFieldUserInputAccess =
+  | {
+      collectDuring: 'ONBOARDING';
+      fieldReadAccess: 'ALL_ACCESS' | 'ADMIN_AND_EMPLOYEE_ACCESS';
+      fieldWriteAccess: 'EMPLOYEE_ACCESS' | 'ADMIN_AND_EMPLOYEE_ACCESS' | 'NO_ACCESS';
+    }
+  | {
+      collectDuring?: 'NONE' | 'HIRING' | 'TERMINATING' | null;
+      fieldWriteAccess: CustomFieldWriteAccess;
+    };
+
+interface NonEmployeeCustomFieldUserInputAccess {
+  collectDuring?: CustomFieldCollectionTiming | null;
+  fieldWriteAccess?: CustomFieldWriteAccess | null;
+}
+
+type CustomFieldUserInputAccess<ModelRqlName extends string> =
+  ModelRqlName extends 'Employee' ? EmployeeCustomFieldUserInputAccess
+  : NonEmployeeCustomFieldUserInputAccess;
+
+interface CustomFieldFormulaOptions {
+  rqlDefinitionFormula: string;
+  fieldWriteAccess: 'NO_ACCESS';
+  collectDuring?: null;
+  required?: null;
+  tip?: null;
+  defaultValue?: null;
+}
+
+/** A calculated custom field whose value cannot be edited directly. */
+export type FormulaCustomFieldProps<ModelRqlName extends string = string> =
+  CustomFieldBaseProps<ModelRqlName> & CustomFieldPermissionProps<ModelRqlName> & CustomFieldFormulaOptions;
+
+/** A custom field whose value is supplied by a user or a default value. */
+export type UserInputCustomFieldProps<ModelRqlName extends string = string> =
+  CustomFieldBaseProps<ModelRqlName> &
+    CustomFieldPermissionProps<ModelRqlName> &
+    CustomFieldUserInputOptions &
+    CustomFieldUserInputAccess<ModelRqlName>;
+
+/** A formula or user-input custom field on the given model. */
+export type CustomFieldProps<ModelRqlName extends string = string> =
+  | FormulaCustomFieldProps<ModelRqlName>
+  | UserInputCustomFieldProps<ModelRqlName>;
+
+/** A calculated Employee custom field. */
+export type EmployeeFormulaCustomFieldProps = FormulaCustomFieldProps<'Employee'>;
+
+/** An Employee custom field whose value is supplied by a user or a default value. */
+export type EmployeeUserInputCustomFieldProps = UserInputCustomFieldProps<'Employee'>;
+
+/** Any supported Employee custom field. */
+export type EmployeeCustomFieldProps = EmployeeFormulaCustomFieldProps | EmployeeUserInputCustomFieldProps;
 
 function cloneJson<T>(value: T): T {
   if (value == null) return value;
@@ -153,7 +221,7 @@ function customFieldDataTypeFromWire(dataType: Record<string, any>): CustomField
 }
 
 /** A Custom Field V2 field on a native or custom object. */
-export class CustomField {
+export class CustomField<const ModelRqlName extends string = string> {
   static readonly componentType = 'CUSTOM_FIELD_V2' as const;
 
   static toDeletionIdentifier(customFieldId: string): ManifestComponentDeletion {
@@ -161,9 +229,17 @@ export class CustomField {
   }
 
   private readonly _fieldId: string;
-  private readonly props: CustomFieldProps;
+  private readonly props: CustomFieldProps<ModelRqlName>;
 
-  constructor(scope: ManifestScope, props: CustomFieldProps) {
+  constructor(scope: ManifestScope, props: CustomFieldProps<ModelRqlName>) {
+    const runtimeProps = props as CustomFieldBaseProps<string> & {
+      fieldPermissionClassification?: CustomFieldPermissionClassification | null;
+      fieldReadAccess?: CustomFieldReadAccess | null;
+      fieldWriteAccess?: CustomFieldWriteAccess | null;
+      applicableGroup?: string | null;
+      collectDuring?: CustomFieldCollectionTiming | null;
+      rqlDefinitionFormula?: string | null;
+    };
     if (!props.apiName.endsWith('__cfv2')) {
       throw new Error(`Custom Field V2 api_name must end with __cfv2: ${props.apiName}`);
     }
@@ -173,11 +249,45 @@ export class CustomField {
           `but the field belongs to "${props.modelRqlName}".`,
       );
     }
+    if (runtimeProps.rqlDefinitionFormula != null && runtimeProps.fieldWriteAccess !== 'NO_ACCESS') {
+      throw new Error(`Formula custom field "${props.apiName}" must have fieldWriteAccess "NO_ACCESS".`);
+    }
+    if (props.modelRqlName === 'Employee') {
+      if (
+        runtimeProps.fieldPermissionClassification == null ||
+        runtimeProps.fieldReadAccess == null ||
+        runtimeProps.fieldWriteAccess == null ||
+        runtimeProps.applicableGroup == null
+      ) {
+        throw new Error(
+          `Employee custom field "${props.apiName}" requires fieldPermissionClassification, ` +
+            `fieldReadAccess, fieldWriteAccess, and applicableGroup.`,
+        );
+      }
+      if (
+        runtimeProps.fieldReadAccess === 'ALL_ACCESS' &&
+        (runtimeProps.fieldPermissionClassification === 'SENSITIVE_PERSONAL_INFO' ||
+          runtimeProps.fieldPermissionClassification === 'SENSITIVE_EMPLOYMENT_INFO')
+      ) {
+        throw new Error(
+          `Employee custom field "${props.apiName}" cannot use a sensitive permission classification ` +
+            `with fieldReadAccess "ALL_ACCESS".`,
+        );
+      }
+      if (
+        runtimeProps.collectDuring === 'ONBOARDING' &&
+        (runtimeProps.fieldReadAccess === 'ADMIN_ACCESS' || runtimeProps.fieldWriteAccess === 'ADMIN_ACCESS')
+      ) {
+        throw new Error(
+          `Employee onboarding custom field "${props.apiName}" must grant the employee read and write access.`,
+        );
+      }
+    }
     this._fieldId = props.fieldId ?? generateId('cfv2');
     this.props = {
       ...props,
       dataType: cloneJson(props.dataType),
-    };
+    } as CustomFieldProps<ModelRqlName>;
     scope._register(this);
   }
 
@@ -228,8 +338,12 @@ export class CustomField {
       displayOrder: (component['display_order'] as number | null | undefined) ?? null,
     };
     if (typeof formula === 'string') {
+      if (common.fieldWriteAccess != null && common.fieldWriteAccess !== 'NO_ACCESS') {
+        throw new TypeError(`Formula CUSTOM_FIELD_V2 field_write_access must be NO_ACCESS.`);
+      }
       return new CustomField(scope, {
         ...common,
+        fieldWriteAccess: 'NO_ACCESS',
         rqlDefinitionFormula: formula,
         collectDuring: null,
         required: 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;
+  }
+}

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,
@@ -25,15 +27,24 @@ export {
   CustomField,
   CustomField as CustomFieldV2,
   type CustomFieldApiName,
+  type CustomFieldBaseProps,
   type CustomFieldCollectionTiming,
   type CustomFieldDataType,
   type CustomFieldDefaultValue,
   type CustomFieldPermissionClassification,
+  type CustomFieldPermissionProps,
   type CustomFieldProps,
   type CustomFieldReadAccess,
   type CustomFieldType,
   type CustomFieldUniqueIDCharacterType,
   type CustomFieldWriteAccess,
+  type EmployeeCustomFieldPermissionProps,
+  type EmployeeCustomFieldProps,
+  type EmployeeFormulaCustomFieldProps,
+  type EmployeeUserInputCustomFieldProps,
+  type FormulaCustomFieldProps,
+  type NonEmployeeCustomFieldPermissionProps,
+  type UserInputCustomFieldProps,
 } from './custom-field';
 
 export { CustomFieldSection, type CustomFieldSectionProps } from './custom-field-section';
@@ -49,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 {