@eyepop.ai/eyepop 3.15.1 → 3.17.0

package/README.md

@@ -50,24 +50,24 @@ Set `EYEPOP_API_KEY` in your server environment. API keys are secrets and must n
 export EYEPOP_API_KEY=<your_api_key>
 ```
 
-For provisioned persistent worker sessions, also set `EYEPOP_SESSION_UUID`.
+Create transient sessions with a pop when the worker endpoint is constructed. This lets EyePop schedule the right compute before media is processed.
 
 ```typescript
 import { EyePop } from '@eyepop.ai/eyepop'
 
 ;(async () => {
-    const endpoint = await EyePop.workerEndpoint().connect()
-    try {
-        await endpoint.changePop({
+    const endpoint = await EyePop.workerEndpoint({
+        pop: {
             components: [
                 {
                     type: 'inference',
-                    model: 'eyepop.person:latest',
+                    ability: 'eyepop.person:latest',
                     categoryName: 'person',
                 },
             ],
-        })
-
+        },
+    }).connect()
+    try {
         const results = await endpoint.process({ source: { path: 'examples/example.jpg' } })
         for await (const result of results) {
             console.log(result)
@@ -78,6 +78,29 @@ import { EyePop } from '@eyepop.ai/eyepop'
 })()
 ```
 
+For transient sessions, pass `pop` when creating the endpoint whenever possible. Use `endpoint.changePop(pop)` only when an already connected transient worker needs to switch Pops.
+
+When `sessionUuid` is not provided, the SDK creates compute sessions with `POST /v1/sessions?wait=true`.
+
+ModelLess CPU pops use the same constructor-pop path:
+
+```typescript
+const endpoint = await EyePop.workerEndpoint({
+    pop: {
+        components: [
+            {
+                type: 'inference',
+                ability: 'eyepop.localize-objects:latest',
+                categoryName: 'objects',
+                params: {
+                    prompts: [{ prompt: 'person' }],
+                },
+            },
+        ],
+    },
+}).connect()
+```
+
 You can also pass the key explicitly from server-side configuration:
 
 ```typescript
@@ -116,6 +139,31 @@ import { EyePop } from '@eyepop.ai/eyepop'
 
 Persistent sessions are normally preconfigured. In that case, process media directly and do not call `changePop()` unless your deployment is meant to accept runtime Pop changes.
 
+Persistent deployments are created through compute-api or EyePop tooling. For example, a trusted server can create a persistent deployment with an inline pop and then pass the returned `session_uuid` to the SDK:
+
+```shell
+curl -sS -X POST "https://compute.eyepop.ai/v1/deployments?wait=true" \
+  -H "Authorization: Bearer $EYEPOP_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "display_name": "node-modeless-deployment",
+    "pop": {
+      "components": [
+        {
+          "type": "inference",
+          "ability": "eyepop.localize-objects:latest",
+          "categoryName": "objects",
+          "params": {
+            "prompts": [{ "prompt": "person" }]
+          }
+        }
+      ]
+    }
+  }'
+```
+
+The response includes `session_uuid`, `session_status`, `status_url`, and worker access metadata. Poll `status_url` until the deployment reaches `pipeline_ok`, then connect with `sessionUuid`.
+
 ### Browser and Mobile Clients
 
 Do not put `EYEPOP_API_KEY` in browser or mobile application code. Create EyePop sessions from a trusted backend, then pass only the session JSON to the client.
@@ -133,7 +181,7 @@ Dashboard users can run local browser demos with the current browser session:
                 components: [
                     {
                         type: 'inference',
-                        model: 'eyepop.person:latest',
+                        ability: 'eyepop.person:latest',
                         categoryName: 'person',
                     },
                 ],
@@ -181,6 +229,33 @@ const results = await endpoint.process({
 })
 ```
 
+### Image Groups (multiple images, one result)
+
+Send several images as a **single** source that the pop processes **together** as one inference unit — for example a multi-image VLM prompt. The group yields **one** prediction for the whole set, unlike batching below, where each image is an independent inference.
+
+```typescript
+// Local files
+const results = await endpoint.uploadGroup(['a.jpg', 'b.jpg', 'c.jpg'])
+for await (const result of results) {
+    console.log(result)
+}
+
+// In-memory streams (optional parallel MIME types)
+import fs from 'node:fs'
+import { Readable } from 'node:stream'
+const stream1 = Readable.toWeb(fs.createReadStream('a.jpg'))
+const stream2 = Readable.toWeb(fs.createReadStream('b.jpg'))
+const results = await endpoint.uploadStreamGroup([stream1, stream2], ['image/jpeg', 'image/jpeg'])
+
+// Remote URLs (the server fetches each)
+const results = await endpoint.loadFromGroup([
+    'https://example.com/a.jpg',
+    'https://example.com/b.jpg',
+])
+```
+
+Image order is preserved end-to-end. A group may contain **up to 16 images** (enforced server-side). The pop's ability must be multi-image-capable; a single-image ability handed a group returns an error.
+
 ### Canceling Jobs
 
 Queued and in-progress jobs can be cancelled from the result iterator:
@@ -200,18 +275,18 @@ for await (const result of results) {
 
 ## Endpoint Options
 
-By default, `EyePop.workerEndpoint().connect()` starts a worker when needed and cancels queued jobs on that worker when it connects.
+By default, `EyePop.workerEndpoint({ pop }).connect()` starts a transient worker when needed and cancels queued jobs on that worker when it connects.
 
 Disable worker startup:
 
 ```typescript
-const endpoint = await EyePop.workerEndpoint({ autoStart: false }).connect()
+const endpoint = await EyePop.workerEndpoint({ pop, autoStart: false }).connect()
 ```
 
 Keep pending jobs:
 
 ```typescript
-const endpoint = await EyePop.workerEndpoint({ stopJobs: false }).connect()
+const endpoint = await EyePop.workerEndpoint({ pop, stopJobs: false }).connect()
 ```
 
 ## Visualization

package/dist/eyepop.index.d.mts

@@ -735,8 +735,15 @@ declare enum PredictionVersion {
 }
 declare const DEFAULT_PREDICTION_VERSION: PredictionVersion;
 interface WorkerSession extends Session {
+    /**
+     * @deprecated Pop ids are only retained for backwards compatibility.
+     * Configure transient sessions with `WorkerOptions.pop`.
+     */
     readonly popId: string;
     readonly baseUrl: string | undefined;
+    /**
+     * Transient sessions may not have a pipeline until the first source is processed.
+     */
     readonly pipelineId: string | undefined;
     authenticationHeaders(): any;
 }
@@ -1068,37 +1075,38 @@ declare class Endpoint<T extends Endpoint<T>> {
     private currentAccessToken;
 }
 
+/**
+ * @deprecated Configure transient sessions with `WorkerOptions.pop`.
+ * Support for pop id will be removed in 3.16.
+ */
 declare enum TransientPopId {
     Transient = "transient"
 }
 interface WorkerOptions extends Options {
     /**
-     * TODO: deprecated, support for pop id will be removed in 3.16
+     * @deprecated Pass `pop` for transient sessions or `sessionUuid` for persistent sessions.
+     * Support for pop id will be removed in 3.16.
      */
     popId?: string | TransientPopId | undefined;
     sessionUuid?: string | undefined;
+    sessionName?: string | undefined;
+    pipelineImage?: string | undefined;
+    pipelineVersion?: string | undefined;
+    pop?: Pop | undefined;
+    sessionReadyTimeoutSeconds?: number | undefined;
     autoStart?: boolean;
     stopJobs?: boolean;
     isLocalMode?: boolean;
 }
 
-declare enum SessionStatus {
-    UNKNOWN = "unknown",
-    PENDING = "pending",
-    RUNNING = "running",
-    STOPPED = "stopped",
-    FAILED = "failed",
-    ERROR = "error",
-    PIPELINE_CREATING = "pipeline_creating",
-    PIPELINE_OK = "pipeline_ok",
-    PIPELINE_CHECKING = "pipeline_checking",
-    PIPELINE_ERROR = "pipeline_error"
-}
 declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private _baseUrl;
     private _pipelineId;
     private _popName;
+    private _sessionAccessToken;
+    private _sessionAccessTokenValidUntil;
     private _pipeline;
+    private _pipelineCreatePromise;
     constructor(options: WorkerOptions);
     private options;
     disconnect(wait?: boolean): Promise<void>;
@@ -1108,6 +1116,10 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     pop(): Pop | null;
     changePop(pop: Pop): Promise<void>;
     private _authenticationHeaders;
+    /**
+     * @deprecated Pop ids are only retained for backwards compatibility.
+     * Configure transient sessions with `WorkerOptions.pop`.
+     */
     popId(): string | null;
     /**
      * V1 call to process media as a source with optional component params
@@ -1128,6 +1140,9 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     process({ source, componentParams, motionDetect, roi }: ProcessRequest): Promise<ResultStream>;
     private processV1;
     private processV2;
+    uploadGroup(paths: string[], params?: ProcessParams): Promise<ResultStream>;
+    uploadStreamGroup(streams: Array<ReadableStream<Uint8Array> | Blob | BufferSource>, mimeTypes?: string[], params?: ProcessParams): Promise<ResultStream>;
+    loadFromGroup(urls: string[], params?: ProcessParams): Promise<ResultStream>;
     private uploadFile;
     private uploadStream;
     private uploadPath;
@@ -1138,13 +1153,16 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private jobStatus;
     protected reconnect(): Promise<WorkerEndpoint>;
     private startWebApiSessionWithPopId;
-    private static SESSION_DEAD;
     private static WAIT_FOR_IS_READY;
-    private static CHECK_FOR_IS_READY_INTERVAL;
+    private sessionReadyTimeoutMs;
     private getComputeSession;
-    private getOnDemandComputeSession;
-    private getPermanentComputeSession;
     private startTransientPipeline;
+    private ensureTransientPipelineStarted;
+    private changeTransientPop;
+    private deleteTransientPipeline;
+    protected authorizationHeader(): Promise<string>;
+    private computeAuthorizationHeader;
+    private setTransientPipelinePop;
 }
 
 interface DataOptions extends Options {
@@ -1307,6 +1325,18 @@ declare class EyepopLineDecoder {
     flush(): string[];
 }
 declare function readableStreamFromString(s: string): ReadableStream<Uint8Array>;
+type MultipartContent = ReadableStream<Uint8Array> | Blob | BufferSource | string;
+interface MultipartPart {
+    name: string;
+    contentType?: string | null;
+    content: MultipartContent;
+}
+declare function randomMultipartBoundary(): string;
+/**
+ * Streams a multipart/form-data body part by part, piping each part's bytes through as they
+ * become available instead of buffering any part's full content in memory first.
+ */
+declare function encodeMultipartFormData(parts: MultipartPart[], boundary: string): ReadableStream<Uint8Array>;
 
 declare class AbstractJob implements ResultStream {
     protected _getSession: () => Promise<WorkerSession>;
@@ -1341,6 +1371,22 @@ declare class LoadFromJob extends AbstractJob {
     get [Symbol.toStringTag](): string;
     protected startJob(): Promise<Response>;
 }
+interface UploadSource {
+    readonly stream: ReadableStream<Uint8Array> | Blob | BufferSource;
+    readonly mimeType: string | null;
+}
+declare class UploadGroupJob extends AbstractJob {
+    private readonly _sources;
+    get [Symbol.toStringTag](): string;
+    constructor(sources: UploadSource[], params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
+    protected startJob(): Promise<Response>;
+}
+declare class LoadFromGroupJob extends AbstractJob {
+    private readonly _urls;
+    get [Symbol.toStringTag](): string;
+    constructor(urls: string[], params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
+    protected startJob(): Promise<Response>;
+}
 declare class LoadFromAssetUuidJob extends AbstractJob {
     private readonly _assetUuid;
     constructor(assetUuid: string, params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
@@ -1418,4 +1464,4 @@ declare namespace EyePop {
     function dataEndpoint(opts?: DataOptions): DataEndpoint;
 }
 
-export { type AbilityAliasEntry, AbstractJob, 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, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, 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 DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, 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 OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, SessionStatus, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadJob, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, EyePop as default, getBaseUrl, readableStreamFromString };
+export { type AbilityAliasEntry, AbstractJob, 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, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, 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 DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, 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, 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, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString };

package/dist/eyepop.index.d.ts

@@ -735,8 +735,15 @@ declare enum PredictionVersion {
 }
 declare const DEFAULT_PREDICTION_VERSION: PredictionVersion;
 interface WorkerSession extends Session {
+    /**
+     * @deprecated Pop ids are only retained for backwards compatibility.
+     * Configure transient sessions with `WorkerOptions.pop`.
+     */
     readonly popId: string;
     readonly baseUrl: string | undefined;
+    /**
+     * Transient sessions may not have a pipeline until the first source is processed.
+     */
     readonly pipelineId: string | undefined;
     authenticationHeaders(): any;
 }
@@ -1068,37 +1075,38 @@ declare class Endpoint<T extends Endpoint<T>> {
     private currentAccessToken;
 }
 
+/**
+ * @deprecated Configure transient sessions with `WorkerOptions.pop`.
+ * Support for pop id will be removed in 3.16.
+ */
 declare enum TransientPopId {
     Transient = "transient"
 }
 interface WorkerOptions extends Options {
     /**
-     * TODO: deprecated, support for pop id will be removed in 3.16
+     * @deprecated Pass `pop` for transient sessions or `sessionUuid` for persistent sessions.
+     * Support for pop id will be removed in 3.16.
      */
     popId?: string | TransientPopId | undefined;
     sessionUuid?: string | undefined;
+    sessionName?: string | undefined;
+    pipelineImage?: string | undefined;
+    pipelineVersion?: string | undefined;
+    pop?: Pop | undefined;
+    sessionReadyTimeoutSeconds?: number | undefined;
     autoStart?: boolean;
     stopJobs?: boolean;
     isLocalMode?: boolean;
 }
 
-declare enum SessionStatus {
-    UNKNOWN = "unknown",
-    PENDING = "pending",
-    RUNNING = "running",
-    STOPPED = "stopped",
-    FAILED = "failed",
-    ERROR = "error",
-    PIPELINE_CREATING = "pipeline_creating",
-    PIPELINE_OK = "pipeline_ok",
-    PIPELINE_CHECKING = "pipeline_checking",
-    PIPELINE_ERROR = "pipeline_error"
-}
 declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private _baseUrl;
     private _pipelineId;
     private _popName;
+    private _sessionAccessToken;
+    private _sessionAccessTokenValidUntil;
     private _pipeline;
+    private _pipelineCreatePromise;
     constructor(options: WorkerOptions);
     private options;
     disconnect(wait?: boolean): Promise<void>;
@@ -1108,6 +1116,10 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     pop(): Pop | null;
     changePop(pop: Pop): Promise<void>;
     private _authenticationHeaders;
+    /**
+     * @deprecated Pop ids are only retained for backwards compatibility.
+     * Configure transient sessions with `WorkerOptions.pop`.
+     */
     popId(): string | null;
     /**
      * V1 call to process media as a source with optional component params
@@ -1128,6 +1140,9 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     process({ source, componentParams, motionDetect, roi }: ProcessRequest): Promise<ResultStream>;
     private processV1;
     private processV2;
+    uploadGroup(paths: string[], params?: ProcessParams): Promise<ResultStream>;
+    uploadStreamGroup(streams: Array<ReadableStream<Uint8Array> | Blob | BufferSource>, mimeTypes?: string[], params?: ProcessParams): Promise<ResultStream>;
+    loadFromGroup(urls: string[], params?: ProcessParams): Promise<ResultStream>;
     private uploadFile;
     private uploadStream;
     private uploadPath;
@@ -1138,13 +1153,16 @@ declare class WorkerEndpoint extends Endpoint<WorkerEndpoint> {
     private jobStatus;
     protected reconnect(): Promise<WorkerEndpoint>;
     private startWebApiSessionWithPopId;
-    private static SESSION_DEAD;
     private static WAIT_FOR_IS_READY;
-    private static CHECK_FOR_IS_READY_INTERVAL;
+    private sessionReadyTimeoutMs;
     private getComputeSession;
-    private getOnDemandComputeSession;
-    private getPermanentComputeSession;
     private startTransientPipeline;
+    private ensureTransientPipelineStarted;
+    private changeTransientPop;
+    private deleteTransientPipeline;
+    protected authorizationHeader(): Promise<string>;
+    private computeAuthorizationHeader;
+    private setTransientPipelinePop;
 }
 
 interface DataOptions extends Options {
@@ -1307,6 +1325,18 @@ declare class EyepopLineDecoder {
     flush(): string[];
 }
 declare function readableStreamFromString(s: string): ReadableStream<Uint8Array>;
+type MultipartContent = ReadableStream<Uint8Array> | Blob | BufferSource | string;
+interface MultipartPart {
+    name: string;
+    contentType?: string | null;
+    content: MultipartContent;
+}
+declare function randomMultipartBoundary(): string;
+/**
+ * Streams a multipart/form-data body part by part, piping each part's bytes through as they
+ * become available instead of buffering any part's full content in memory first.
+ */
+declare function encodeMultipartFormData(parts: MultipartPart[], boundary: string): ReadableStream<Uint8Array>;
 
 declare class AbstractJob implements ResultStream {
     protected _getSession: () => Promise<WorkerSession>;
@@ -1341,6 +1371,22 @@ declare class LoadFromJob extends AbstractJob {
     get [Symbol.toStringTag](): string;
     protected startJob(): Promise<Response>;
 }
+interface UploadSource {
+    readonly stream: ReadableStream<Uint8Array> | Blob | BufferSource;
+    readonly mimeType: string | null;
+}
+declare class UploadGroupJob extends AbstractJob {
+    private readonly _sources;
+    get [Symbol.toStringTag](): string;
+    constructor(sources: UploadSource[], params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
+    protected startJob(): Promise<Response>;
+}
+declare class LoadFromGroupJob extends AbstractJob {
+    private readonly _urls;
+    get [Symbol.toStringTag](): string;
+    constructor(urls: string[], params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
+    protected startJob(): Promise<Response>;
+}
 declare class LoadFromAssetUuidJob extends AbstractJob {
     private readonly _assetUuid;
     constructor(assetUuid: string, params: ProcessParams, getSession: () => Promise<WorkerSession>, client: HttpClient, requestLogger: Logger);
@@ -1418,4 +1464,4 @@ declare namespace EyePop {
     function dataEndpoint(opts?: DataOptions): DataEndpoint;
 }
 
-export { type AbilityAliasEntry, AbstractJob, 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, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, 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 DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, EyepopLineDecoder, type FileSource, type ForwardComponent, ForwardOperatorType, type HttpClient, type InferRequest, type InferRunInfo, type InferRuntimeConfig, type InferenceComponent, InferenceType, type ListWorkFlowItem, type ListWorkFlowItemMetadata, type ListWorkflowItemMetadataLabels, LoadFromAssetUuidJob, LoadFromJob, LoadMediaStreamJob, type LocalAuth, 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 OAuth2Auth, type OnChangeEvent, type Options, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, SessionStatus, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadJob, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, EyePop as default, getBaseUrl, readableStreamFromString };
+export { type AbilityAliasEntry, AbstractJob, 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, type ChangeEvent, ChangeType, type ClassificationTask, type ComponentFinderComponent, type ComponentParams, 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 DownloadResponse, Endpoint, EndpointState, type EvaluateConfig, type EvaluateFilter, type EvaluateRequest, type EvaluateResponse, type EvaluateRunInfo, EvaluationStatus, ExportedBy, EyePop, 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, 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, type PathSource, type PlatformSupport, type Point2d, type Point3d, type Pop, type PopComponent, PopComponentType, type PopCrop, type PopForward, type PopForwardOperator, type PredictedClass, type PredictedEmbedding, type PredictedKeyPoint, type PredictedKeyPoints, type PredictedMesh, type PredictedMotion, type PredictedObject, type PredictedText, type Prediction, PredictionVersion, type ProcessParams, type ProcessRequest, type QcAiHubExportParams, type RectangleArea, type ResultStream, type Roi, Semaphore, type Session, type SessionAuth, type Source, Stream, type StreamEvent, type StreamSource, type StreamTime, TaskMode, TaskType, type TimeSpan, type TrackingComponent, TranscodeMode, type TransformInto, TransientPopId, UploadGroupJob, UploadJob, type UploadSource, type UrlSource, UserReview, VideoMode, type VlmAbility, type VlmAbilityCreate, type VlmAbilityGroup, type VlmAbilityGroupCreate, type VlmAbilityGroupUpdate, VlmAbilityStatus, type VlmAbilityUpdate, WebrtcBase, WebrtcWhep, WebrtcWhip, WorkerEndpoint, type WorkerOptions, type WorkerSession, type Workflow, WorkflowPhase, EyePop as default, encodeMultipartFormData, getBaseUrl, randomMultipartBoundary, readableStreamFromString };