@eigenpal/sdk 0.12.2 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @eigenpal/sdk
 
+## 0.13.0
+
+### Minor Changes
+
+- 4f84288: TypeScript and Python SDKs can list dataset examples with `include: "metadata"`. That returns ids, names, annotations, and expected file refs without loading each example's input and expected JSON. The default remains a full payload, so existing list calls stay unchanged.
+- aaf5a04: The TypeScript and Python SDKs can create, promote, and restore workflow versions. Create a tagged candidate with `activate: false`, evaluate it without moving the live version, then call `promoteVersion` / `promote_version` when it is ready. Existing restore helpers still roll a workflow back to an earlier snapshot.
+
+  Name-conflict errors expose `conflictingWorkflowId` on the typed error envelope.
+
 ## 0.11.3
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/sdk",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "description": "Official TypeScript SDK for the EigenPal API",
   "type": "module",
   "main": "./src/index.ts",

package/src/generated/index.ts

@@ -1,4 +1,4 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-export { authCheck, automationsDatasetExport, automationsDatasetImport, automationsEvaluatorsGet, automationsEvaluatorsUpdate, automationsExamplesCreate, automationsExamplesDelete, automationsExamplesExpectedFileDelete, automationsExamplesExpectedFileGet, automationsExamplesExpectedFilesCreate, automationsExamplesExpectedFilesList, automationsExamplesExpectedFileUpdate, automationsExamplesGet, automationsExamplesInputFileDelete, automationsExamplesInputFileGet, automationsExamplesInputFilesCreate, automationsExamplesInputFilesList, automationsExamplesInputFileUpdate, automationsExamplesList, automationsExamplesRun, automationsExamplesUpdate, automationsExperimentsCancel, automationsExperimentsCreate, automationsExperimentsCreateStream, automationsExperimentsExport, automationsExperimentsExportAll, automationsExperimentsGet, automationsExperimentsList, automationsGet, automationsList, automationsReviewsHealth, automationsSync, automationsTriggersGet, automationsVersionsList, experimentsResolve, filesContentGet, filesCreate, filesDelete, filesGet, filesUploadsAbort, filesUploadsComplete, filesUploadsCreate, type Options, runsArtifactsGet, runsArtifactsList, runsCancel, runsEventsList, runsGet, runsList, runsPromote, runsRerun, runsReviewsClear, runsReviewsExpectedCreate, runsReviewsExpectedFileDelete, runsReviewsExpectedFileGet, runsReviewsExpectedFileUpdate, runsReviewsExpectedGet, runsReviewsGet, runsReviewsUpdate, runsScoresList, runsStart, runsStepsList, runsTraceGet, runsUsageGet } from './sdk.gen';
-export type { AbortFileUploadResponse, AgentRunExecution, ApiErrorEnvelope, ApiErrorIssue, AuthCheckData, AuthCheckError, AuthCheckErrors, AuthCheckResponse, AuthCheckResponse2, AuthCheckResponses, AutomationDatasetImportMultipartRequest, AutomationDetail, AutomationsDatasetExportData, AutomationsDatasetExportError, AutomationsDatasetExportErrors, AutomationsDatasetExportResponse, AutomationsDatasetExportResponses, AutomationsDatasetImportData, AutomationsDatasetImportError, AutomationsDatasetImportErrors, AutomationsDatasetImportResponse, AutomationsDatasetImportResponses, AutomationsEvaluatorsGetData, AutomationsEvaluatorsGetError, AutomationsEvaluatorsGetErrors, AutomationsEvaluatorsGetResponse, AutomationsEvaluatorsGetResponses, AutomationsEvaluatorsUpdateData, AutomationsEvaluatorsUpdateError, AutomationsEvaluatorsUpdateErrors, AutomationsEvaluatorsUpdateResponse, AutomationsEvaluatorsUpdateResponses, AutomationsExamplesCreateData, AutomationsExamplesCreateError, AutomationsExamplesCreateErrors, AutomationsExamplesCreateResponse, AutomationsExamplesCreateResponses, AutomationsExamplesDeleteData, AutomationsExamplesDeleteError, AutomationsExamplesDeleteErrors, AutomationsExamplesDeleteResponse, AutomationsExamplesDeleteResponses, AutomationsExamplesExpectedFileDeleteData, AutomationsExamplesExpectedFileDeleteError, AutomationsExamplesExpectedFileDeleteErrors, AutomationsExamplesExpectedFileDeleteResponses, AutomationsExamplesExpectedFileGetData, AutomationsExamplesExpectedFileGetError, AutomationsExamplesExpectedFileGetErrors, AutomationsExamplesExpectedFileGetResponse, AutomationsExamplesExpectedFileGetResponses, AutomationsExamplesExpectedFilesCreateData, AutomationsExamplesExpectedFilesCreateError, AutomationsExamplesExpectedFilesCreateErrors, AutomationsExamplesExpectedFilesCreateResponse, AutomationsExamplesExpectedFilesCreateResponses, AutomationsExamplesExpectedFilesListData, AutomationsExamplesExpectedFilesListError, AutomationsExamplesExpectedFilesListErrors, AutomationsExamplesExpectedFilesListResponse, AutomationsExamplesExpectedFilesListResponses, AutomationsExamplesExpectedFileUpdateData, AutomationsExamplesExpectedFileUpdateError, AutomationsExamplesExpectedFileUpdateErrors, AutomationsExamplesExpectedFileUpdateResponse, AutomationsExamplesExpectedFileUpdateResponses, AutomationsExamplesGetData, AutomationsExamplesGetError, AutomationsExamplesGetErrors, AutomationsExamplesGetResponse, AutomationsExamplesGetResponses, AutomationsExamplesInputFileDeleteData, AutomationsExamplesInputFileDeleteError, AutomationsExamplesInputFileDeleteErrors, AutomationsExamplesInputFileDeleteResponses, AutomationsExamplesInputFileGetData, AutomationsExamplesInputFileGetError, AutomationsExamplesInputFileGetErrors, AutomationsExamplesInputFileGetResponse, AutomationsExamplesInputFileGetResponses, AutomationsExamplesInputFilesCreateData, AutomationsExamplesInputFilesCreateError, AutomationsExamplesInputFilesCreateErrors, AutomationsExamplesInputFilesCreateResponse, AutomationsExamplesInputFilesCreateResponses, AutomationsExamplesInputFilesListData, AutomationsExamplesInputFilesListError, AutomationsExamplesInputFilesListErrors, AutomationsExamplesInputFilesListResponse, AutomationsExamplesInputFilesListResponses, AutomationsExamplesInputFileUpdateData, AutomationsExamplesInputFileUpdateError, AutomationsExamplesInputFileUpdateErrors, AutomationsExamplesInputFileUpdateResponse, AutomationsExamplesInputFileUpdateResponses, AutomationsExamplesListData, AutomationsExamplesListError, AutomationsExamplesListErrors, AutomationsExamplesListResponse, AutomationsExamplesListResponses, AutomationsExamplesRunData, AutomationsExamplesRunError, AutomationsExamplesRunErrors, AutomationsExamplesRunResponse, AutomationsExamplesRunResponses, AutomationsExamplesUpdateData, AutomationsExamplesUpdateError, AutomationsExamplesUpdateErrors, AutomationsExamplesUpdateResponse, AutomationsExamplesUpdateResponses, AutomationsExperimentsCancelData, AutomationsExperimentsCancelError, AutomationsExperimentsCancelErrors, AutomationsExperimentsCancelResponse, AutomationsExperimentsCancelResponses, AutomationsExperimentsCreateData, AutomationsExperimentsCreateError, AutomationsExperimentsCreateErrors, AutomationsExperimentsCreateResponse, AutomationsExperimentsCreateResponses, AutomationsExperimentsCreateStreamData, AutomationsExperimentsCreateStreamError, AutomationsExperimentsCreateStreamErrors, AutomationsExperimentsCreateStreamResponse, AutomationsExperimentsCreateStreamResponses, AutomationsExperimentsExportAllData, AutomationsExperimentsExportAllError, AutomationsExperimentsExportAllErrors, AutomationsExperimentsExportAllResponse, AutomationsExperimentsExportAllResponses, AutomationsExperimentsExportData, AutomationsExperimentsExportError, AutomationsExperimentsExportErrors, AutomationsExperimentsExportResponse, AutomationsExperimentsExportResponses, AutomationsExperimentsGetData, AutomationsExperimentsGetError, AutomationsExperimentsGetErrors, AutomationsExperimentsGetResponse, AutomationsExperimentsGetResponses, AutomationsExperimentsListData, AutomationsExperimentsListError, AutomationsExperimentsListErrors, AutomationsExperimentsListResponse, AutomationsExperimentsListResponses, AutomationsGetData, AutomationsGetError, AutomationsGetErrors, AutomationsGetResponse, AutomationsGetResponses, AutomationsListData, AutomationsListError, AutomationsListErrors, AutomationsListResponse, AutomationsListResponses, AutomationsReviewsHealthData, AutomationsReviewsHealthError, AutomationsReviewsHealthErrors, AutomationsReviewsHealthResponse, AutomationsReviewsHealthResponses, AutomationsSyncData, AutomationsSyncError, AutomationsSyncErrors, AutomationsSyncResponse, AutomationsSyncResponses, AutomationsTriggersGetData, AutomationsTriggersGetError, AutomationsTriggersGetErrors, AutomationsTriggersGetResponse, AutomationsTriggersGetResponses, AutomationSummary, AutomationsVersionsListData, AutomationsVersionsListError, AutomationsVersionsListErrors, AutomationsVersionsListResponse, AutomationsVersionsListResponses, AutomationTriggersResponse, AutomationTriggerState, AutomationType, AutomationVersion, ClientOptions, CreateFileMultipartRequest, CreateFileUploadSessionRequest, DatasetExample, DatasetExampleExpectedFileList, DatasetExampleExpectedFileRenameRequest, DatasetExampleExpectedFileRenameResponse, DatasetExampleExpectedFileUploadRequest, DatasetExampleExpectedFileUploadResponse, DatasetExampleInputFileList, DatasetExampleInputFileRenameRequest, DatasetExampleInputFileRenameResponse, DatasetExampleInputFileUploadRequest, DatasetExampleInputFileUploadResponse, DatasetExampleList, DatasetExampleMutation, DatasetExampleUpdate, DatasetImportResponse, DeleteFileResponse, EvalResult, EvaluatorConfigResponse, EvaluatorConfigUpdate, ExampleRunResponse, ExecutionStatus, Experiment, ExperimentCreate, ExperimentCreateResponse, ExperimentDetail, ExperimentRef, ExperimentsResolveData, ExperimentsResolveError, ExperimentsResolveErrors, ExperimentsResolveResponse, ExperimentsResolveResponses, File, FilesContentGetData, FilesContentGetError, FilesContentGetErrors, FilesContentGetResponses, FilesCreateData, FilesCreateError, FilesCreateErrors, FilesCreateResponse, FilesCreateResponses, FilesDeleteData, FilesDeleteError, FilesDeleteErrors, FilesDeleteResponse, FilesDeleteResponses, FilesGetData, FilesGetError, FilesGetErrors, FilesGetResponse, FilesGetResponses, FilesUploadsAbortData, FilesUploadsAbortError, FilesUploadsAbortErrors, FilesUploadsAbortResponse, FilesUploadsAbortResponses, FilesUploadsCompleteData, FilesUploadsCompleteError, FilesUploadsCompleteErrors, FilesUploadsCompleteResponse, FilesUploadsCompleteResponses, FilesUploadsCreateData, FilesUploadsCreateError, FilesUploadsCreateErrors, FilesUploadsCreateResponse, FilesUploadsCreateResponses, ListAutomationsResponse, ListAutomationVersionsResponse, MultipartFileUploadFallback, PresignedFileUploadSession, PromoteRunRequest, PromoteRunResponse, Run, RunAccepted, RunArtifact, RunArtifactsResponse, RunCancelResponse, RunDebug, RunError, RunEval, RunEvent, RunEventsResponse, RunExecution, RunExecutionMeta, RunExecutionRetry, RunFile, RunInput, RunListItem, RunReview, RunReviewCorrection, RunReviewDetail, RunReviewExpectedArtifacts, RunReviewExpectedFileCopyRequest, RunReviewExpectedFileMutationResponse, RunReviewExpectedFileUpdateRequest, RunReviewExpectedFileUpdateResponse, RunReviewExpectedFileUploadRequest, RunReviewHealthBucket, RunReviewHealthConfidence, RunReviewHealthResponse, RunReviewHealthRollingPoint, RunReviewHealthSummary, RunReviewRequest, RunReviewSummary, RunsArtifactsGetData, RunsArtifactsGetError, RunsArtifactsGetErrors, RunsArtifactsGetResponses, RunsArtifactsListData, RunsArtifactsListError, RunsArtifactsListErrors, RunsArtifactsListResponse, RunsArtifactsListResponses, RunsCancelData, RunsCancelError, RunsCancelErrors, RunsCancelResponse, RunsCancelResponses, RunScoresResponse, RunsEventsListData, RunsEventsListError, RunsEventsListErrors, RunsEventsListResponse, RunsEventsListResponses, RunsGetData, RunsGetError, RunsGetErrors, RunsGetResponse, RunsGetResponses, RunsListData, RunsListError, RunsListErrors, RunsListResponse, RunsListResponse2, RunsListResponses, RunSource, RunSourceGit, RunsPromoteData, RunsPromoteError, RunsPromoteErrors, RunsPromoteResponse, RunsPromoteResponses, RunsRerunData, RunsRerunError, RunsRerunErrors, RunsRerunResponse, RunsRerunResponses, RunsReviewsClearData, RunsReviewsClearError, RunsReviewsClearErrors, RunsReviewsClearResponse, RunsReviewsClearResponses, RunsReviewsExpectedCreateData, RunsReviewsExpectedCreateError, RunsReviewsExpectedCreateErrors, RunsReviewsExpectedCreateResponse, RunsReviewsExpectedCreateResponses, RunsReviewsExpectedFileDeleteData, RunsReviewsExpectedFileDeleteError, RunsReviewsExpectedFileDeleteErrors, RunsReviewsExpectedFileDeleteResponse, RunsReviewsExpectedFileDeleteResponses, RunsReviewsExpectedFileGetData, RunsReviewsExpectedFileGetError, RunsReviewsExpectedFileGetErrors, RunsReviewsExpectedFileGetResponse, RunsReviewsExpectedFileGetResponses, RunsReviewsExpectedFileUpdateData, RunsReviewsExpectedFileUpdateError, RunsReviewsExpectedFileUpdateErrors, RunsReviewsExpectedFileUpdateResponse, RunsReviewsExpectedFileUpdateResponses, RunsReviewsExpectedGetData, RunsReviewsExpectedGetError, RunsReviewsExpectedGetErrors, RunsReviewsExpectedGetResponse, RunsReviewsExpectedGetResponses, RunsReviewsGetData, RunsReviewsGetError, RunsReviewsGetErrors, RunsReviewsGetResponse, RunsReviewsGetResponses, RunsReviewsUpdateData, RunsReviewsUpdateError, RunsReviewsUpdateErrors, RunsReviewsUpdateResponse, RunsReviewsUpdateResponses, RunsScoresListData, RunsScoresListError, RunsScoresListErrors, RunsScoresListResponse, RunsScoresListResponses, RunsStartData, RunsStartError, RunsStartErrors, RunsStartResponse, RunsStartResponses, RunsStepsListData, RunsStepsListError, RunsStepsListErrors, RunsStepsListResponse, RunsStepsListResponses, RunStartBody, RunStartMultipartRequest, RunStepsResponse, RunsTraceGetData, RunsTraceGetError, RunsTraceGetErrors, RunsTraceGetResponse, RunsTraceGetResponses, RunsUsageGetData, RunsUsageGetError, RunsUsageGetErrors, RunsUsageGetResponse, RunsUsageGetResponses, RunTiming, RunTraceEvent, RunTraceResponse, RunTrigger, RunUsage, RunUsageResponse, WorkflowRunExecution } from './types.gen';
+export { authCheck, automationsDatasetExport, automationsDatasetImport, automationsEvaluatorsGet, automationsEvaluatorsUpdate, automationsExamplesCreate, automationsExamplesDelete, automationsExamplesExpectedFileDelete, automationsExamplesExpectedFileGet, automationsExamplesExpectedFilesCreate, automationsExamplesExpectedFilesList, automationsExamplesExpectedFileUpdate, automationsExamplesGet, automationsExamplesInputFileDelete, automationsExamplesInputFileGet, automationsExamplesInputFilesCreate, automationsExamplesInputFilesList, automationsExamplesInputFileUpdate, automationsExamplesList, automationsExamplesRun, automationsExamplesUpdate, automationsExperimentsCancel, automationsExperimentsCreate, automationsExperimentsCreateStream, automationsExperimentsExport, automationsExperimentsExportAll, automationsExperimentsGet, automationsExperimentsList, automationsGet, automationsList, automationsReviewsHealth, automationsSync, automationsTriggersGet, automationsVersionsCreate, automationsVersionsList, automationsVersionsPromote, automationsVersionsRestore, experimentsResolve, filesContentGet, filesCreate, filesDelete, filesGet, filesUploadsAbort, filesUploadsComplete, filesUploadsCreate, type Options, runsArtifactsGet, runsArtifactsList, runsCancel, runsEventsList, runsGet, runsList, runsPromote, runsRerun, runsReviewsClear, runsReviewsExpectedCreate, runsReviewsExpectedFileDelete, runsReviewsExpectedFileGet, runsReviewsExpectedFileUpdate, runsReviewsExpectedGet, runsReviewsGet, runsReviewsUpdate, runsScoresList, runsStart, runsStepsList, runsTraceGet, runsUsageGet } from './sdk.gen';
+export type { AbortFileUploadResponse, AgentRunExecution, ApiErrorEnvelope, ApiErrorIssue, AuthCheckData, AuthCheckError, AuthCheckErrors, AuthCheckResponse, AuthCheckResponse2, AuthCheckResponses, AutomationDatasetImportMultipartRequest, AutomationDetail, AutomationsDatasetExportData, AutomationsDatasetExportError, AutomationsDatasetExportErrors, AutomationsDatasetExportResponse, AutomationsDatasetExportResponses, AutomationsDatasetImportData, AutomationsDatasetImportError, AutomationsDatasetImportErrors, AutomationsDatasetImportResponse, AutomationsDatasetImportResponses, AutomationsEvaluatorsGetData, AutomationsEvaluatorsGetError, AutomationsEvaluatorsGetErrors, AutomationsEvaluatorsGetResponse, AutomationsEvaluatorsGetResponses, AutomationsEvaluatorsUpdateData, AutomationsEvaluatorsUpdateError, AutomationsEvaluatorsUpdateErrors, AutomationsEvaluatorsUpdateResponse, AutomationsEvaluatorsUpdateResponses, AutomationsExamplesCreateData, AutomationsExamplesCreateError, AutomationsExamplesCreateErrors, AutomationsExamplesCreateResponse, AutomationsExamplesCreateResponses, AutomationsExamplesDeleteData, AutomationsExamplesDeleteError, AutomationsExamplesDeleteErrors, AutomationsExamplesDeleteResponse, AutomationsExamplesDeleteResponses, AutomationsExamplesExpectedFileDeleteData, AutomationsExamplesExpectedFileDeleteError, AutomationsExamplesExpectedFileDeleteErrors, AutomationsExamplesExpectedFileDeleteResponses, AutomationsExamplesExpectedFileGetData, AutomationsExamplesExpectedFileGetError, AutomationsExamplesExpectedFileGetErrors, AutomationsExamplesExpectedFileGetResponse, AutomationsExamplesExpectedFileGetResponses, AutomationsExamplesExpectedFilesCreateData, AutomationsExamplesExpectedFilesCreateError, AutomationsExamplesExpectedFilesCreateErrors, AutomationsExamplesExpectedFilesCreateResponse, AutomationsExamplesExpectedFilesCreateResponses, AutomationsExamplesExpectedFilesListData, AutomationsExamplesExpectedFilesListError, AutomationsExamplesExpectedFilesListErrors, AutomationsExamplesExpectedFilesListResponse, AutomationsExamplesExpectedFilesListResponses, AutomationsExamplesExpectedFileUpdateData, AutomationsExamplesExpectedFileUpdateError, AutomationsExamplesExpectedFileUpdateErrors, AutomationsExamplesExpectedFileUpdateResponse, AutomationsExamplesExpectedFileUpdateResponses, AutomationsExamplesGetData, AutomationsExamplesGetError, AutomationsExamplesGetErrors, AutomationsExamplesGetResponse, AutomationsExamplesGetResponses, AutomationsExamplesInputFileDeleteData, AutomationsExamplesInputFileDeleteError, AutomationsExamplesInputFileDeleteErrors, AutomationsExamplesInputFileDeleteResponses, AutomationsExamplesInputFileGetData, AutomationsExamplesInputFileGetError, AutomationsExamplesInputFileGetErrors, AutomationsExamplesInputFileGetResponse, AutomationsExamplesInputFileGetResponses, AutomationsExamplesInputFilesCreateData, AutomationsExamplesInputFilesCreateError, AutomationsExamplesInputFilesCreateErrors, AutomationsExamplesInputFilesCreateResponse, AutomationsExamplesInputFilesCreateResponses, AutomationsExamplesInputFilesListData, AutomationsExamplesInputFilesListError, AutomationsExamplesInputFilesListErrors, AutomationsExamplesInputFilesListResponse, AutomationsExamplesInputFilesListResponses, AutomationsExamplesInputFileUpdateData, AutomationsExamplesInputFileUpdateError, AutomationsExamplesInputFileUpdateErrors, AutomationsExamplesInputFileUpdateResponse, AutomationsExamplesInputFileUpdateResponses, AutomationsExamplesListData, AutomationsExamplesListError, AutomationsExamplesListErrors, AutomationsExamplesListResponse, AutomationsExamplesListResponses, AutomationsExamplesRunData, AutomationsExamplesRunError, AutomationsExamplesRunErrors, AutomationsExamplesRunResponse, AutomationsExamplesRunResponses, AutomationsExamplesUpdateData, AutomationsExamplesUpdateError, AutomationsExamplesUpdateErrors, AutomationsExamplesUpdateResponse, AutomationsExamplesUpdateResponses, AutomationsExperimentsCancelData, AutomationsExperimentsCancelError, AutomationsExperimentsCancelErrors, AutomationsExperimentsCancelResponse, AutomationsExperimentsCancelResponses, AutomationsExperimentsCreateData, AutomationsExperimentsCreateError, AutomationsExperimentsCreateErrors, AutomationsExperimentsCreateResponse, AutomationsExperimentsCreateResponses, AutomationsExperimentsCreateStreamData, AutomationsExperimentsCreateStreamError, AutomationsExperimentsCreateStreamErrors, AutomationsExperimentsCreateStreamResponse, AutomationsExperimentsCreateStreamResponses, AutomationsExperimentsExportAllData, AutomationsExperimentsExportAllError, AutomationsExperimentsExportAllErrors, AutomationsExperimentsExportAllResponse, AutomationsExperimentsExportAllResponses, AutomationsExperimentsExportData, AutomationsExperimentsExportError, AutomationsExperimentsExportErrors, AutomationsExperimentsExportResponse, AutomationsExperimentsExportResponses, AutomationsExperimentsGetData, AutomationsExperimentsGetError, AutomationsExperimentsGetErrors, AutomationsExperimentsGetResponse, AutomationsExperimentsGetResponses, AutomationsExperimentsListData, AutomationsExperimentsListError, AutomationsExperimentsListErrors, AutomationsExperimentsListResponse, AutomationsExperimentsListResponses, AutomationsGetData, AutomationsGetError, AutomationsGetErrors, AutomationsGetResponse, AutomationsGetResponses, AutomationsListData, AutomationsListError, AutomationsListErrors, AutomationsListResponse, AutomationsListResponses, AutomationsReviewsHealthData, AutomationsReviewsHealthError, AutomationsReviewsHealthErrors, AutomationsReviewsHealthResponse, AutomationsReviewsHealthResponses, AutomationsSyncData, AutomationsSyncError, AutomationsSyncErrors, AutomationsSyncResponse, AutomationsSyncResponses, AutomationsTriggersGetData, AutomationsTriggersGetError, AutomationsTriggersGetErrors, AutomationsTriggersGetResponse, AutomationsTriggersGetResponses, AutomationSummary, AutomationsVersionsCreateData, AutomationsVersionsCreateError, AutomationsVersionsCreateErrors, AutomationsVersionsCreateResponse, AutomationsVersionsCreateResponses, AutomationsVersionsListData, AutomationsVersionsListError, AutomationsVersionsListErrors, AutomationsVersionsListResponse, AutomationsVersionsListResponses, AutomationsVersionsPromoteData, AutomationsVersionsPromoteError, AutomationsVersionsPromoteErrors, AutomationsVersionsPromoteResponse, AutomationsVersionsPromoteResponses, AutomationsVersionsRestoreData, AutomationsVersionsRestoreError, AutomationsVersionsRestoreErrors, AutomationsVersionsRestoreResponse, AutomationsVersionsRestoreResponses, AutomationTriggersResponse, AutomationTriggerState, AutomationType, AutomationVersion, ClientOptions, CreateAutomationVersionRequest, CreateFileMultipartRequest, CreateFileUploadSessionRequest, DatasetExample, DatasetExampleExpectedFileList, DatasetExampleExpectedFileRenameRequest, DatasetExampleExpectedFileRenameResponse, DatasetExampleExpectedFileUploadRequest, DatasetExampleExpectedFileUploadResponse, DatasetExampleInputFileList, DatasetExampleInputFileRenameRequest, DatasetExampleInputFileRenameResponse, DatasetExampleInputFileUploadRequest, DatasetExampleInputFileUploadResponse, DatasetExampleList, DatasetExampleMutation, DatasetExampleUpdate, DatasetImportResponse, DeleteFileResponse, EvalResult, EvaluatorConfigResponse, EvaluatorConfigUpdate, ExampleRunResponse, ExecutionStatus, Experiment, ExperimentCreate, ExperimentCreateResponse, ExperimentDetail, ExperimentRef, ExperimentsResolveData, ExperimentsResolveError, ExperimentsResolveErrors, ExperimentsResolveResponse, ExperimentsResolveResponses, File, FilesContentGetData, FilesContentGetError, FilesContentGetErrors, FilesContentGetResponses, FilesCreateData, FilesCreateError, FilesCreateErrors, FilesCreateResponse, FilesCreateResponses, FilesDeleteData, FilesDeleteError, FilesDeleteErrors, FilesDeleteResponse, FilesDeleteResponses, FilesGetData, FilesGetError, FilesGetErrors, FilesGetResponse, FilesGetResponses, FilesUploadsAbortData, FilesUploadsAbortError, FilesUploadsAbortErrors, FilesUploadsAbortResponse, FilesUploadsAbortResponses, FilesUploadsCompleteData, FilesUploadsCompleteError, FilesUploadsCompleteErrors, FilesUploadsCompleteResponse, FilesUploadsCompleteResponses, FilesUploadsCreateData, FilesUploadsCreateError, FilesUploadsCreateErrors, FilesUploadsCreateResponse, FilesUploadsCreateResponses, ListAutomationsResponse, ListAutomationVersionsResponse, MultipartFileUploadFallback, PresignedFileUploadSession, PromoteRunRequest, PromoteRunResponse, RestoreAutomationVersionRequest, Run, RunAccepted, RunArtifact, RunArtifactsResponse, RunCancelResponse, RunDebug, RunError, RunEval, RunEvent, RunEventsResponse, RunExecution, RunExecutionMeta, RunExecutionRetry, RunFile, RunInput, RunListItem, RunReview, RunReviewCorrection, RunReviewDetail, RunReviewExpectedArtifacts, RunReviewExpectedFileCopyRequest, RunReviewExpectedFileMutationResponse, RunReviewExpectedFileUpdateRequest, RunReviewExpectedFileUpdateResponse, RunReviewExpectedFileUploadRequest, RunReviewHealthBucket, RunReviewHealthConfidence, RunReviewHealthResponse, RunReviewHealthRollingPoint, RunReviewHealthSummary, RunReviewRequest, RunReviewSummary, RunsArtifactsGetData, RunsArtifactsGetError, RunsArtifactsGetErrors, RunsArtifactsGetResponses, RunsArtifactsListData, RunsArtifactsListError, RunsArtifactsListErrors, RunsArtifactsListResponse, RunsArtifactsListResponses, RunsCancelData, RunsCancelError, RunsCancelErrors, RunsCancelResponse, RunsCancelResponses, RunScoresResponse, RunsEventsListData, RunsEventsListError, RunsEventsListErrors, RunsEventsListResponse, RunsEventsListResponses, RunsGetData, RunsGetError, RunsGetErrors, RunsGetResponse, RunsGetResponses, RunsListData, RunsListError, RunsListErrors, RunsListResponse, RunsListResponse2, RunsListResponses, RunSource, RunSourceGit, RunsPromoteData, RunsPromoteError, RunsPromoteErrors, RunsPromoteResponse, RunsPromoteResponses, RunsRerunData, RunsRerunError, RunsRerunErrors, RunsRerunResponse, RunsRerunResponses, RunsReviewsClearData, RunsReviewsClearError, RunsReviewsClearErrors, RunsReviewsClearResponse, RunsReviewsClearResponses, RunsReviewsExpectedCreateData, RunsReviewsExpectedCreateError, RunsReviewsExpectedCreateErrors, RunsReviewsExpectedCreateResponse, RunsReviewsExpectedCreateResponses, RunsReviewsExpectedFileDeleteData, RunsReviewsExpectedFileDeleteError, RunsReviewsExpectedFileDeleteErrors, RunsReviewsExpectedFileDeleteResponse, RunsReviewsExpectedFileDeleteResponses, RunsReviewsExpectedFileGetData, RunsReviewsExpectedFileGetError, RunsReviewsExpectedFileGetErrors, RunsReviewsExpectedFileGetResponse, RunsReviewsExpectedFileGetResponses, RunsReviewsExpectedFileUpdateData, RunsReviewsExpectedFileUpdateError, RunsReviewsExpectedFileUpdateErrors, RunsReviewsExpectedFileUpdateResponse, RunsReviewsExpectedFileUpdateResponses, RunsReviewsExpectedGetData, RunsReviewsExpectedGetError, RunsReviewsExpectedGetErrors, RunsReviewsExpectedGetResponse, RunsReviewsExpectedGetResponses, RunsReviewsGetData, RunsReviewsGetError, RunsReviewsGetErrors, RunsReviewsGetResponse, RunsReviewsGetResponses, RunsReviewsUpdateData, RunsReviewsUpdateError, RunsReviewsUpdateErrors, RunsReviewsUpdateResponse, RunsReviewsUpdateResponses, RunsScoresListData, RunsScoresListError, RunsScoresListErrors, RunsScoresListResponse, RunsScoresListResponses, RunsStartData, RunsStartError, RunsStartErrors, RunsStartResponse, RunsStartResponses, RunsStepsListData, RunsStepsListError, RunsStepsListErrors, RunsStepsListResponse, RunsStepsListResponses, RunStartBody, RunStartMultipartRequest, RunStepsResponse, RunsTraceGetData, RunsTraceGetError, RunsTraceGetErrors, RunsTraceGetResponse, RunsTraceGetResponses, RunsUsageGetData, RunsUsageGetError, RunsUsageGetErrors, RunsUsageGetResponse, RunsUsageGetResponses, RunTiming, RunTraceEvent, RunTraceResponse, RunTrigger, RunUsage, RunUsageResponse, WorkflowRunExecution } from './types.gen';

