@vertesia/client 1.0.0-dev.20260203.130115Z → 1.0.0-dev.20260227.104700Z

package/lib/esm/store/ObjectsApi.js

@@ -0,0 +1,311 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+import { canGenerateRendition, ContentObjectApiHeaders, getSupportedRenditionFormats, supportsVisualRendition } from "@vertesia/common";
+// Re-export rendition utilities for consumers
+export { canGenerateRendition, getSupportedRenditionFormats, supportsVisualRendition };
+import { StreamSource } from "../StreamSource.js";
+import { AnalyzeDocApi } from "./AnalyzeDocApi.js";
+export class ObjectsApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/objects");
+    }
+    analyze(objectId) {
+        return new AnalyzeDocApi(this, objectId);
+    }
+    getUploadUrl(payload) {
+        return this.post("/upload-url", {
+            payload,
+        });
+    }
+    getDownloadUrl(fileUri, name, disposition) {
+        return this.post("/download-url", {
+            payload: { file: fileUri, name, disposition },
+        });
+    }
+    getDownloadUrlWithOptions(payload) {
+        return this.post("/download-url", { payload });
+    }
+    getContentSource(objectId) {
+        return this.get(`/${objectId}/content-source`);
+    }
+    /**
+     * List objects with revision filtering options
+     *
+     * @param payload Search/filter parameters
+     * @returns Matching content objects
+     */
+    list(payload = {}) {
+        const limit = payload.limit || 100;
+        const offset = payload.offset || 0;
+        const query = payload.query || {};
+        return this.get("/", {
+            query: {
+                limit,
+                offset,
+                ...query,
+                all_revisions: payload.all_revisions,
+                from_root: payload.from_root || undefined,
+            },
+        });
+    }
+    computeFacets(query) {
+        return this.post("/facets", {
+            payload: query,
+        });
+    }
+    listFolders(path = "/") {
+        path; //TODO
+    }
+    /** Find object based on query */
+    find(payload) {
+        return this.post("/find", {
+            payload,
+        });
+    }
+    /** Count number of objects matching this query */
+    count(payload) {
+        return this.post("/count", {
+            payload,
+        });
+    }
+    /** Search object — different from find because allow full text search */
+    search(payload) {
+        return this.post("/search", {
+            payload,
+        });
+    }
+    retrieve(id, select) {
+        return this.get(`/${id}`, {
+            query: {
+                select,
+            },
+        });
+    }
+    getObjectText(id) {
+        return this.get(`/${id}/text`);
+    }
+    async upload(source) {
+        const isStream = source instanceof StreamSource;
+        // get a signed URL to upload the file a computed mimeType and the file object id.
+        const { url, id, mime_type } = await this.getUploadUrl({
+            id: isStream ? source.id : undefined,
+            name: source.name,
+            mime_type: source.type,
+        });
+        const sourceMimeType = source.type || mime_type;
+        // upload the file content to the signed URL
+        /*const res = await this.fetch(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-ignore: 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) => {
+            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;
+        });
+        //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");
+        return {
+            source: id,
+            name: source.name,
+            type: sourceMimeType,
+            etag,
+        };
+    }
+    async create(payload, options) {
+        const createPayload = {
+            ...payload,
+        };
+        if (payload.content instanceof StreamSource ||
+            payload.content instanceof File) {
+            createPayload.content = await this.upload(payload.content);
+        }
+        const headers = {};
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        }
+        if (options?.collection_id) {
+            headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
+        }
+        return await this.post("/", {
+            payload: createPayload,
+            headers: headers,
+        });
+    }
+    /**
+     * Create an object which holds a reference to an external blob (i.e. not in the project bucket)
+     * The uri should starts either with gs:// or s3://. Not other protocols are supported yet.
+     * For the s3 blobs you must use a hash with the blob #region. Ex: s3://bucket/path/to/file#us-east-1
+     * @param uri
+     * @param payload
+     * @param options
+     * @returns
+     */
+    async createFromExternalSource(uri, payload = {}, options) {
+        const metadata = await this.client.files.getMetadata(uri);
+        const createPayload = {
+            ...payload,
+            content: {
+                source: uri,
+                name: metadata.name,
+                type: metadata.contentType,
+                etag: metadata.etag,
+            },
+        };
+        const headers = {};
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        }
+        if (options?.collection_id) {
+            headers[ContentObjectApiHeaders.COLLECTION_ID] = options.collection_id;
+        }
+        return await this.post("/", {
+            payload: createPayload,
+            headers: headers,
+        });
+    }
+    /**
+     * Updates an existing object or creates a new revision
+     * Handles file uploads similar to the create method
+     *
+     * @param id The ID of the object to update
+     * @param payload The changes to apply
+     * @param options Additional options
+     * @param options.createRevision Whether to create a new revision instead of updating in place
+     * @param options.revisionLabel Optional label for the revision (e.g., "v1.2")
+     * @param options.suppressWorkflows When true, prevents this update from triggering workflow rules
+     * @returns The updated object or newly created revision
+     */
+    async update(id, payload, options) {
+        const updatePayload = {
+            ...payload,
+        };
+        // 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);
+        }
+        const headers = {};
+        if (options?.ifMatch) {
+            headers['if-match'] = options.ifMatch;
+        }
+        if (options?.processing_priority) {
+            headers[ContentObjectApiHeaders.PROCESSING_PRIORITY] = options.processing_priority;
+        }
+        if (options?.createRevision) {
+            headers[ContentObjectApiHeaders.CREATE_REVISION] = "true";
+            if (options.revisionLabel) {
+                headers[ContentObjectApiHeaders.REVISION_LABEL] = options.revisionLabel;
+            }
+        }
+        if (options?.suppressWorkflows) {
+            headers[ContentObjectApiHeaders.SUPPRESS_WORKFLOWS] = "true";
+        }
+        return this.put(`/${id}`, {
+            payload: updatePayload,
+            headers,
+        });
+    }
+    /**
+     * Retrieves all revisions of a content object
+     *
+     * @param id The ID of any revision in the object's history
+     * @returns Array of all revisions sharing the same root
+     */
+    getRevisions(id) {
+        return this.get(`/${id}/revisions`);
+    }
+    /**
+     * Retrieves all collections that contain a specific object
+     *
+     * @param id The ID of the object
+     * @returns Array of collections containing this object (both static and dynamic)
+     */
+    getCollections(id) {
+        return this.get(`/${id}/collections`);
+    }
+    delete(id) {
+        return this.del(`/${id}`);
+    }
+    listWorkflowRuns(documentId) {
+        return this.get(`/${documentId}/workflow-runs`);
+    }
+    listRenditions(documentId) {
+        return this.get(`/${documentId}/renditions`);
+    }
+    getRendition(documentId, options) {
+        const query = {
+            max_hw: options.max_hw,
+            generate_if_missing: options.generate_if_missing,
+            sign_url: options.sign_url,
+            block_on_generation: options.block_on_generation,
+        };
+        return this.get(`/${documentId}/renditions/${options.format}`, {
+            query,
+        });
+    }
+    /**
+     * Get rendition with pre-validation of content type compatibility.
+     * Returns null instead of throwing if the format is not supported for the content type.
+     *
+     * @param documentId - The document ID
+     * @param contentType - The content type of the document (e.g., 'image/png', 'text/markdown')
+     * @param options - Rendition options including format
+     * @returns The rendition response, or null if format is not supported for the content type
+     *
+     * @example
+     * const rendition = await client.objects.getRenditionSafe(docId, doc.content?.type, {
+     *     format: ImageRenditionFormat.jpeg,
+     *     generate_if_missing: true
+     * });
+     * if (!rendition) {
+     *     console.log('Document does not support JPEG renditions');
+     * }
+     */
+    getRenditionSafe(documentId, contentType, options) {
+        if (!canGenerateRendition(contentType, options.format)) {
+            return Promise.resolve(null);
+        }
+        return this.getRendition(documentId, options);
+    }
+    exportProperties(payload) {
+        return this.post("/export", {
+            payload,
+        });
+    }
+    setEmbedding(id, type, payload) {
+        return this.put(`/${id}/embeddings/${type}`, {
+            payload,
+        });
+    }
+}
+//# sourceMappingURL=ObjectsApi.js.map

