@vertesia/client 1.1.1-dev.20260505.163000Z → 1.3.0-dev.20260620.061059Z

package/src/store/ObjectsApi.ts

@@ -1,52 +1,56 @@
-import { ApiTopic } from "@vertesia/api-fetch-client";
+import { ApiTopic } from '@vertesia/api-fetch-client';
 import {
-    BulkObjectCreateResult,
-    BulkObjectDeleteResult,
-    BulkObjectUpdateResult,
-    canGenerateRendition,
-    Collection,
-    ComplexSearchPayload,
-    ComputeObjectFacetPayload,
-    ContentObject,
+    type BulkObjectCreateResult,
+    type BulkObjectDeleteResult,
+    type BulkObjectUpdateResult,
+    type Collection,
+    type ComplexSearchPayload,
+    type ComputedFacetResponse,
+    type ComputeObjectFacetPayload,
+    type ContentObject,
     ContentObjectApiHeaders,
-    ContentObjectItem,
-    ContentObjectProcessingPriority,
-    ContentSource,
-    ContentObjectTextResponse,
-    CreateContentObjectPayload,
-    DeleteContentObjectResult,
-    Embedding,
-    ObjectSearchResponse,
-    ComputedFacetResponse,
-    ExportPropertiesPayload,
-    ExportPropertiesResponse,
-    FindPayload,
-    GetFileUrlPayload,
-    GetFileUrlResponse,
-    GetRenditionParams,
-    GetRenditionResponse,
-
-    GetUploadUrlPayload,
-    ListWorkflowRunsResponse,
-    ObjectSearchPayload,
-    ObjectSearchQuery,
-    SetObjectEmbeddingsResponse,
-    SupportedEmbeddingTypes,
-} from "@vertesia/common";
-
+    type ContentObjectItem,
+    type ContentObjectProcessingPriority,
+    type ContentObjectTextResponse,
+    type ContentSource,
+    type CreateContentObjectPayload,
+    canGenerateRendition,
+    type DeleteContentObjectResult,
+    type Embedding,
+    type ExportPropertiesPayload,
+    type ExportPropertiesResponse,
+    type FindPayload,
+    type GetFileUrlPayload,
+    type GetFileUrlResponse,
+    type GetRenditionParams,
+    type GetRenditionResponse,
+    type GetUploadUrlPayload,
+    type ListWorkflowRunsResponse,
+    type ObjectSearchPayload,
+    type ObjectSearchQuery,
+    type ObjectSearchResponse,
+    type SetObjectEmbeddingsResponse,
+    type SupportedEmbeddingTypes,
+} from '@vertesia/common';
+
+export { getSupportedRenditionFormats, supportsVisualRendition } from '@vertesia/common';
 // Re-export rendition utilities for consumers
 export { canGenerateRendition };
-export { getSupportedRenditionFormats, supportsVisualRendition } from "@vertesia/common";
 