package/src/generated/sdk.gen.ts

@@ -2,7 +2,7 @@
 
 import { type Client, formDataBodySerializer, type Options as Options2, type TDataShape } from './client';
 import { client } from './client.gen';
-import type { AuthCheckData, AuthCheckErrors, AuthCheckResponses, AutomationsDatasetExportData, AutomationsDatasetExportErrors, AutomationsDatasetExportResponses, AutomationsDatasetImportData, AutomationsDatasetImportErrors, AutomationsDatasetImportResponses, AutomationsEvaluatorsGetData, AutomationsEvaluatorsGetErrors, AutomationsEvaluatorsGetResponses, AutomationsEvaluatorsUpdateData, AutomationsEvaluatorsUpdateErrors, AutomationsEvaluatorsUpdateResponses, AutomationsExamplesCreateData, AutomationsExamplesCreateErrors, AutomationsExamplesCreateResponses, AutomationsExamplesDeleteData, AutomationsExamplesDeleteErrors, AutomationsExamplesDeleteResponses, AutomationsExamplesExpectedFileDeleteData, AutomationsExamplesExpectedFileDeleteErrors, AutomationsExamplesExpectedFileDeleteResponses, AutomationsExamplesExpectedFileGetData, AutomationsExamplesExpectedFileGetErrors, AutomationsExamplesExpectedFileGetResponses, AutomationsExamplesExpectedFilesCreateData, AutomationsExamplesExpectedFilesCreateErrors, AutomationsExamplesExpectedFilesCreateResponses, AutomationsExamplesExpectedFilesListData, AutomationsExamplesExpectedFilesListErrors, AutomationsExamplesExpectedFilesListResponses, AutomationsExamplesExpectedFileUpdateData, AutomationsExamplesExpectedFileUpdateErrors, AutomationsExamplesExpectedFileUpdateResponses, AutomationsExamplesGetData, AutomationsExamplesGetErrors, AutomationsExamplesGetResponses, AutomationsExamplesInputFileDeleteData, AutomationsExamplesInputFileDeleteErrors, AutomationsExamplesInputFileDeleteResponses, AutomationsExamplesInputFileGetData, AutomationsExamplesInputFileGetErrors, AutomationsExamplesInputFileGetResponses, AutomationsExamplesInputFilesCreateData, AutomationsExamplesInputFilesCreateErrors, AutomationsExamplesInputFilesCreateResponses, AutomationsExamplesInputFilesListData, AutomationsExamplesInputFilesListErrors, AutomationsExamplesInputFilesListResponses, AutomationsExamplesInputFileUpdateData, AutomationsExamplesInputFileUpdateErrors, AutomationsExamplesInputFileUpdateResponses, AutomationsExamplesListData, AutomationsExamplesListErrors, AutomationsExamplesListResponses, AutomationsExamplesRunData, AutomationsExamplesRunErrors, AutomationsExamplesRunResponses, AutomationsExamplesUpdateData, AutomationsExamplesUpdateErrors, AutomationsExamplesUpdateResponses, AutomationsExperimentsCancelData, AutomationsExperimentsCancelErrors, AutomationsExperimentsCancelResponses, AutomationsExperimentsCreateData, AutomationsExperimentsCreateErrors, AutomationsExperimentsCreateResponses, AutomationsExperimentsCreateStreamData, AutomationsExperimentsCreateStreamErrors, AutomationsExperimentsCreateStreamResponses, AutomationsExperimentsExportAllData, AutomationsExperimentsExportAllErrors, AutomationsExperimentsExportAllResponses, AutomationsExperimentsExportData, AutomationsExperimentsExportErrors, AutomationsExperimentsExportResponses, AutomationsExperimentsGetData, AutomationsExperimentsGetErrors, AutomationsExperimentsGetResponses, AutomationsExperimentsListData, AutomationsExperimentsListErrors, AutomationsExperimentsListResponses, AutomationsGetData, AutomationsGetErrors, AutomationsGetResponses, AutomationsListData, AutomationsListErrors, AutomationsListResponses, AutomationsReviewsHealthData, AutomationsReviewsHealthErrors, AutomationsReviewsHealthResponses, AutomationsSyncData, AutomationsSyncErrors, AutomationsSyncResponses, AutomationsTriggersGetData, AutomationsTriggersGetErrors, AutomationsTriggersGetResponses, AutomationsVersionsListData, AutomationsVersionsListErrors, AutomationsVersionsListResponses, ExperimentsResolveData, ExperimentsResolveErrors, ExperimentsResolveResponses, FilesContentGetData, FilesContentGetErrors, FilesContentGetResponses, FilesCreateData, FilesCreateErrors, FilesCreateResponses, FilesDeleteData, FilesDeleteErrors, FilesDeleteResponses, FilesGetData, FilesGetErrors, FilesGetResponses, FilesUploadsAbortData, FilesUploadsAbortErrors, FilesUploadsAbortResponses, FilesUploadsCompleteData, FilesUploadsCompleteErrors, FilesUploadsCompleteResponses, FilesUploadsCreateData, FilesUploadsCreateErrors, FilesUploadsCreateResponses, RunsArtifactsGetData, RunsArtifactsGetErrors, RunsArtifactsGetResponses, RunsArtifactsListData, RunsArtifactsListErrors, RunsArtifactsListResponses, RunsCancelData, RunsCancelErrors, RunsCancelResponses, RunsEventsListData, RunsEventsListErrors, RunsEventsListResponses, RunsGetData, RunsGetErrors, RunsGetResponses, RunsListData, RunsListErrors, RunsListResponses, RunsPromoteData, RunsPromoteErrors, RunsPromoteResponses, RunsRerunData, RunsRerunErrors, RunsRerunResponses, RunsReviewsClearData, RunsReviewsClearErrors, RunsReviewsClearResponses, RunsReviewsExpectedCreateData, RunsReviewsExpectedCreateErrors, RunsReviewsExpectedCreateResponses, RunsReviewsExpectedFileDeleteData, RunsReviewsExpectedFileDeleteErrors, RunsReviewsExpectedFileDeleteResponses, RunsReviewsExpectedFileGetData, RunsReviewsExpectedFileGetErrors, RunsReviewsExpectedFileGetResponses, RunsReviewsExpectedFileUpdateData, RunsReviewsExpectedFileUpdateErrors, RunsReviewsExpectedFileUpdateResponses, RunsReviewsExpectedGetData, RunsReviewsExpectedGetErrors, RunsReviewsExpectedGetResponses, RunsReviewsGetData, RunsReviewsGetErrors, RunsReviewsGetResponses, RunsReviewsUpdateData, RunsReviewsUpdateErrors, RunsReviewsUpdateResponses, RunsScoresListData, RunsScoresListErrors, RunsScoresListResponses, RunsStartData, RunsStartErrors, RunsStartResponses, RunsStepsListData, RunsStepsListErrors, RunsStepsListResponses, RunsTraceGetData, RunsTraceGetErrors, RunsTraceGetResponses, RunsUsageGetData, RunsUsageGetErrors, RunsUsageGetResponses } from './types.gen';
+import type { AuthCheckData, AuthCheckErrors, AuthCheckResponses, AutomationsDatasetExportData, AutomationsDatasetExportErrors, AutomationsDatasetExportResponses, AutomationsDatasetImportData, AutomationsDatasetImportErrors, AutomationsDatasetImportResponses, AutomationsEvaluatorsGetData, AutomationsEvaluatorsGetErrors, AutomationsEvaluatorsGetResponses, AutomationsEvaluatorsUpdateData, AutomationsEvaluatorsUpdateErrors, AutomationsEvaluatorsUpdateResponses, AutomationsExamplesCreateData, AutomationsExamplesCreateErrors, AutomationsExamplesCreateResponses, AutomationsExamplesDeleteData, AutomationsExamplesDeleteErrors, AutomationsExamplesDeleteResponses, AutomationsExamplesExpectedFileDeleteData, AutomationsExamplesExpectedFileDeleteErrors, AutomationsExamplesExpectedFileDeleteResponses, AutomationsExamplesExpectedFileGetData, AutomationsExamplesExpectedFileGetErrors, AutomationsExamplesExpectedFileGetResponses, AutomationsExamplesExpectedFilesCreateData, AutomationsExamplesExpectedFilesCreateErrors, AutomationsExamplesExpectedFilesCreateResponses, AutomationsExamplesExpectedFilesListData, AutomationsExamplesExpectedFilesListErrors, AutomationsExamplesExpectedFilesListResponses, AutomationsExamplesExpectedFileUpdateData, AutomationsExamplesExpectedFileUpdateErrors, AutomationsExamplesExpectedFileUpdateResponses, AutomationsExamplesGetData, AutomationsExamplesGetErrors, AutomationsExamplesGetResponses, AutomationsExamplesInputFileDeleteData, AutomationsExamplesInputFileDeleteErrors, AutomationsExamplesInputFileDeleteResponses, AutomationsExamplesInputFileGetData, AutomationsExamplesInputFileGetErrors, AutomationsExamplesInputFileGetResponses, AutomationsExamplesInputFilesCreateData, AutomationsExamplesInputFilesCreateErrors, AutomationsExamplesInputFilesCreateResponses, AutomationsExamplesInputFilesListData, AutomationsExamplesInputFilesListErrors, AutomationsExamplesInputFilesListResponses, AutomationsExamplesInputFileUpdateData, AutomationsExamplesInputFileUpdateErrors, AutomationsExamplesInputFileUpdateResponses, AutomationsExamplesListData, AutomationsExamplesListErrors, AutomationsExamplesListResponses, AutomationsExamplesRunData, AutomationsExamplesRunErrors, AutomationsExamplesRunResponses, AutomationsExamplesUpdateData, AutomationsExamplesUpdateErrors, AutomationsExamplesUpdateResponses, AutomationsExperimentsCancelData, AutomationsExperimentsCancelErrors, AutomationsExperimentsCancelResponses, AutomationsExperimentsCreateData, AutomationsExperimentsCreateErrors, AutomationsExperimentsCreateResponses, AutomationsExperimentsCreateStreamData, AutomationsExperimentsCreateStreamErrors, AutomationsExperimentsCreateStreamResponses, AutomationsExperimentsExportAllData, AutomationsExperimentsExportAllErrors, AutomationsExperimentsExportAllResponses, AutomationsExperimentsExportData, AutomationsExperimentsExportErrors, AutomationsExperimentsExportResponses, AutomationsExperimentsGetData, AutomationsExperimentsGetErrors, AutomationsExperimentsGetResponses, AutomationsExperimentsListData, AutomationsExperimentsListErrors, AutomationsExperimentsListResponses, AutomationsGetData, AutomationsGetErrors, AutomationsGetResponses, AutomationsListData, AutomationsListErrors, AutomationsListResponses, AutomationsReviewsHealthData, AutomationsReviewsHealthErrors, AutomationsReviewsHealthResponses, AutomationsSyncData, AutomationsSyncErrors, AutomationsSyncResponses, AutomationsTriggersGetData, AutomationsTriggersGetErrors, AutomationsTriggersGetResponses, AutomationsVersionsCreateData, AutomationsVersionsCreateErrors, AutomationsVersionsCreateResponses, AutomationsVersionsListData, AutomationsVersionsListErrors, AutomationsVersionsListResponses, AutomationsVersionsPromoteData, AutomationsVersionsPromoteErrors, AutomationsVersionsPromoteResponses, AutomationsVersionsRestoreData, AutomationsVersionsRestoreErrors, AutomationsVersionsRestoreResponses, ExperimentsResolveData, ExperimentsResolveErrors, ExperimentsResolveResponses, FilesContentGetData, FilesContentGetErrors, FilesContentGetResponses, FilesCreateData, FilesCreateErrors, FilesCreateResponses, FilesDeleteData, FilesDeleteErrors, FilesDeleteResponses, FilesGetData, FilesGetErrors, FilesGetResponses, FilesUploadsAbortData, FilesUploadsAbortErrors, FilesUploadsAbortResponses, FilesUploadsCompleteData, FilesUploadsCompleteErrors, FilesUploadsCompleteResponses, FilesUploadsCreateData, FilesUploadsCreateErrors, FilesUploadsCreateResponses, RunsArtifactsGetData, RunsArtifactsGetErrors, RunsArtifactsGetResponses, RunsArtifactsListData, RunsArtifactsListErrors, RunsArtifactsListResponses, RunsCancelData, RunsCancelErrors, RunsCancelResponses, RunsEventsListData, RunsEventsListErrors, RunsEventsListResponses, RunsGetData, RunsGetErrors, RunsGetResponses, RunsListData, RunsListErrors, RunsListResponses, RunsPromoteData, RunsPromoteErrors, RunsPromoteResponses, RunsRerunData, RunsRerunErrors, RunsRerunResponses, RunsReviewsClearData, RunsReviewsClearErrors, RunsReviewsClearResponses, RunsReviewsExpectedCreateData, RunsReviewsExpectedCreateErrors, RunsReviewsExpectedCreateResponses, RunsReviewsExpectedFileDeleteData, RunsReviewsExpectedFileDeleteErrors, RunsReviewsExpectedFileDeleteResponses, RunsReviewsExpectedFileGetData, RunsReviewsExpectedFileGetErrors, RunsReviewsExpectedFileGetResponses, RunsReviewsExpectedFileUpdateData, RunsReviewsExpectedFileUpdateErrors, RunsReviewsExpectedFileUpdateResponses, RunsReviewsExpectedGetData, RunsReviewsExpectedGetErrors, RunsReviewsExpectedGetResponses, RunsReviewsGetData, RunsReviewsGetErrors, RunsReviewsGetResponses, RunsReviewsUpdateData, RunsReviewsUpdateErrors, RunsReviewsUpdateResponses, RunsScoresListData, RunsScoresListErrors, RunsScoresListResponses, RunsStartData, RunsStartErrors, RunsStartResponses, RunsStepsListData, RunsStepsListErrors, RunsStepsListResponses, RunsTraceGetData, RunsTraceGetErrors, RunsTraceGetResponses, RunsUsageGetData, RunsUsageGetErrors, RunsUsageGetResponses } from './types.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
@@ -107,7 +107,7 @@ export const automationsEvaluatorsUpdate = <ThrowOnError extends boolean = false
 /**
  * List dataset examples
  *
- * List dataset examples for one automation. Examples contain input, expected output, expected files, metadata, and optional overrides used by evaluation runs.
+ * List dataset examples for one automation. Examples contain input, expected output, expected files, metadata, and optional overrides used by evaluation runs. Pass `include=metadata` to return ids, names, metadata, and expected file refs without loading input or expected JSON.
  */
 export const automationsExamplesList = <ThrowOnError extends boolean = false>(options: Options<AutomationsExamplesListData, ThrowOnError>) => (options.client ?? client).get<AutomationsExamplesListResponses, AutomationsExamplesListErrors, ThrowOnError>({
     security: [{ scheme: 'bearer', type: 'http' }],
@@ -427,7 +427,7 @@ export const automationsTriggersGet = <ThrowOnError extends boolean = false>(opt
 /**
  * List automation versions
  *
- * List versions for a workflow or agent automation through one read-only route.
+ * List versions for a workflow or agent automation. YAML workflow lists include tagged releases plus the current untagged snapshot when HEAD is untagged (for example after restore), so the current version is always present. Agent lists remain Git release tags.
  */
 export const automationsVersionsList = <ThrowOnError extends boolean = false>(options: Options<AutomationsVersionsListData, ThrowOnError>) => (options.client ?? client).get<AutomationsVersionsListResponses, AutomationsVersionsListErrors, ThrowOnError>({
     security: [{ scheme: 'bearer', type: 'http' }],
@@ -435,6 +435,47 @@ export const automationsVersionsList = <ThrowOnError extends boolean = false>(op
     ...options
 });
 
+/**
+ * Create a workflow version
+ *
+ * Create a tagged YAML workflow candidate from validated YAML or by copying an existing snapshot (`historyId`). Provide exactly one of `yaml` or `historyId`. Copy creates a new tagged row and leaves the source tag unchanged; it does not retag the original. Defaults to making the new version current. Set `activate: false` to keep it off live traffic until promote — that path requires an existing current workflow version and returns 400 if HEAD is empty. Agent automations are Git-backed and return 400. Requires a Bearer API key or a dashboard session.
+ */
+export const automationsVersionsCreate = <ThrowOnError extends boolean = false>(options: Options<AutomationsVersionsCreateData, ThrowOnError>) => (options.client ?? client).post<AutomationsVersionsCreateResponses, AutomationsVersionsCreateErrors, ThrowOnError>({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/v1/automations/{id}/versions',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+
+/**
+ * Promote a workflow version
+ *
+ * Make an existing tagged YAML workflow candidate current without creating another history row. Only tagged version rows can be promoted; untagged snapshots (including restore HEAD) and missing ids return 404. Agent automations return 400. Requires a Bearer API key or a dashboard session.
+ */
+export const automationsVersionsPromote = <ThrowOnError extends boolean = false>(options: Options<AutomationsVersionsPromoteData, ThrowOnError>) => (options.client ?? client).post<AutomationsVersionsPromoteResponses, AutomationsVersionsPromoteErrors, ThrowOnError>({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/v1/automations/{id}/versions/{versionId}/promote',
+    ...options
+});
+
+/**
+ * Restore a workflow version
+ *
+ * Restore a YAML workflow automation by copying a previous snapshot into a new untagged current version. The source tag is left unchanged; the new HEAD appears in subsequent version lists as the untagged current row and cannot be promoted until you create a tagged copy. The JSON body may be `{}`; `message` is optional and defaults to a timestamped restore note. Agent automations return 400. Requires a Bearer API key or a dashboard session.
+ */
+export const automationsVersionsRestore = <ThrowOnError extends boolean = false>(options: Options<AutomationsVersionsRestoreData, ThrowOnError>) => (options.client ?? client).post<AutomationsVersionsRestoreResponses, AutomationsVersionsRestoreErrors, ThrowOnError>({
+    security: [{ scheme: 'bearer', type: 'http' }],
+    url: '/v1/automations/{id}/versions/{versionId}/restore',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
+
 /**
  * Resolve experiment by id
  *

package/src/generated/types.gen.ts

@@ -151,6 +151,47 @@ export type ExperimentCreate = {
     sourceRef?: string;
 };
 
+/**
+ * Exactly one of `yaml` or `historyId`, plus a bare semver `version`. YAML is capped at 1 MiB. `historyId` copies the selected snapshot into a new tagged row and does not retag the source. Set `activate: false` to create a detached candidate that does not move live HEAD; that path requires an existing current version.
+ */
+export type CreateAutomationVersionRequest = {
+    /**
+     * Validated workflow YAML to publish as a new tagged version. Mutually exclusive with `historyId`. At most 1 MiB.
+     */
+    yaml: string;
+    /**
+     * Bare semver tag such as 1.2.0. Do not include a leading v.
+     */
+    version: string;
+    /**
+     * Whether to make the new version current immediately. Defaults to true. Set false to keep a tagged candidate off live traffic until promote. `activate: false` requires an existing current workflow version and returns 400 if HEAD is empty.
+     */
+    activate?: boolean;
+} | {
+    /**
+     * Existing version id from GET /automations/{id}/versions. Creates a new tagged snapshot copied from that version; the source tag is left unchanged. Mutually exclusive with `yaml`.
+     */
+    historyId: string;
+    /**
+     * Bare semver tag such as 1.2.0. Do not include a leading v.
+     */
+    version: string;
+    /**
+     * Whether to make the new version current immediately. Defaults to true. Set false to keep a tagged candidate off live traffic until promote. `activate: false` requires an existing current workflow version and returns 400 if HEAD is empty.
+     */
+    activate?: boolean;
+};
+
+/**
+ * Optional JSON body. Send `{}` when no message is needed. Restore always creates a new untagged current snapshot; it does not retag the source version.
+ */
+export type RestoreAutomationVersionRequest = {
+    /**
+     * Optional restore commit message. Defaults to a timestamped restore note.
+     */
+    message?: string;
+};
+
 export type CreateFileMultipartRequest = {
     /**
      * Binary file field
@@ -375,6 +416,10 @@ export type ApiErrorEnvelope = {
      * Link to relevant docs
      */
     docsUrl?: string;
+    /**
+     * Present on 409 workflow_name_conflict responses. Id of the workflow that already owns the requested name.
+     */
+    conflictingWorkflowId?: string;
 };
 
 export type ApiErrorIssue = {
@@ -522,13 +567,13 @@ export type DatasetExample = {
     automationId: string;
     automationType: AutomationType;
     /**
-     * Input arguments used when this example is run.
+     * Input arguments used when this example is run. Null when listing with `include=metadata`.
      */
     input: {
         [key: string]: unknown;
     } | null;
     /**
-     * Expected JSON output for evaluator comparisons.
+     * Expected JSON output for evaluator comparisons. Null when listing with `include=metadata`.
      */
     expected: unknown | null;
     /**
@@ -1953,6 +1998,10 @@ export type AutomationsExamplesListData = {
          * Zero-based offset for paging through examples.
          */
         offset?: number;
+        /**
+         * Response payload scope. `metadata` returns ids, names, metadata, and expected file refs without loading input or expected JSON.
+         */
+        include?: 'full' | 'metadata';
     };
     url: '/v1/automations/{id}/examples';
 };
@@ -3594,6 +3643,188 @@ export type AutomationsVersionsListResponses = {
 
 export type AutomationsVersionsListResponse = AutomationsVersionsListResponses[keyof AutomationsVersionsListResponses];
 
+export type AutomationsVersionsCreateData = {
+    body: CreateAutomationVersionRequest;
+    path: {
+        /**
+         * Workflow id, agent id, or typed alias like workflows.slug / agents.slug
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/automations/{id}/versions';
+};
+
+export type AutomationsVersionsCreateErrors = {
+    /**
+     * Validation error. Request shape did not match the spec.
+     */
+    400: ApiErrorEnvelope;
+    /**
+     * Missing or invalid API key
+     */
+    401: ApiErrorEnvelope;
+    /**
+     * API key lacks required scope
+     */
+    403: ApiErrorEnvelope;
+    /**
+     * Resource not found
+     */
+    404: ApiErrorEnvelope;
+    /**
+     * Conflict. The resource is in a state that forbids the request.
+     */
+    409: ApiErrorEnvelope;
+    /**
+     * Payload too large. Upload exceeded the per-request size cap.
+     */
+    413: ApiErrorEnvelope;
+    /**
+     * Rate limit exceeded
+     */
+    429: ApiErrorEnvelope;
+    /**
+     * Internal server error
+     */
+    500: ApiErrorEnvelope;
+};
+
+export type AutomationsVersionsCreateError = AutomationsVersionsCreateErrors[keyof AutomationsVersionsCreateErrors];
+
+export type AutomationsVersionsCreateResponses = {
+    /**
+     * Created workflow version.
+     */
+    201: AutomationVersion;
+};
+
+export type AutomationsVersionsCreateResponse = AutomationsVersionsCreateResponses[keyof AutomationsVersionsCreateResponses];
+
+export type AutomationsVersionsPromoteData = {
+    body?: never;
+    path: {
+        /**
+         * Workflow id, agent id, or typed alias like workflows.slug / agents.slug
+         */
+        id: string;
+        /**
+         * Tagged version id from GET /automations/{id}/versions. Untagged snapshots (for example after restore) and unknown ids return 404.
+         */
+        versionId: string;
+    };
+    query?: never;
+    url: '/v1/automations/{id}/versions/{versionId}/promote';
+};
+
+export type AutomationsVersionsPromoteErrors = {
+    /**
+     * Validation error. Request shape did not match the spec.
+     */
+    400: ApiErrorEnvelope;
+    /**
+     * Missing or invalid API key
+     */
+    401: ApiErrorEnvelope;
+    /**
+     * API key lacks required scope
+     */
+    403: ApiErrorEnvelope;
+    /**
+     * Resource not found
+     */
+    404: ApiErrorEnvelope;
+    /**
+     * Conflict. The resource is in a state that forbids the request.
+     */
+    409: ApiErrorEnvelope;
+    /**
+     * Payload too large. Upload exceeded the per-request size cap.
+     */
+    413: ApiErrorEnvelope;
+    /**
+     * Rate limit exceeded
+     */
+    429: ApiErrorEnvelope;
+    /**
+     * Internal server error
+     */
+    500: ApiErrorEnvelope;
+};
+
+export type AutomationsVersionsPromoteError = AutomationsVersionsPromoteErrors[keyof AutomationsVersionsPromoteErrors];
+
+export type AutomationsVersionsPromoteResponses = {
+    /**
+     * Existing tagged workflow version promoted.
+     */
+    200: AutomationVersion;
+};
+
+export type AutomationsVersionsPromoteResponse = AutomationsVersionsPromoteResponses[keyof AutomationsVersionsPromoteResponses];
+
+export type AutomationsVersionsRestoreData = {
+    body: RestoreAutomationVersionRequest;
+    path: {
+        /**
+         * Workflow id, agent id, or typed alias like workflows.slug / agents.slug
+         */
+        id: string;
+        /**
+         * Version id from GET /automations/{id}/versions (a workflow history id).
+         */
+        versionId: string;
+    };
+    query?: never;
+    url: '/v1/automations/{id}/versions/{versionId}/restore';
+};
+
+export type AutomationsVersionsRestoreErrors = {
+    /**
+     * Validation error. Request shape did not match the spec.
+     */
+    400: ApiErrorEnvelope;
+    /**
+     * Missing or invalid API key
+     */
+    401: ApiErrorEnvelope;
+    /**
+     * API key lacks required scope
+     */
+    403: ApiErrorEnvelope;
+    /**
+     * Resource not found
+     */
+    404: ApiErrorEnvelope;
+    /**
+     * Conflict. The resource is in a state that forbids the request.
+     */
+    409: ApiErrorEnvelope;
+    /**
+     * Payload too large. Upload exceeded the per-request size cap.
+     */
+    413: ApiErrorEnvelope;
+    /**
+     * Rate limit exceeded
+     */
+    429: ApiErrorEnvelope;
+    /**
+     * Internal server error
+     */
+    500: ApiErrorEnvelope;
+};
+
+export type AutomationsVersionsRestoreError = AutomationsVersionsRestoreErrors[keyof AutomationsVersionsRestoreErrors];
+
+export type AutomationsVersionsRestoreResponses = {
+    /**
+     * New current version created from the restored snapshot.
+     */
+    201: AutomationVersion;
+};
+
+export type AutomationsVersionsRestoreResponse = AutomationsVersionsRestoreResponses[keyof AutomationsVersionsRestoreResponses];
+
 export type ExperimentsResolveData = {
     body?: never;
     path: {

package/src/index.ts

@@ -54,8 +54,10 @@ export type {
   AutomationTriggerState,
   AutomationTriggersResponse,
   AutomationVersion,
+  CreateAutomationVersionRequest,
   ExecutionStatus,
   File,
+  RestoreAutomationVersionRequest,
   Run,
   RunAccepted,
   RunArtifact,

package/src/resources/automations.ts

@@ -23,9 +23,15 @@ import {
   automationsReviewsHealth,
   automationsSync,
   automationsTriggersGet,
+  automationsVersionsCreate,
   automationsVersionsList,
+  automationsVersionsPromote,
+  automationsVersionsRestore,
 } from '../generated/sdk.gen';
-import type { AutomationsReviewsHealthData } from '../generated/types.gen';
+import type {
+  AutomationsReviewsHealthData,
+  CreateAutomationVersionRequest,
+} from '../generated/types.gen';
 
 type Dispatch = <T>(call: () => Promise<OperationResult<T>>) => Promise<T>;
 type SignalOptions = { signal?: AbortSignal };
@@ -74,6 +80,51 @@ export class AutomationsResource {
     );
   }
 
+  async createVersion(
+    id: string,
+    body: CreateAutomationVersionRequest,
+    options: SignalOptions = {}
+  ): Promise<AnyResponse> {
+    return this.dispatch(() =>
+      automationsVersionsCreate({
+        client: this.client,
+        path: { id },
+        body,
+        signal: options.signal,
+      })
+    );
+  }
+
+  async restoreVersion(
+    id: string,
+    versionId: string,
+    body: { message?: string } = {},
+    options: SignalOptions = {}
+  ): Promise<AnyResponse> {
+    return this.dispatch(() =>
+      automationsVersionsRestore({
+        client: this.client,
+        path: { id, versionId },
+        body,
+        signal: options.signal,
+      })
+    );
+  }
+
+  async promoteVersion(
+    id: string,
+    versionId: string,
+    options: SignalOptions = {}
+  ): Promise<AnyResponse> {
+    return this.dispatch(() =>
+      automationsVersionsPromote({
+        client: this.client,
+        path: { id, versionId },
+        signal: options.signal,
+      })
+    );
+  }
+
   async triggers(id: string, options: SignalOptions = {}): Promise<AnyResponse> {
     return this.dispatch(() =>
       automationsTriggersGet({ client: this.client, path: { id }, signal: options.signal })
@@ -163,7 +214,12 @@ export class AutomationExamplesResource {
 
   async list(
     automationId: string,
-    options: { limit?: number; offset?: number; signal?: AbortSignal } = {}
+    options: {
+      limit?: number;
+      offset?: number;
+      include?: 'full' | 'metadata';
+      signal?: AbortSignal;
+    } = {}
   ): Promise<AnyResponse> {
     const { signal, ...query } = options;
     return this.dispatch(() =>

package/src/telemetry.ts

@@ -19,7 +19,7 @@
 export const SDK_LANGUAGE = 'typescript';
 // Rewritten at publish time by scripts/release/platform/render-sdk-versions.sh.
 // Keep this string literal exactly stable — sed matches on it.
-export const SDK_VERSION = '0.12.2';
+export const SDK_VERSION = '0.13.0';
 
 function detectRuntime(): string {
   const g = globalThis as unknown as {