package/lib/esm/store/ObjectsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectsApi.js","sourceRoot":"","sources":["../../../src/store/ObjectsApi.ts"],"names":[],"mappings":"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"}

package/lib/esm/store/PendingAsksApi.js

@@ -0,0 +1,39 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * Pending Asks API for tracking ask_user requests.
+ * Handles registration, resolution, and listing of pending asks.
+ */
+export class PendingAsksApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/pending-asks");
+    }
+    /**
+     * Register a new pending ask.
+     * Called when an agent calls ask_user.
+     * Stores in Redis and sends webhook if configured.
+     */
+    register(request) {
+        return this.post("/", { payload: request });
+    }
+    /**
+     * Resolve a pending ask with the user's response.
+     * Called when a user responds to an ask.
+     * Updates Redis and sends webhook if configured.
+     */
+    resolve(askId, request) {
+        return this.post(`/${askId}/resolve`, { payload: request });
+    }
+    /**
+     * List all pending asks for the current project.
+     */
+    list() {
+        return this.get("/");
+    }
+    /**
+     * Get a specific pending ask by ID.
+     */
+    retrieve(askId) {
+        return this.get(`/${askId}`);
+    }
+}
+//# sourceMappingURL=PendingAsksApi.js.map

package/lib/esm/store/PendingAsksApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingAsksApi.js","sourceRoot":"","sources":["../../../src/store/PendingAsksApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAyDlE;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACxC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,OAAkC;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAa,EAAE,OAAiC;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;CACJ"}

