@eyepop.ai/eyepop 3.26.0 → 3.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -759,6 +759,13 @@ declare enum VlmAbilityStatus {
759
759
  draft = "draft",
760
760
  published = "published"
761
761
  }
762
+ /**
763
+ * The model a user-defined VLM ability runs on. `qwen3` (the default when neither `model` nor
764
+ * `worker_release` is set) runs on EyePop's GPUs; `gpt_6_astra` and `gemini_4_argon` call a remote model.
765
+ */
766
+ type VlmModel = 'qwen3' | 'gpt_6_astra' | 'gemini_4_argon';
767
+ /** The VLM worker release each {@link VlmModel} runs on. */
768
+ declare const VLM_MODEL_WORKER_RELEASES: Readonly<Record<VlmModel, string>>;
762
769
  interface AbilityAliasEntry {
763
770
  alias: string;
764
771
  tag: string;
@@ -775,7 +782,14 @@ interface AbilityAliasEntry {
775
782
  interface VlmAbilityCreate {
776
783
  name: string;
777
784
  description: string;
778
- worker_release: string;
785
+ /**
786
+ * @deprecated Use `model`. Still accepted when it names the release of a {@link VlmModel}
787
+ * (`qwen3_instruct`, `gpt-6-astra` or `gemini-4-argon`, compared lowercase with `_` as `-`),
788
+ * and it must then agree with `model` if both are set.
789
+ */
790
+ worker_release?: string;
791
+ /** The model the ability runs on; the Dataset API defaults to `qwen3`. */
792
+ model?: VlmModel;
779
793
  /** The prompt of a free-form ability; required unless `task` is set. */
780
794
  text_prompt?: string;
781
795
  transform_into?: TransformInto;
@@ -792,7 +806,14 @@ interface VlmAbilityCreate {
792
806
  interface VlmAbilityUpdate {
793
807
  name?: string;
794
808
  description?: string;
809
+ /**
810
+ * @deprecated Use `model`. Still accepted when it names the release of a {@link VlmModel}
811
+ * (`qwen3_instruct`, `gpt-6-astra` or `gemini-4-argon`, compared lowercase with `_` as `-`),
812
+ * and it must then agree with `model` if both are set.
813
+ */
795
814
  worker_release?: string;
815
+ /** The model the ability runs on; left out, the stored model is kept. */
816
+ model?: VlmModel;
796
817
  text_prompt?: string;
797
818
  transform_into?: TransformInto;
798
819
  response_schema?: ResponseSchema;
@@ -813,7 +834,14 @@ interface VlmAbility {
813
834
  name: string;
814
835
  description: string;
815
836
  vlm_ability_group_uuid?: string;
837
+ /** @deprecated Use `model`. The worker release the ability runs on, as stored. */
816
838
  worker_release?: string;
839
+ /**
840
+ * The model the ability runs on; `null` for a legacy worker release that is none of the
841
+ * {@link VlmModel}s. `DataEndpoint` derives it from `worker_release` when the Dataset API does not
842
+ * send it (`qwen3` when the release is unset), and reads a model this SDK does not know as `null`.
843
+ */
844
+ model?: VlmModel | null;
817
845
  text_prompt?: string;
818
846
  transform_into?: TransformInto;
819
847
  response_schema?: ResponseSchema;
@@ -1737,6 +1765,36 @@ declare class VlmAbilityModeError extends Error {
1737
1765
  readonly fields: string[];
1738
1766
  constructor(reason: VlmAbilityModeErrorReason, message: string, fields?: string[]);
1739
1767
  }
1768
+ /** Why `createVlmAbility` or `updateVlmAbility` refused an ability's `model` or `worker_release`. */
1769
+ declare enum VlmAbilityModelErrorReason {
1770
+ /** `model` is not a {@link VlmModel}. */
1771
+ unknown_model = "unknown_model",
1772
+ /** `worker_release` is not the release of a {@link VlmModel}. */
1773
+ unknown_worker_release = "unknown_worker_release",
1774
+ /** `model` and `worker_release` are both set and name different models. */
1775
+ model_conflict = "model_conflict"
1776
+ }
1777
+ /** Thrown, before any request, for a VLM ability whose `model` or deprecated `worker_release` the Dataset API would refuse. */
1778
+ declare class VlmAbilityModelError extends Error {
1779
+ readonly reason: VlmAbilityModelErrorReason;
1780
+ /** The fields at fault: `model`, `worker_release` or both. */
1781
+ readonly fields: string[];
1782
+ constructor(reason: VlmAbilityModelErrorReason, message: string, fields?: string[]);
1783
+ }
1784
+ /** The model of an ability that names neither `model` nor `worker_release`. */
1785
+ declare const DEFAULT_VLM_MODEL: VlmModel;
1786
+ /**
1787
+ * The comparable form of a worker release name: lowercase, `_` replaced by `-`.
1788
+ * `qwen3_instruct` and `Qwen3-Instruct` both normalize to `qwen3-instruct`.
1789
+ */
1790
+ declare function normalizeWorkerRelease(workerRelease: string): string;
1791
+ /** The model a worker release runs: `qwen3` for `null` or `undefined`, `null` for a release that is no model's. */
1792
+ declare function modelForWorkerRelease(workerRelease: string | null | undefined): VlmModel | null;
1793
+ /**
1794
+ * The worker release to store for an ability: the canonical release of the model the fields name,
1795
+ * `qwen3_instruct` when neither is set. Throws a {@link VlmAbilityModelError} like `createVlmAbility` does.
1796
+ */
1797
+ declare function resolveWorkerRelease(model: VlmModel | null | undefined, workerRelease: string | null | undefined): string;
1740
1798
  declare class DataEndpoint extends Endpoint<DataEndpoint> {
1741
1799
  private datasetApiUrl;
1742
1800
  private vlmApiUrl;
@@ -2406,4 +2464,4 @@ declare namespace EyePop {
2406
2464
  function dataEndpoint(opts?: DataOptions): DataEndpoint;
2407
2465
  }
2408
2466
 
2409
- export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, COMBINED_UPLOAD_MAX_BYTES, type Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DepthSemantic, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, MAX_OPEN_SOURCES, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, PIPELINE_PATH, PIPELINE_SOCKETS, type PathSource, PipelineBackend, PipelineCommandError, PipelineConfigurationError, type PipelineConfigurationProblem, PipelineJob, PipelineSocketClosedError, PipelineSourceError, type PlatformSupport, type Point2d, type Point3d, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, type PopForward, type PopForwardOperator, type PopSelect, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, SUBPROTOCOL, SelectMode, Semaphore, type Session, type SessionAuth, SessionBackend, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityModeError, VlmAbilityModeErrorReason, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, type WorkerBackend, type WorkerContext, WorkerEndpoint, type WorkerOptions, type WorkerSession, type WorkerWork, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, isSelectOperator, popSelects, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };
2467
+ export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, COMBINED_UPLOAD_MAX_BYTES, type Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DEFAULT_VLM_MODEL, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DepthSemantic, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, MAX_OPEN_SOURCES, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, PIPELINE_PATH, PIPELINE_SOCKETS, type PathSource, PipelineBackend, PipelineCommandError, PipelineConfigurationError, type PipelineConfigurationProblem, PipelineJob, PipelineSocketClosedError, PipelineSourceError, type PlatformSupport, type Point2d, type Point3d, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, type PopForward, type PopForwardOperator, type PopSelect, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, SUBPROTOCOL, SelectMode, Semaphore, type Session, type SessionAuth, SessionBackend, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VLM_MODEL_WORKER_RELEASES, type Vector3, type Vector3d, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityModeError, VlmAbilityModeErrorReason, VlmAbilityModelError, VlmAbilityModelErrorReason, VlmAbilityStatus, type VlmAbilityUpdate, type VlmModel, WebrtcBase, WebrtcWhep, WebrtcWhip, type WorkerBackend, type WorkerContext, WorkerEndpoint, type WorkerOptions, type WorkerSession, type WorkerWork, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, isSelectOperator, modelForWorkerRelease, normalizeWorkerRelease, popSelects, randomMultipartBoundary, readableStreamFromString, resolveAuth, resolveWorkerRelease, validateCamera, validatePop };
@@ -759,6 +759,13 @@ declare enum VlmAbilityStatus {
759
759
  draft = "draft",
760
760
  published = "published"
761
761
  }
762
+ /**
763
+ * The model a user-defined VLM ability runs on. `qwen3` (the default when neither `model` nor
764
+ * `worker_release` is set) runs on EyePop's GPUs; `gpt_6_astra` and `gemini_4_argon` call a remote model.
765
+ */
766
+ type VlmModel = 'qwen3' | 'gpt_6_astra' | 'gemini_4_argon';
767
+ /** The VLM worker release each {@link VlmModel} runs on. */
768
+ declare const VLM_MODEL_WORKER_RELEASES: Readonly<Record<VlmModel, string>>;
762
769
  interface AbilityAliasEntry {
763
770
  alias: string;
764
771
  tag: string;
@@ -775,7 +782,14 @@ interface AbilityAliasEntry {
775
782
  interface VlmAbilityCreate {
776
783
  name: string;
777
784
  description: string;
778
- worker_release: string;
785
+ /**
786
+ * @deprecated Use `model`. Still accepted when it names the release of a {@link VlmModel}
787
+ * (`qwen3_instruct`, `gpt-6-astra` or `gemini-4-argon`, compared lowercase with `_` as `-`),
788
+ * and it must then agree with `model` if both are set.
789
+ */
790
+ worker_release?: string;
791
+ /** The model the ability runs on; the Dataset API defaults to `qwen3`. */
792
+ model?: VlmModel;
779
793
  /** The prompt of a free-form ability; required unless `task` is set. */
780
794
  text_prompt?: string;
781
795
  transform_into?: TransformInto;
@@ -792,7 +806,14 @@ interface VlmAbilityCreate {
792
806
  interface VlmAbilityUpdate {
793
807
  name?: string;
794
808
  description?: string;
809
+ /**
810
+ * @deprecated Use `model`. Still accepted when it names the release of a {@link VlmModel}
811
+ * (`qwen3_instruct`, `gpt-6-astra` or `gemini-4-argon`, compared lowercase with `_` as `-`),
812
+ * and it must then agree with `model` if both are set.
813
+ */
795
814
  worker_release?: string;
815
+ /** The model the ability runs on; left out, the stored model is kept. */
816
+ model?: VlmModel;
796
817
  text_prompt?: string;
797
818
  transform_into?: TransformInto;
798
819
  response_schema?: ResponseSchema;
@@ -813,7 +834,14 @@ interface VlmAbility {
813
834
  name: string;
814
835
  description: string;
815
836
  vlm_ability_group_uuid?: string;
837
+ /** @deprecated Use `model`. The worker release the ability runs on, as stored. */
816
838
  worker_release?: string;
839
+ /**
840
+ * The model the ability runs on; `null` for a legacy worker release that is none of the
841
+ * {@link VlmModel}s. `DataEndpoint` derives it from `worker_release` when the Dataset API does not
842
+ * send it (`qwen3` when the release is unset), and reads a model this SDK does not know as `null`.
843
+ */
844
+ model?: VlmModel | null;
817
845
  text_prompt?: string;
818
846
  transform_into?: TransformInto;
819
847
  response_schema?: ResponseSchema;
@@ -1737,6 +1765,36 @@ declare class VlmAbilityModeError extends Error {
1737
1765
  readonly fields: string[];
1738
1766
  constructor(reason: VlmAbilityModeErrorReason, message: string, fields?: string[]);
1739
1767
  }
1768
+ /** Why `createVlmAbility` or `updateVlmAbility` refused an ability's `model` or `worker_release`. */
1769
+ declare enum VlmAbilityModelErrorReason {
1770
+ /** `model` is not a {@link VlmModel}. */
1771
+ unknown_model = "unknown_model",
1772
+ /** `worker_release` is not the release of a {@link VlmModel}. */
1773
+ unknown_worker_release = "unknown_worker_release",
1774
+ /** `model` and `worker_release` are both set and name different models. */
1775
+ model_conflict = "model_conflict"
1776
+ }
1777
+ /** Thrown, before any request, for a VLM ability whose `model` or deprecated `worker_release` the Dataset API would refuse. */
1778
+ declare class VlmAbilityModelError extends Error {
1779
+ readonly reason: VlmAbilityModelErrorReason;
1780
+ /** The fields at fault: `model`, `worker_release` or both. */
1781
+ readonly fields: string[];
1782
+ constructor(reason: VlmAbilityModelErrorReason, message: string, fields?: string[]);
1783
+ }
1784
+ /** The model of an ability that names neither `model` nor `worker_release`. */
1785
+ declare const DEFAULT_VLM_MODEL: VlmModel;
1786
+ /**
1787
+ * The comparable form of a worker release name: lowercase, `_` replaced by `-`.
1788
+ * `qwen3_instruct` and `Qwen3-Instruct` both normalize to `qwen3-instruct`.
1789
+ */
1790
+ declare function normalizeWorkerRelease(workerRelease: string): string;
1791
+ /** The model a worker release runs: `qwen3` for `null` or `undefined`, `null` for a release that is no model's. */
1792
+ declare function modelForWorkerRelease(workerRelease: string | null | undefined): VlmModel | null;
1793
+ /**
1794
+ * The worker release to store for an ability: the canonical release of the model the fields name,
1795
+ * `qwen3_instruct` when neither is set. Throws a {@link VlmAbilityModelError} like `createVlmAbility` does.
1796
+ */
1797
+ declare function resolveWorkerRelease(model: VlmModel | null | undefined, workerRelease: string | null | undefined): string;
1740
1798
  declare class DataEndpoint extends Endpoint<DataEndpoint> {
1741
1799
  private datasetApiUrl;
1742
1800
  private vlmApiUrl;
@@ -2406,4 +2464,4 @@ declare namespace EyePop {
2406
2464
  function dataEndpoint(opts?: DataOptions): DataEndpoint;
2407
2465
  }
2408
2466
 
2409
- export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, COMBINED_UPLOAD_MAX_BYTES, type Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DepthSemantic, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, MAX_OPEN_SOURCES, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, PIPELINE_PATH, PIPELINE_SOCKETS, type PathSource, PipelineBackend, PipelineCommandError, PipelineConfigurationError, type PipelineConfigurationProblem, PipelineJob, PipelineSocketClosedError, PipelineSourceError, type PlatformSupport, type Point2d, type Point3d, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, type PopForward, type PopForwardOperator, type PopSelect, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, SUBPROTOCOL, SelectMode, Semaphore, type Session, type SessionAuth, SessionBackend, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, type Vector3, type Vector3d, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityModeError, VlmAbilityModeErrorReason, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, type WorkerBackend, type WorkerContext, WorkerEndpoint, type WorkerOptions, type WorkerSession, type WorkerWork, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, isSelectOperator, popSelects, randomMultipartBoundary, readableStreamFromString, resolveAuth, validateCamera, validatePop };
2467
+ export { type AbilityAliasEntry, AbstractJob, type AccessTokenAuth, type AliasResolution, type Annotation, AnnotationInclusionMode, AnnotationType, type ApiKeyAuth, type Area, AreaType, ArtifactType, type Asset, type AssetImport, AssetInclusionMode, AssetStatus, AssetUrlType, type AssetUuidSource, type Auth0Options, type Authentication, type AutoAnnotate, type AutoAnnotateParams, type AutoAnnotatePrompt, AutoAnnotateStatus, AutoAnnotateTask, type AutoPromptConfig, type AutoTask, type BaseArea, type BaseComponent, type BaseTask, type Box, COMBINED_UPLOAD_MAX_BYTES, type Camera, type CameraDistortion, type CameraExtrinsics, type CameraIntrinsics, type ChangeEvent, ChangeType, type ClassificationTask, type CloudBounds, type CloudBox, type ComponentFinderComponent, type ComponentParams, ComputeAccountMismatchError, ComputeApiError, type Contour, type ContourArea, type ContourFinderComponent, ContourType, type CreateWorkflow, type CreateWorkflowConfig, DEFAULT_PREDICTION_VERSION, DEFAULT_VLM_MODEL, DataApiType, DataEndpoint, type DataOptions, type DataSession, type Dataset, type DatasetAutoAnnotate, type DatasetAutoAnnotateCreate, type DatasetAutoAnnotateUpdate, type DatasetCreate, type DatasetHeroAssetUpdate, type DatasetParent, type DatasetUpdate, type DatasetVersion, type DatasetVersionAssetStats, type Depth, DepthMap, type DepthSemantic, type DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyePopDataWebSocketError, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromGroupJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, MAX_OPEN_SOURCES, type Mask, type MediaStreamSource, type Model, type ModelCreate, type ModelExport, ModelExportStatus, ModelFormat, type ModelMetrics, ModelPrecisionType, type ModelSample, ModelStatus, ModelTask, type ModelTrainingProgress, ModelTrainingStage, ModelType, type ModelUpdate, type MotionDetectConfig, MotionModel, type MultipartContent, type MultipartPart, type OAuth2Auth, type OnChangeEvent, type Options, PIPELINE_PATH, PIPELINE_SOCKETS, type PathSource, PipelineBackend, PipelineCommandError, PipelineConfigurationError, type PipelineConfigurationProblem, PipelineJob, PipelineSocketClosedError, PipelineSourceError, type PlatformSupport, type Point2d, type Point3d, PointCloud, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopDepthMap, type PopForward, type PopForwardOperator, type PopSelect, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, QUATERNION_TOLERANCE, type QcAiHubExportParams, type Quaternion, type RectangleArea, type ResponseSchema, type ResultStream, type Roi, SUBPROTOCOL, SelectMode, Semaphore, type Session, type SessionAuth, SessionBackend, type Source, type SourceDefaults, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VLM_MODEL_WORKER_RELEASES, type Vector3, type Vector3d, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityModeError, VlmAbilityModeErrorReason, VlmAbilityModelError, VlmAbilityModelErrorReason, VlmAbilityStatus, type VlmAbilityUpdate, type VlmModel, WebrtcBase, WebrtcWhep, WebrtcWhip, type WorkerBackend, type WorkerContext, WorkerEndpoint, type WorkerOptions, type WorkerSession, type WorkerWork, type Workflow, WorkflowPhase, accessTokenCredential, apiKeyCredential, cloudOfDepth, cloudOfObject, cloudsOfPrediction, decodeDepthMap, decodePointCloud, EyePop as default, encodeMultipartFormData, getBaseUrl, isSelectOperator, modelForWorkerRelease, normalizeWorkerRelease, popSelects, randomMultipartBoundary, readableStreamFromString, resolveAuth, resolveWorkerRelease, validateCamera, validatePop };
@@ -8672,6 +8672,7 @@ __export(index_exports, {
8672
8672
  ComputeApiError: () => ComputeApiError,
8673
8673
  ContourType: () => ContourType,
8674
8674
  DEFAULT_PREDICTION_VERSION: () => DEFAULT_PREDICTION_VERSION,
8675
+ DEFAULT_VLM_MODEL: () => DEFAULT_VLM_MODEL,
8675
8676
  DataApiType: () => DataApiType,
8676
8677
  DataEndpoint: () => DataEndpoint,
8677
8678
  DepthMap: () => DepthMap,
@@ -8721,9 +8722,12 @@ __export(index_exports, {
8721
8722
  UploadGroupJob: () => UploadGroupJob,
8722
8723
  UploadJob: () => UploadJob,
8723
8724
  UserReview: () => UserReview,
8725
+ VLM_MODEL_WORKER_RELEASES: () => VLM_MODEL_WORKER_RELEASES,
8724
8726
  VideoMode: () => VideoMode,
8725
8727
  VlmAbilityModeError: () => VlmAbilityModeError,
8726
8728
  VlmAbilityModeErrorReason: () => VlmAbilityModeErrorReason,
8729
+ VlmAbilityModelError: () => VlmAbilityModelError,
8730
+ VlmAbilityModelErrorReason: () => VlmAbilityModelErrorReason,
8727
8731
  VlmAbilityStatus: () => VlmAbilityStatus,
8728
8732
  WebrtcBase: () => WebrtcBase,
8729
8733
  WebrtcWhep: () => WebrtcWhep,
@@ -8741,10 +8745,13 @@ __export(index_exports, {
8741
8745
  encodeMultipartFormData: () => encodeMultipartFormData,
8742
8746
  getBaseUrl: () => getBaseUrl,
8743
8747
  isSelectOperator: () => isSelectOperator,
8748
+ modelForWorkerRelease: () => modelForWorkerRelease,
8749
+ normalizeWorkerRelease: () => normalizeWorkerRelease,
8744
8750
  popSelects: () => popSelects,
8745
8751
  randomMultipartBoundary: () => randomMultipartBoundary,
8746
8752
  readableStreamFromString: () => readableStreamFromString,
8747
8753
  resolveAuth: () => resolveAuth,
8754
+ resolveWorkerRelease: () => resolveWorkerRelease,
8748
8755
  validateCamera: () => validateCamera,
8749
8756
  validatePop: () => validatePop
8750
8757
  });
@@ -13000,6 +13007,11 @@ var VlmAbilityStatus = /* @__PURE__ */ ((VlmAbilityStatus2) => {
13000
13007
  VlmAbilityStatus2["published"] = "published";
13001
13008
  return VlmAbilityStatus2;
13002
13009
  })(VlmAbilityStatus || {});
13010
+ var VLM_MODEL_WORKER_RELEASES = Object.freeze({
13011
+ qwen3: "qwen3_instruct",
13012
+ gpt_6_astra: "gpt-6-astra",
13013
+ gemini_4_argon: "gemini-4-argon"
13014
+ });
13003
13015
 
13004
13016
  // data/jobs.ts
13005
13017
  var InferAssetJob = class {
@@ -13256,6 +13268,87 @@ function validateVlmAbilityMode(ability, partial) {
13256
13268
  throw new VlmAbilityModeError("missing_mode" /* missing_mode */, `${kind}: set either text_prompt (free-form) or task with non-empty prompts`, ["text_prompt", "task"]);
13257
13269
  }
13258
13270
  }
13271
+ var VlmAbilityModelErrorReason = /* @__PURE__ */ ((VlmAbilityModelErrorReason2) => {
13272
+ VlmAbilityModelErrorReason2["unknown_model"] = "unknown_model";
13273
+ VlmAbilityModelErrorReason2["unknown_worker_release"] = "unknown_worker_release";
13274
+ VlmAbilityModelErrorReason2["model_conflict"] = "model_conflict";
13275
+ return VlmAbilityModelErrorReason2;
13276
+ })(VlmAbilityModelErrorReason || {});
13277
+ var VlmAbilityModelError = class extends Error {
13278
+ constructor(reason, message, fields = []) {
13279
+ super(message);
13280
+ this.name = "VlmAbilityModelError";
13281
+ this.reason = reason;
13282
+ this.fields = fields;
13283
+ }
13284
+ };
13285
+ var VLM_MODELS = Object.keys(VLM_MODEL_WORKER_RELEASES);
13286
+ var DEFAULT_VLM_MODEL = "qwen3";
13287
+ function isVlmModel(value) {
13288
+ return typeof value === "string" && Object.prototype.hasOwnProperty.call(VLM_MODEL_WORKER_RELEASES, value);
13289
+ }
13290
+ function normalizeWorkerRelease(workerRelease) {
13291
+ return workerRelease.toLowerCase().replace(/_/g, "-");
13292
+ }
13293
+ function modelForWorkerRelease(workerRelease) {
13294
+ if (workerRelease === void 0 || workerRelease === null) {
13295
+ return DEFAULT_VLM_MODEL;
13296
+ }
13297
+ const normalized = normalizeWorkerRelease(workerRelease);
13298
+ return VLM_MODELS.find((model) => normalizeWorkerRelease(VLM_MODEL_WORKER_RELEASES[model]) === normalized) ?? null;
13299
+ }
13300
+ function checkModelAndWorkerRelease(model, workerRelease, prefix) {
13301
+ const modelSet = isSet(model);
13302
+ if (modelSet && !isVlmModel(model)) {
13303
+ throw new VlmAbilityModelError("unknown_model" /* unknown_model */, `${prefix}unknown model '${String(model)}'; set \`model\` to one of ${VLM_MODELS.join(", ")}`, ["model"]);
13304
+ }
13305
+ if (!isSet(workerRelease)) {
13306
+ return modelSet ? model : null;
13307
+ }
13308
+ const releaseModel = typeof workerRelease === "string" ? modelForWorkerRelease(workerRelease) : null;
13309
+ if (releaseModel === null) {
13310
+ throw new VlmAbilityModelError(
13311
+ "unknown_worker_release" /* unknown_worker_release */,
13312
+ `${prefix}unknown worker_release '${String(workerRelease)}'; worker_release is deprecated, set \`model\` to one of ${VLM_MODELS.join(", ")}`,
13313
+ ["worker_release"]
13314
+ );
13315
+ }
13316
+ if (modelSet && releaseModel !== model) {
13317
+ throw new VlmAbilityModelError(
13318
+ "model_conflict" /* model_conflict */,
13319
+ `${prefix}worker_release '${String(workerRelease)}' runs model ${releaseModel}, not ${String(model)}; worker_release is deprecated, set only \`model\``,
13320
+ ["model", "worker_release"]
13321
+ );
13322
+ }
13323
+ return releaseModel;
13324
+ }
13325
+ function resolveWorkerRelease(model, workerRelease) {
13326
+ return VLM_MODEL_WORKER_RELEASES[checkModelAndWorkerRelease(model, workerRelease, "") ?? DEFAULT_VLM_MODEL];
13327
+ }
13328
+ function withVlmModel(ability) {
13329
+ if (!ability || typeof ability !== "object") {
13330
+ return ability;
13331
+ }
13332
+ if (!("model" in ability)) {
13333
+ return { ...ability, model: modelForWorkerRelease(ability.worker_release) };
13334
+ }
13335
+ if (isSet(ability.model) && !isVlmModel(ability.model)) {
13336
+ return { ...ability, model: null };
13337
+ }
13338
+ return ability;
13339
+ }
13340
+ var warnedWorkerRelease = false;
13341
+ function prepareVlmAbilityModel(ability, partial) {
13342
+ if (isSet(ability.worker_release) && !warnedWorkerRelease) {
13343
+ warnedWorkerRelease = true;
13344
+ console.warn("worker_release is deprecated, set model to a VlmModel instead");
13345
+ }
13346
+ checkModelAndWorkerRelease(ability.model, ability.worker_release, partial ? "VLM ability update: " : "VLM ability: ");
13347
+ if (isSet(ability.model) && !isSet(ability.worker_release)) {
13348
+ return { ...ability, worker_release: VLM_MODEL_WORKER_RELEASES[ability.model] };
13349
+ }
13350
+ return ability;
13351
+ }
13259
13352
  var DataEndpoint = class extends Endpoint {
13260
13353
  constructor(options) {
13261
13354
  super(options);
@@ -14044,21 +14137,22 @@ var DataEndpoint = class extends Endpoint {
14044
14137
  async listVlmAbilities() {
14045
14138
  return this.request(`/vlm_abilities?account_uuid=${this._accountId}`, {
14046
14139
  method: "GET"
14047
- });
14140
+ }).then((abilities) => Array.isArray(abilities) ? abilities.map(withVlmModel) : abilities);
14048
14141
  }
14049
14142
  async createVlmAbility(create, vlm_ability_group_uuid) {
14050
14143
  validateVlmAbilityMode(create, false);
14144
+ const body = prepareVlmAbilityModel(create, false);
14051
14145
  const groupQuery = vlm_ability_group_uuid ? `&vlm_ability_group_uuid=${vlm_ability_group_uuid}` : "";
14052
14146
  return this.request(`/vlm_abilities?account_uuid=${this._accountId}${groupQuery}`, {
14053
14147
  method: "POST",
14054
- body: JSON.stringify(create, omit_nulls),
14148
+ body: JSON.stringify(body, omit_nulls),
14055
14149
  headers: { "Content-Type": "application/json" }
14056
- });
14150
+ }).then(withVlmModel);
14057
14151
  }
14058
14152
  async getVlmAbility(vlm_ability_uuid) {
14059
14153
  return this.request(`/vlm_abilities/${vlm_ability_uuid}`, {
14060
14154
  method: "GET"
14061
- });
14155
+ }).then(withVlmModel);
14062
14156
  }
14063
14157
  async deleteVlmAbility(vlm_ability_uuid) {
14064
14158
  return this.request(`/vlm_abilities/${vlm_ability_uuid}`, {
@@ -14067,11 +14161,12 @@ var DataEndpoint = class extends Endpoint {
14067
14161
  }
14068
14162
  async updateVlmAbility(vlm_ability_uuid, update) {
14069
14163
  validateVlmAbilityMode(update, true);
14164
+ const body = prepareVlmAbilityModel(update, true);
14070
14165
  return this.request(`/vlm_abilities/${vlm_ability_uuid}`, {
14071
14166
  method: "PATCH",
14072
- body: JSON.stringify(update),
14167
+ body: JSON.stringify(body),
14073
14168
  headers: { "Content-Type": "application/json" }
14074
- });
14169
+ }).then(withVlmModel);
14075
14170
  }
14076
14171
  async refineVlmAbility(vlm_ability_uuid, auto_prompt, auto_task) {
14077
14172
  if (auto_prompt !== void 0) {
@@ -14079,13 +14174,13 @@ var DataEndpoint = class extends Endpoint {
14079
14174
  method: "POST",
14080
14175
  body: JSON.stringify(auto_prompt, omit_nulls),
14081
14176
  headers: { "Content-Type": "application/json" }
14082
- });
14177
+ }).then(withVlmModel);
14083
14178
  } else if (auto_task !== void 0) {
14084
14179
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/refine_task`, {
14085
14180
  method: "POST",
14086
14181
  body: JSON.stringify(auto_task, omit_nulls),
14087
14182
  headers: { "Content-Type": "application/json" }
14088
- });
14183
+ }).then(withVlmModel);
14089
14184
  } else {
14090
14185
  return Promise.reject("refine vlm ability requires auto_prompt or auto_config parameter");
14091
14186
  }
@@ -14105,24 +14200,24 @@ var DataEndpoint = class extends Endpoint {
14105
14200
  }
14106
14201
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/clone?${params.toString()}`, {
14107
14202
  method: "POST"
14108
- });
14203
+ }).then(withVlmModel);
14109
14204
  }
14110
14205
  async publishVlmAbility(vlm_ability_uuid, alias_name, tag_name) {
14111
14206
  const alias_name_query = alias_name ? `alias_name=${encodeURIComponent(alias_name)}&` : "";
14112
14207
  const tag_name_query = tag_name ? `tag_name=${encodeURIComponent(tag_name)}&` : "";
14113
14208
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/publish?${alias_name_query}${tag_name_query}`, {
14114
14209
  method: "POST"
14115
- });
14210
+ }).then(withVlmModel);
14116
14211
  }
14117
14212
  async addVlmAbilityAlias(vlm_ability_uuid, alias_name, tag_name) {
14118
14213
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/alias/${encodeURIComponent(alias_name)}/tag/${tag_name ? encodeURIComponent(tag_name) : ""}`, {
14119
14214
  method: "POST"
14120
- });
14215
+ }).then(withVlmModel);
14121
14216
  }
14122
14217
  async removeVlmAbilityAlias(vlm_ability_uuid, alias_name, tag_name) {
14123
14218
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/alias/${encodeURIComponent(alias_name)}/tag/${encodeURIComponent(tag_name)}`, {
14124
14219
  method: "DELETE"
14125
- });
14220
+ }).then(withVlmModel);
14126
14221
  }
14127
14222
  async listVlmAbilityEvaluations(vlm_ability_uuid) {
14128
14223
  return this.request(`/vlm_abilities/${vlm_ability_uuid}/evaluations`, {
@@ -14710,6 +14805,7 @@ var index_default = EyePop;
14710
14805
  ComputeApiError,
14711
14806
  ContourType,
14712
14807
  DEFAULT_PREDICTION_VERSION,
14808
+ DEFAULT_VLM_MODEL,
14713
14809
  DataApiType,
14714
14810
  DataEndpoint,
14715
14811
  DepthMap,
@@ -14759,9 +14855,12 @@ var index_default = EyePop;
14759
14855
  UploadGroupJob,
14760
14856
  UploadJob,
14761
14857
  UserReview,
14858
+ VLM_MODEL_WORKER_RELEASES,
14762
14859
  VideoMode,
14763
14860
  VlmAbilityModeError,
14764
14861
  VlmAbilityModeErrorReason,
14862
+ VlmAbilityModelError,
14863
+ VlmAbilityModelErrorReason,
14765
14864
  VlmAbilityStatus,
14766
14865
  WebrtcBase,
14767
14866
  WebrtcWhep,
@@ -14778,10 +14877,13 @@ var index_default = EyePop;
14778
14877
  encodeMultipartFormData,
14779
14878
  getBaseUrl,
14780
14879
  isSelectOperator,
14880
+ modelForWorkerRelease,
14881
+ normalizeWorkerRelease,
14781
14882
  popSelects,
14782
14883
  randomMultipartBoundary,
14783
14884
  readableStreamFromString,
14784
14885
  resolveAuth,
14886
+ resolveWorkerRelease,
14785
14887
  validateCamera,
14786
14888
  validatePop
14787
14889
  });