-import { StreamSource } from "../StreamSource.js";
-import { AnalyzeDocApi } from "./AnalyzeDocApi.js";
-import { ZenoClient } from "./client.js";
+import { StreamSource } from '../StreamSource.js';
+import { AnalyzeDocApi } from './AnalyzeDocApi.js';
+import type { ZenoClient } from './client.js';
+import { fetchSignedUrl } from './signed-url.js';
+
+type ContentObjectWritePayload = Omit<CreateContentObjectPayload, 'content'> & {
+    content?: ContentSource | File | StreamSource;
+};
 
 export class ObjectsApi extends ApiTopic {
     declare client: ZenoClient;
 
     constructor(parent: ZenoClient) {
-        super(parent, "/api/v1/objects");
+        super(parent, '/api/v1/objects');
     }
 
     analyze(objectId: string) {
@@ -54,19 +58,19 @@ export class ObjectsApi extends ApiTopic {
     }
 
     getUploadUrl(payload: GetUploadUrlPayload): Promise<GetFileUrlResponse> {
-        return this.post("/upload-url", {
+        return this.post('/upload-url', {
             payload,
         });
     }
 
-    getDownloadUrl(fileUri: string, name?: string, disposition?: "inline" | "attachment"): Promise<{ url: string }> {
-        return this.post("/download-url", {
+    getDownloadUrl(fileUri: string, name?: string, disposition?: 'inline' | 'attachment'): Promise<{ url: string }> {
+        return this.post('/download-url', {
             payload: { file: fileUri, name, disposition } satisfies GetFileUrlPayload,
         });
     }
 
     getDownloadUrlWithOptions(payload: GetFileUrlPayload): Promise<{ url: string }> {
-        return this.post("/download-url", { payload });
+        return this.post('/download-url', { payload });
     }
 
     getContentSource(objectId: string): Promise<ContentSource> {
@@ -79,14 +83,12 @@ export class ObjectsApi extends ApiTopic {
      * @param payload Search/filter parameters
      * @returns Matching content objects
      */
-    list<T = any>(
-        payload: ObjectSearchPayload = {},
-    ): Promise<ContentObjectItem<T>[]> {
+    list<T = unknown>(payload: ObjectSearchPayload = {}): Promise<ContentObjectItem<T>[]> {
         const limit = payload.limit || 100;
         const offset = payload.offset || 0;
         const query = payload.query || ({} as ObjectSearchQuery);
 
-        return this.get("/", {
+        return this.get('/', {
             query: {
                 limit,
                 offset,
@@ -98,35 +100,33 @@ export class ObjectsApi extends ApiTopic {
         });
     }
 
-    computeFacets(
-        query: ComputeObjectFacetPayload,
-    ): Promise<ComputedFacetResponse> {
-        return this.post("/facets", {
+    computeFacets(query: ComputeObjectFacetPayload): Promise<ComputedFacetResponse> {
+        return this.post('/facets', {
             payload: query,
         });
     }
 
-    listFolders(_path: string = "/") {
-        throw new Error("Not implemented yet");
+    listFolders(_path: string = '/') {
+        throw new Error('Not implemented yet');
     }
 
     /** Find object based on query */
     find(payload: FindPayload): Promise<ContentObject[]> {
-        return this.post("/find", {
+        return this.post('/find', {
             payload,
         });
     }
 
     /** Count number of objects matching this query */
     count(payload: FindPayload): Promise<{ count: number }> {
-        return this.post("/count", {
+        return this.post('/count', {
             payload,
         });
     }
 
     /** Search object — different from find because allow full text search */
     search(payload: ComplexSearchPayload): Promise<ObjectSearchResponse> {
-        return this.post("/search", {
+        return this.post('/search', {
             payload,
         });
     }
@@ -154,48 +154,24 @@ export class ObjectsApi extends ApiTopic {
         const sourceMimeType = source.type || mime_type;
 
         // upload the file content to the signed URL
-        /*const res = await this.fetch(url, {
+        const res = await fetchSignedUrl(url, {
             method: 'PUT',
-            //@ts-ignore: duplex is not in the types. See https://github.com/node-fetch/node-fetch/issues/1769
-            duplex: isStream ? "half" : undefined,
-            body: isStream ? source.stream : source,
-            headers: {
-                'Content-Type': mime_type || 'application/octet-stream'
-            }
-        }).then((res: Response) => {
-            if (res.ok) {
-                return res;
-            } else {
-                console.log(res);
-                throw new Error(`Failed to upload file: ${res.statusText}`);
-            }
-        });*/
-
-        const res = await fetch(url, {
-            method: "PUT",
             body: isStream ? source.stream : source,
-            //@ts-expect-error: duplex is not in the types. See https://github.com/node-fetch/node-fetch/issues/1769
-            duplex: isStream ? "half" : undefined,
-            headers: sourceMimeType ? { "Content-Type": sourceMimeType } : undefined,
-        })
-            .then((res: Response) => {
-                if (res.ok) {
-                    return res;
-                } else {
-                    console.log(res);
-                    throw new Error(`Failed to upload file: ${res.statusText}`);
-                }
-            })
-            .catch((err) => {
-                console.error("Failed to upload file", err);
-                throw err;
-            });
+            headers: sourceMimeType ? { 'Content-Type': sourceMimeType } : undefined,
+        }).catch((err) => {
+            console.error('Failed to upload file', err);
+            throw err;
+        });
+        if (!res.ok) {
+            console.error('Failed to upload file', { status: res.status, statusText: res.statusText, url });
+            throw new Error(`Failed to upload file: ${res.statusText}`);
+        }
 
         //Etag need to be unquoted
         //When a server returns an ETag header, it includes the quotes around the actual hash value.
         //This is part of the HTTP specification (RFC 7232), which states that ETags should be
         //enclosed in double quotes.
-        const etag = res.headers.get("etag")?.replace(/^"(.*)"$/, "$1");
+        const etag = res.headers.get('etag')?.replace(/^"(.*)"$/, '$1');
 
         return {
             source: id,
@@ -206,20 +182,20 @@ export class ObjectsApi extends ApiTopic {
     }
 
     async create(
-        payload: CreateContentObjectPayload,
+        payload: ContentObjectWritePayload,
         options?: {
             collection_id?: string;
             processing_priority?: ContentObjectProcessingPriority;
         },
     ): Promise<ContentObject> {
+        const { content, ...payloadWithoutContent } = payload;
         const createPayload: CreateContentObjectPayload = {
-            ...payload,
+            ...payloadWithoutContent,
         };
-        if (
-            payload.content instanceof StreamSource ||
-            payload.content instanceof File
-        ) {
-            createPayload.content = await this.upload(payload.content);
+        if (content instanceof StreamSource || content instanceof File) {
+            createPayload.content = await this.upload(content);
+        } else {
+            createPayload.content = content;
         }
 
         const headers: Record<string, string> = {};
@@ -230,7 +206,7 @@ export class ObjectsApi extends ApiTopic {
             headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
         }
 
-        return await this.post("/", {
+        return await this.post('/', {
             payload: createPayload,
             headers: headers,
         });
@@ -253,9 +229,7 @@ export class ObjectsApi extends ApiTopic {
             processing_priority?: ContentObjectProcessingPriority;
         },
     ): Promise<ContentObject> {
-        const metadata = await this.client.files.getMetadata(
-            uri,
-        );
+        const metadata = await this.client.files.getMetadata(uri);
         const createPayload: CreateContentObjectPayload = {
             ...payload,
             content: {
@@ -274,7 +248,7 @@ export class ObjectsApi extends ApiTopic {
             headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
         }
 
-        return await this.post("/", {
+        return await this.post('/', {
             payload: createPayload,
             headers: headers,
         });
@@ -294,7 +268,7 @@ export class ObjectsApi extends ApiTopic {
      */
     async update(
         id: string,
-        payload: Partial<CreateContentObjectPayload>,
+        payload: Partial<ContentObjectWritePayload>,
         options?: {
             createRevision?: boolean;
             revisionLabel?: string;
@@ -304,16 +278,16 @@ export class ObjectsApi extends ApiTopic {
             ifMatch?: string;
         },
     ): Promise<ContentObject> {
+        const { content, ...payloadWithoutContent } = payload;
         const updatePayload: Partial<CreateContentObjectPayload> = {
-            ...payload,
+            ...payloadWithoutContent,
         };
 
         // Handle file upload if content is provided as File or StreamSource
-        if (
-            payload.content instanceof StreamSource ||
-            payload.content instanceof File
-        ) {
-            updatePayload.content = await this.upload(payload.content);
+        if (content instanceof StreamSource || content instanceof File) {
+            updatePayload.content = await this.upload(content);
+        } else {
+            updatePayload.content = content;
         }
 
         const headers: Record<string, string> = {};
@@ -324,13 +298,13 @@ export class ObjectsApi extends ApiTopic {
             headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
         }
         if (options?.createRevision) {
-            headers[ContentObjectApiHeaders.CREATE_REVISION] = "true";
+            headers[ContentObjectApiHeaders.CREATE_REVISION] = 'true';
             if (options.revisionLabel) {
                 headers[ContentObjectApiHeaders.REVISION_LABEL] = options.revisionLabel;
             }
         }
         if (options?.suppressWorkflows) {
-            headers[ContentObjectApiHeaders.SUPPRESS_WORKFLOWS] = "true";
+            headers[ContentObjectApiHeaders.SUPPRESS_WORKFLOWS] = 'true';
         }
 
         return this.put(`/${id}`, {
@@ -366,13 +340,13 @@ export class ObjectsApi extends ApiTopic {
             return this.client.runOperation({
                 name: 'delete',
                 ids: idOrIds,
-                params: {}
+                params: {},
             }) as Promise<BulkObjectDeleteResult>;
         }
         return this.del(`/${idOrIds}`);
     }
 
-    bulkUpdate(updates: Record<string, Record<string, any>>): Promise<BulkObjectUpdateResult> {
+    bulkUpdate(updates: Record<string, Record<string, unknown>>): Promise<BulkObjectUpdateResult> {
         const ids = Object.keys(updates);
         return this.client.runOperation({
             name: 'update',
@@ -381,10 +355,14 @@ export class ObjectsApi extends ApiTopic {
         }) as Promise<BulkObjectUpdateResult>;
     }
 
-    bulkCreate(objects: CreateContentObjectPayload[], options?: {
-        collection_id?: string;
-        skip_workflows?: boolean;
-    }): Promise<BulkObjectCreateResult> {
+    bulkCreate(
+        objects: CreateContentObjectPayload[],
+        options?: {
+            collection_id?: string;
+            skip_workflows?: boolean;
+            processing_priority?: ContentObjectProcessingPriority;
+        },
+    ): Promise<BulkObjectCreateResult> {
         return this.client.runOperation({
             name: 'create',
             ids: [],
@@ -400,10 +378,7 @@ export class ObjectsApi extends ApiTopic {
         return this.get(`/${documentId}/renditions`);
     }
 
-    getRendition(
-        documentId: string,
-        options: GetRenditionParams,
-    ): Promise<GetRenditionResponse> {
+    getRendition(documentId: string, options: GetRenditionParams): Promise<GetRenditionResponse> {
         const query = {
             max_hw: options.max_hw,
             generate_if_missing: options.generate_if_missing,
@@ -445,19 +420,13 @@ export class ObjectsApi extends ApiTopic {
         return this.getRendition(documentId, options);
     }
 
-    exportProperties(
-        payload: ExportPropertiesPayload,
-    ): Promise<ExportPropertiesResponse> {
-        return this.post("/export", {
+    exportProperties(payload: ExportPropertiesPayload): Promise<ExportPropertiesResponse> {
+        return this.post('/export', {
             payload,
         });
     }
 
-    setEmbedding(
-        id: string,
-        type: SupportedEmbeddingTypes,
-        payload: Embedding,
-    ): Promise<SetObjectEmbeddingsResponse> {
+    setEmbedding(id: string, type: SupportedEmbeddingTypes, payload: Embedding): Promise<SetObjectEmbeddingsResponse> {
         return this.put(`/${id}/embeddings/${type}`, {
             payload,
         });

package/src/store/PendingAsksApi.ts

@@ -1,5 +1,5 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import { ListPendingAsksResponse, PendingAskData, UserChannel } from "@vertesia/common";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { ListPendingAsksResponse, PendingAskData, TaskField, UserChannel } from '@vertesia/common';
 
 /**
  * Request to register a pending ask.
@@ -17,6 +17,8 @@ export interface RegisterPendingAskRequest {
     timeoutHours?: number;
     /** User communication channels */
     userChannels: UserChannel[];
+    /** Durable task fields shown in task inbox */
+    taskFields?: TaskField[];
 }
 
 /**
@@ -61,7 +63,7 @@ export interface ResolvePendingAskResponse {
  */
 export class PendingAsksApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/pending-asks");
+        super(parent, '/api/v1/pending-asks');
     }
 
     /**
@@ -70,7 +72,7 @@ export class PendingAsksApi extends ApiTopic {
      * Stores in Redis and sends webhook if configured.
      */
     register(request: RegisterPendingAskRequest): Promise<RegisterPendingAskResponse> {
-        return this.post("/", { payload: request });
+        return this.post('/', { payload: request });
     }
 
     /**
@@ -86,7 +88,7 @@ export class PendingAsksApi extends ApiTopic {
      * List all pending asks for the current project.
      */
     list(): Promise<ListPendingAsksResponse> {
-        return this.get("/");
+        return this.get('/');
     }
 
     /**

package/src/store/ProcessApi.ts

@@ -0,0 +1,61 @@
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
+    CreateProcessDefinitionPayload,
+    ProcessDefinition,
+    PublishProcessDefinitionPayload,
+    RevertProcessDefinitionPayload,
+    UpdateProcessDefinitionPayload,
+} from '@vertesia/common';
+
+export interface ListProcessDefinitionsQuery {
+    status?: string;
+    process?: string;
+    limit?: number;
+    offset?: number;
+    /** Include every revision/version instead of only the latest head revision. */
+    allVersions?: boolean;
+}
+
+export class ProcessApi extends ApiTopic {
+    constructor(parent: ClientBase) {
+        super(parent, '/api/v1/processes');
+    }
+
+    list(query?: ListProcessDefinitionsQuery): Promise<ProcessDefinition[]> {
+        const params: Record<string, string> = {};
+        if (query?.status) params.status = query.status;
+        if (query?.process) params.process = query.process;
+        if (query?.limit != null) params.limit = String(query.limit);
+        if (query?.offset != null) params.offset = String(query.offset);
+        if (query?.allVersions) params.all_versions = 'true';
+        return this.get('/', { query: params });
+    }
+
+    retrieve(id: string): Promise<ProcessDefinition> {
+        return this.get(`/${id}`);
+    }
+
+    create(payload: CreateProcessDefinitionPayload): Promise<ProcessDefinition> {
+        return this.post('/', { payload });
+    }
+
+    update(id: string, payload: UpdateProcessDefinitionPayload): Promise<ProcessDefinition> {
+        return this.put(`/${id}`, { payload });
+    }
+
+    listVersions(id: string): Promise<ProcessDefinition[]> {
+        return this.get(`/${id}/versions`);
+    }
+
+    publish(id: string, payload: PublishProcessDefinitionPayload): Promise<ProcessDefinition> {
+        return this.post(`/${id}/publish`, { payload });
+    }
+
+    revert(id: string, payload: RevertProcessDefinitionPayload): Promise<ProcessDefinition> {
+        return this.post(`/${id}/revert`, { payload });
+    }
+
+    delete(id: string): Promise<{ id: string; count: number }> {
+        return this.del(`/${id}`);
+    }
+}

package/src/store/QueryApi.ts

@@ -1,4 +1,4 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 
 /**
  * Query payload for agent data access
@@ -47,8 +47,7 @@ export interface QueryResult {
  * All queries are automatically filtered based on the authenticated user's permissions.
  */
 export class QueryApi extends ApiTopic {
-
-    constructor(parent: ClientBase, basePath: string = "/api/v1/query") {
+    constructor(parent: ClientBase, basePath: string = '/api/v1/query') {
         super(parent, basePath);
     }
 
@@ -84,7 +83,7 @@ export class QueryApi extends ApiTopic {
      * ```
      */
     async execute(payload: QueryPayload): Promise<QueryResult> {
-        return this.post("/", { payload });
+        return this.post('/', { payload });
     }
 
     /**

package/src/store/RenderingApi.ts

@@ -1,13 +1,13 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import {
     isWorkflowTerminalStatus,
-    RenderMarkdownPollOptions,
-    RenderMarkdownPayload,
-    RenderMarkdownStartResponse,
-    RenderMarkdownStatusResponse,
-    RenderMarkdownResponse,
+    type RenderMarkdownPayload,
+    type RenderMarkdownPollOptions,
+    type RenderMarkdownResponse,
+    type RenderMarkdownStartResponse,
+    type RenderMarkdownStatusResponse,
     WorkflowExecutionStatus,
-} from "@vertesia/common";
+} from '@vertesia/common';
 
 /**
  * API for rendering markdown documents to PDF or DOCX.
@@ -15,7 +15,7 @@ import {
  */
 export class RenderingApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/rendering");
+        super(parent, '/api/v1/rendering');
     }
 
     /**
@@ -41,14 +41,11 @@ export class RenderingApi extends ApiTopic {
      * });
      */
     start(payload: RenderMarkdownPayload): Promise<RenderMarkdownStartResponse> {
-        return this.post("/jobs", { payload });
+        return this.post('/jobs', { payload });
     }
 
-    getStatus(
-        workflowId: string,
-        workflowRunId: string,
-    ): Promise<RenderMarkdownStatusResponse> {
-        return this.get("/jobs/status", {
+    getStatus(workflowId: string, workflowRunId: string): Promise<RenderMarkdownStatusResponse> {
+        return this.get('/jobs/status', {
             query: {
                 workflow_id: workflowId,
                 workflow_run_id: workflowRunId,
@@ -65,7 +62,7 @@ export class RenderingApi extends ApiTopic {
 
         const started = await this.start(payload);
         if (!started.workflow_id || !started.workflow_run_id) {
-            throw new Error("Failed to start rendering workflow");
+            throw new Error('Failed to start rendering workflow');
         }
 
         const startTime = Date.now();
@@ -76,10 +73,10 @@ export class RenderingApi extends ApiTopic {
 
             if (status.status === WorkflowExecutionStatus.COMPLETED) {
                 if (!status.download_url && !status.file_uri) {
-                    throw new Error(status.error || "Rendering completed but no output file was produced");
+                    throw new Error(status.error || 'Rendering completed but no output file was produced');
                 }
                 return {
-                    status: "success",
+                    status: 'success',
                     format: payload.format,
                     download_url: status.download_url,
                     file_uri: status.file_uri,

package/src/store/SchedulesApi.ts

@@ -1,11 +1,11 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import {
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     AgentSchedule,
     AgentScheduleWithTemporalInfo,
     CreateSchedulePayload,
     ScheduleListItem,
     UpdateSchedulePayload,
-} from "@vertesia/common";
+} from '@vertesia/common';
 
 /**
  * Client API for managing agent schedules.
@@ -14,14 +14,14 @@ import {
  */
 export class SchedulesApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/schedules");
+        super(parent, '/api/v1/schedules');
     }
 
     /**
      * List all schedules in the project.
      */
     list(): Promise<ScheduleListItem[]> {
-        return this.get("/");
+        return this.get('/');
     }
 
     /**
@@ -50,7 +50,7 @@ export class SchedulesApi extends ApiTopic {
      * ```
      */
     create(payload: CreateSchedulePayload): Promise<AgentSchedule> {
-        return this.post("/", { payload });
+        return this.post('/', { payload });
     }
 
     /**