package/lib/esm/store/QueryApi.js

@@ -0,0 +1,63 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * API for querying documents using SQL, ES|QL, or raw Elasticsearch DSL.
+ * All queries are automatically filtered based on the authenticated user's permissions.
+ */
+export class QueryApi extends ApiTopic {
+    constructor(parent, basePath = "/api/v1/query") {
+        super(parent, basePath);
+    }
+    /**
+     * Execute a query against the project's document index
+     *
+     * @param payload - Query payload with sql, esql, or dsl
+     * @returns Query result with columns/rows or hits/aggregations
+     *
+     * @example SQL query
+     * ```typescript
+     * const result = await client.query.execute({
+     *   sql: "SELECT name, status FROM content WHERE status = 'published' LIMIT 10"
+     * });
+     * ```
+     *
+     * @example ES|QL query
+     * ```typescript
+     * const result = await client.query.execute({
+     *   esql: "FROM content | WHERE status == 'published' | STATS count = COUNT(*) BY type.name"
+     * });
+     * ```
+     *
+     * @example DSL query with aggregations
+     * ```typescript
+     * const result = await client.query.execute({
+     *   dsl: {
+     *     query: { match: { text: "machine learning" } },
+     *     aggs: { by_type: { terms: { field: "type.name" } } },
+     *     size: 10
+     *   }
+     * });
+     * ```
+     */
+    async execute(payload) {
+        return this.post("/", { payload });
+    }
+    /**
+     * Execute a SQL query
+     */
+    async sql(query) {
+        return this.execute({ sql: query });
+    }
+    /**
+     * Execute an ES|QL query
+     */
+    async esql(query) {
+        return this.execute({ esql: query });
+    }
+    /**
+     * Execute a DSL query
+     */
+    async dsl(query) {
+        return this.execute({ dsl: query });
+    }
+}
+//# sourceMappingURL=QueryApi.js.map

package/lib/esm/store/QueryApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryApi.js","sourceRoot":"","sources":["../../../src/store/QueryApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AA4ClE;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAElC,YAAY,MAAkB,EAAE,WAAmB,eAAe;QAC9D,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,CAAC,OAAO,CAAC,OAAqB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAAa;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,KAA0B;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;CACJ"}

package/lib/esm/store/RenderingApi.js

@@ -0,0 +1,80 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+import { isWorkflowTerminalStatus, WorkflowExecutionStatus, } from "@vertesia/common";
+/**
+ * API for rendering markdown documents to PDF or DOCX.
+ * Rendering is performed on workflow workers (not on the API server).
+ */
+export class RenderingApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/rendering");
+    }
+    /**
+     * Render markdown content to PDF or DOCX.
+     *
+     * @param payload - Rendering options including format and either object_id or inline content
+     * @returns Rendering result with download URL
+     *
+     * @example
+     * // Render an existing markdown document
+     * const result = await client.rendering.render({
+     *     format: MarkdownRenditionFormat.pdf,
+     *     object_id: "doc-123"
+     * });
+     * // Download from result.download_url
+     *
+     * @example
+     * // Render inline markdown content
+     * const result = await client.rendering.render({
+     *     format: MarkdownRenditionFormat.docx,
+     *     content: "# My Report\n\nContent here...",
+     *     title: "My Report"
+     * });
+     */
+    start(payload) {
+        return this.post("/jobs", { payload });
+    }
+    getStatus(workflowId, workflowRunId) {
+        return this.get("/jobs/status", {
+            query: {
+                workflow_id: workflowId,
+                workflow_run_id: workflowRunId,
+            },
+        });
+    }
+    async render(payload, options = {}) {
+        const pollIntervalMs = options.pollIntervalMs ?? 1500;
+        const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+        const started = await this.start(payload);
+        if (!started.workflow_id || !started.workflow_run_id) {
+            throw new Error("Failed to start rendering workflow");
+        }
+        const startTime = Date.now();
+        // Poll until workflow reaches terminal state.
+        while (true) {
+            const status = await this.getStatus(started.workflow_id, started.workflow_run_id);
+            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");
+                }
+                return {
+                    status: "success",
+                    format: payload.format,
+                    download_url: status.download_url,
+                    file_uri: status.file_uri,
+                };
+            }
+            if (isWorkflowTerminalStatus(status.status)) {
+                const statusLabel = WorkflowExecutionStatus[status.status] || String(status.status);
+                throw new Error(status.error || `Rendering failed with status: ${statusLabel}`);
+            }
+            if (Date.now() - startTime >= timeoutMs) {
+                throw new Error(`Rendering timed out after ${timeoutMs}ms`);
+            }
+            await sleep(pollIntervalMs);
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=RenderingApi.js.map

package/lib/esm/store/RenderingApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderingApi.js","sourceRoot":"","sources":["../../../src/store/RenderingApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,wBAAwB,EAMxB,uBAAuB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACtC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,OAA8B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,SAAS,CACL,UAAkB,EAClB,aAAqB;QAErB,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE;YAC5B,KAAK,EAAE;gBACH,WAAW,EAAE,UAAU;gBACvB,eAAe,EAAE,aAAa;aACjC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,MAAM,CACR,OAA8B,EAC9B,UAAqC,EAAE;QAEvC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAEtD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,8CAA8C;QAC9C,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;YAElF,IAAI,MAAM,CAAC,MAAM,KAAK,uBAAuB,CAAC,SAAS,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,qDAAqD,CAAC,CAAC;gBAC3F,CAAC;gBACD,OAAO;oBACH,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC5B,CAAC;YACN,CAAC;YAED,IAAI,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,WAAW,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACpF,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,iCAAiC,WAAW,EAAE,CAAC,CAAC;YACpF,CAAC;YAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,IAAI,CAAC,CAAC;YAChE,CAAC;YAED,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;CACJ;AAED,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/lib/esm/store/SchedulesApi.js

@@ -0,0 +1,99 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * Client API for managing agent schedules.
+ *
+ * Schedules allow agents to run on a recurring basis using cron expressions.
+ */
+export class SchedulesApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/schedules");
+    }
+    /**
+     * List all schedules in the project.
+     */
+    list() {
+        return this.get("/");
+    }
+    /**
+     * Retrieve a schedule by ID.
+     * Includes Temporal execution info if available.
+     */
+    retrieve(id) {
+        return this.get(`/${id}`);
+    }
+    /**
+     * Create a new schedule.
+     *
+     * @param payload - Schedule configuration including name, interaction, and cron expression
+     * @returns The created schedule
+     *
+     * @example
+     * ```typescript
+     * const schedule = await client.schedules.create({
+     *   name: 'Weekly Report',
+     *   interaction: 'WeeklyReportAgent',
+     *   cron_expression: '0 9 * * MON', // Every Monday at 9am
+     *   timezone: 'America/New_York',
+     *   vars: { reportType: 'summary' }
+     * });
+     * ```
+     */
+    create(payload) {
+        return this.post("/", { payload });
+    }
+    /**
+     * Update an existing schedule.
+     *
+     * @param id - Schedule ID
+     * @param payload - Fields to update
+     * @returns The updated schedule
+     */
+    update(id, payload) {
+        return this.put(`/${id}`, { payload });
+    }
+    /**
+     * Delete a schedule.
+     *
+     * This also removes the corresponding Temporal schedule.
+     *
+     * @param id - Schedule ID
+     * @returns Object with the deleted schedule ID
+     */
+    delete(id) {
+        return this.del(`/${id}`);
+    }
+    /**
+     * Trigger an immediate execution of the scheduled agent.
+     *
+     * This runs the agent immediately without waiting for the next scheduled time.
+     *
+     * @param id - Schedule ID
+     * @returns Success message
+     */
+    trigger(id) {
+        return this.post(`/${id}/trigger`, {});
+    }
+    /**
+     * Pause a schedule.
+     *
+     * The schedule will not run until resumed.
+     *
+     * @param id - Schedule ID
+     * @param note - Optional note explaining why the schedule was paused
+     * @returns Success message
+     */
+    pause(id, note) {
+        return this.post(`/${id}/pause`, { payload: { note } });
+    }
+    /**
+     * Resume a paused schedule.
+     *
+     * @param id - Schedule ID
+     * @param note - Optional note explaining why the schedule was resumed
+     * @returns Success message
+     */
+    resume(id, note) {
+        return this.post(`/${id}/resume`, { payload: { note } });
+    }
+}
+//# sourceMappingURL=SchedulesApi.js.map

package/lib/esm/store/SchedulesApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulesApi.js","sourceRoot":"","sources":["../../../src/store/SchedulesApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AASlE;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACtC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,OAA8B;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAU,EAAE,OAA8B;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,EAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAU,EAAE,IAAa;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAU,EAAE,IAAa;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/lib/esm/store/ToolsApi.js

@@ -0,0 +1,17 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * API for accessing the builtin tools catalog
+ */
+export class ToolsApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/tools");
+    }
+    /**
+     * Get the builtin tools catalog
+     * @returns List of all available builtin tools with their descriptions and parameter schemas
+     */
+    getBuiltinCatalog() {
+        return this.get('/');
+    }
+}
+//# sourceMappingURL=ToolsApi.js.map

package/lib/esm/store/ToolsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsApi.js","sourceRoot":"","sources":["../../../src/store/ToolsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAGlE;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAClC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ"}