@vertesia/client 0.24.0-dev.202601221707

package/lib/types/store/EmailApi.d.ts

@@ -0,0 +1,185 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { EmailRouteData } from "@vertesia/common";
+/**
+ * Request payload for sending an email via the agent.
+ * Resend configuration is fetched from project settings.
+ * From address is constructed as: {project_namespace}+{agent_name}@{email_domain}
+ */
+export interface SendEmailRequest {
+    /** Email address to send to */
+    to_email: string;
+    /** Email subject */
+    subject: string;
+    /** Email body in markdown format */
+    body: string;
+    /** Agent/interaction endpoint name (used in from address) */
+    agent_name: string;
+    /** Display name for the sender (overrides project default) */
+    from_name?: string;
+    /** Workflow run ID for routing replies */
+    run_id: string;
+    /** Existing route key (for subsequent emails in same conversation) */
+    route_key?: string;
+    /** Message ID for In-Reply-To header (email threading) */
+    in_reply_to?: string;
+    /** Chain of message IDs for References header */
+    references?: string[];
+}
+/**
+ * Response from sending an email.
+ */
+export interface SendEmailResponse {
+    success: boolean;
+    /** Resend email ID */
+    email_id?: string;
+    /** Message-ID header for threading */
+    message_id?: string;
+    /** Short route key for reply routing */
+    route_key?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Response from creating an email route.
+ */
+export interface CreateRouteResponse {
+    /** The generated route key (8-char alphanumeric) */
+    route_key: string;
+    /** Full reply-to address: r+{route_key}@{email_domain} */
+    reply_to: string;
+    /** The email domain for sending and receiving */
+    email_domain: string;
+}
+/**
+ * Request to forward an email to a workflow.
+ * Used by external services that handle email reception themselves.
+ */
+export interface ForwardEmailRequest {
+    /** Email content received by the external service */
+    email: {
+        /** Sender email address */
+        from: string;
+        /** Email subject */
+        subject?: string;
+        /** Plain text body */
+        text: string;
+        /** HTML body (optional) */
+        html?: string;
+        /** Message-ID header for threading */
+        message_id?: string;
+    };
+    /** Custom context data from the external service (e.g., auth tokens, user IDs) */
+    context?: Record<string, unknown>;
+    /** Attachments with download URLs */
+    attachments?: Array<{
+        filename: string;
+        content_type: string;
+        size: number;
+        download_url: string;
+    }>;
+}
+/**
+ * Response from forwarding an email.
+ */
+export interface ForwardEmailResponse {
+    success: boolean;
+    run_id: string;
+    workflow_id: string;
+    route_key: string;
+}
+/**
+ * Request to create an email route.
+ */
+export interface CreateRouteRequest {
+    /** Workflow run ID for routing replies */
+    run_id: string;
+    /** Email address of the user (for context) */
+    user_email: string;
+    /** Subject of the email thread (optional) */
+    thread_subject?: string;
+}
+/**
+ * Email API for sending emails from workflows.
+ */
+export declare class EmailApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    /**
+     * Send an email from an agent/workflow.
+     * Creates a route key if not provided, sends via Resend, and returns routing info.
+     */
+    send(request: SendEmailRequest): Promise<SendEmailResponse>;
+    /**
+     * Resolve a route key to get email context.
+     * Used by webhook handler to look up workflow info from reply email.
+     * @deprecated Use getRoute() instead
+     */
+    resolveRoute(routeKey: string): Promise<EmailRouteData>;
+    /**
+     * Create a new email route without sending an email.
+     * Useful for external services that want to handle email sending themselves
+     * but need reply routing back to Vertesia workflows.
+     *
+     * @example
+     * ```ts
+     * const { route_key, reply_to } = await client.store.email.createRoute({
+     *     run_id: workflowRunId,
+     *     user_email: "user@example.com",
+     *     thread_subject: "Contract Review"
+     * });
+     * // Use reply_to as the Reply-To header when sending your own email
+     * // Replies will be routed back to the workflow
+     * ```
+     */
+    createRoute(request: CreateRouteRequest): Promise<CreateRouteResponse>;
+    /**
+     * Get an email route by key.
+     */
+    getRoute(routeKey: string): Promise<EmailRouteData & {
+        route_key: string;
+    }>;
+    /**
+     * Update an email route (e.g., to update threading info).
+     */
+    updateRoute(routeKey: string, updates: Partial<EmailRouteData>): Promise<{
+        success: boolean;
+        route_key: string;
+    }>;
+    /**
+     * Forward an email to a workflow via route key.
+     *
+     * Use this when your service receives an email reply and needs to forward
+     * it to the Vertesia workflow. You can add custom context data (like auth
+     * tokens or user IDs) that will be merged into `payload.vars.data`.
+     *
+     * **Important**: Use camelCase keys in context to match the agent start
+     * pattern. This ensures tools work identically whether the agent was
+     * started directly or received an email reply.
+     *
+     * @example
+     * ```ts
+     * // In your email webhook handler:
+     * const result = await client.store.email.forwardEmail(routeKey, {
+     *     email: {
+     *         from: inboundEmail.from,
+     *         subject: inboundEmail.subject,
+     *         text: inboundEmail.text,
+     *         message_id: inboundEmail.messageId,
+     *     },
+     *     context: {
+     *         // Use camelCase - merged into payload.vars.data
+     *         apiKey: generateServiceToken(),
+     *         tenantId: resolvedUser.tenantId,
+     *         userId: resolvedUser.id,
+     *         userEmail: resolvedUser.email,
+     *     },
+     *     attachments: inboundEmail.attachments?.map(att => ({
+     *         filename: att.filename,
+     *         content_type: att.contentType,
+     *         size: att.size,
+     *         download_url: att.url,
+     *     })),
+     * });
+     * ```
+     */
+    forwardEmail(routeKey: string, request: ForwardEmailRequest): Promise<ForwardEmailResponse>;
+}

package/lib/types/store/EmailApi.d.ts.map

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

package/lib/types/store/EmbeddingsApi.d.ts

@@ -0,0 +1,12 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { EmbeddingsStatusResponse, GenericCommandResponse, ProjectConfigurationEmbeddings, SupportedEmbeddingTypes } from "@vertesia/common";
+/**
+ * @since 0.52.0
+ */
+export declare class EmbeddingsApi extends ApiTopic {
+    constructor(parent: ClientBase, basePath?: string);
+    status(type: SupportedEmbeddingTypes): Promise<EmbeddingsStatusResponse>;
+    activate(type: SupportedEmbeddingTypes, config: Partial<ProjectConfigurationEmbeddings>): Promise<GenericCommandResponse>;
+    disable(type: SupportedEmbeddingTypes): Promise<GenericCommandResponse>;
+    recalculate(type: SupportedEmbeddingTypes): Promise<GenericCommandResponse>;
+}

package/lib/types/store/EmbeddingsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingsApi.d.ts","sourceRoot":"","sources":["../../../src/store/EmbeddingsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,wBAAwB,EACxB,sBAAsB,EACtB,8BAA8B,EAC9B,uBAAuB,EAC1B,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;gBAE3B,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,MAA6B;IAIjE,MAAM,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIxE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IASzH,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIvE,WAAW,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAIpF"}

package/lib/types/store/FilesApi.d.ts

@@ -0,0 +1,110 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { GetFileUrlPayload, GetFileUrlResponse, GetUploadUrlPayload } from "@vertesia/common";
+import { StreamSource } from "../StreamSource.js";
+export declare const MEMORIES_PREFIX = "memories";
+export declare const ARTIFACTS_PREFIX = "agents";
+export declare function getMemoryFilePath(name: string): string;
+/**
+ * Build the storage path for an agent artifact
+ * @param runId - The workflow run ID
+ * @param name - The artifact filename
+ */
+export declare function getAgentArtifactPath(runId: string, name: string): string;
+export declare class FilesApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    deleteFile(path: string, prefix?: boolean): Promise<void | number>;
+    /**
+     * get the metadata of a blob given its URI. Supported URI are:
+     * starting with s3:// and gs://.
+     * For s3 blobs use #region to specify the region. Ex: s3://bucket/key#us-west-2
+     * @param uri
+     * @returns
+     */
+    getMetadata(uri: string): Promise<{
+        name: string;
+        size: number;
+        contentType: string;
+        contentDisposition?: string;
+        etag?: string;
+        customMetadata?: Record<string, string>;
+    }>;
+    /**
+     * Set custom metadata on a file
+     * @param file - The file path or URI
+     * @param metadata - Custom metadata key-value pairs
+     * @returns Success status
+     */
+    setFileMetadata(file: string, metadata: Record<string, string>): Promise<{
+        success: boolean;
+        file: string;
+    }>;
+    /**
+     * Get or create a bucket for the project. If the bucket already exists, it does nothing.
+     * The bucket URI is returned.
+     * @returns
+     */
+    getOrCreateBucket(): Promise<{
+        bucket: string;
+    }>;
+    getUploadUrl(payload: GetUploadUrlPayload): Promise<GetFileUrlResponse>;
+    getDownloadUrl(file: string, name?: string, disposition?: "inline" | "attachment"): Promise<GetFileUrlResponse>;
+    getDownloadUrlWithOptions(payload: GetFileUrlPayload): Promise<GetFileUrlResponse>;
+    /**
+     * Upload content to a file and return the full path (including bucket name) of the uploaded file
+     * @param source
+     * @returns
+     */
+    uploadFile(source: StreamSource | File): Promise<string>;
+    /**
+     *
+     * @param location can be a relative path in the project, a reference to a cloud storage, or a accessible HTTPS URL (typically signed URL)
+     * @returns ReadableStream
+     */
+    downloadFile(location: string): Promise<ReadableStream<Uint8Array<ArrayBuffer>>>;
+    /**
+     * Copy a file to a new destination within the same bucket.
+     * @param source - Source file path (relative to project bucket)
+     * @param dest - Destination file path (relative to project bucket)
+     * @returns The destination file URI
+     */
+    copyFile(source: string, dest: string): Promise<string>;
+    uploadMemoryPack(source: StreamSource | File): Promise<string>;
+    downloadMemoryPack(name: string, gunzip?: boolean): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * List files by prefix
+     * @param prefix - Path prefix to filter files
+     * @returns Array of file paths matching the prefix
+     */
+    listByPrefix(prefix: string): Promise<{
+        files: string[];
+    }>;
+    /**
+     * Upload an artifact for an agent run
+     * @param runId - The workflow run ID
+     * @param name - Artifact name (e.g., "output.json")
+     * @param source - File content source
+     * @returns The full path of the uploaded artifact
+     */
+    uploadArtifact(runId: string, name: string, source: StreamSource | File): Promise<string>;
+    /**
+     * Download an artifact from an agent run
+     * @param runId - The workflow run ID
+     * @param name - Artifact name
+     * @returns ReadableStream of the artifact content
+     */
+    downloadArtifact(runId: string, name: string): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Get download URL for an artifact
+     * @param runId - The workflow run ID
+     * @param name - Artifact name
+     * @param disposition - Content disposition (inline or attachment)
+     * @returns Signed URL response
+     */
+    getArtifactDownloadUrl(runId: string, name: string, disposition?: "inline" | "attachment"): Promise<GetFileUrlResponse>;
+    /**
+     * List artifacts for an agent run
+     * @param runId - The workflow run ID
+     * @returns Array of artifact file paths
+     */
+    listArtifacts(runId: string): Promise<string[]>;
+}

package/lib/types/store/FilesApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilesApi.d.ts","sourceRoot":"","sources":["../../../src/store/FilesApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EAEtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,eAAe,aAAa,CAAC;AAC1C,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,UAG7C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,MAAM,EAAE,UAAU;IAIxB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IAKxE;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3C,CAAC;IAQF;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAK5G;;;;OAIG;IACH,iBAAiB,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhD,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOvE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAK/G,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIlF;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B9D;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAsCtF;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOvD,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB9D,kBAAkB,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,GACxB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAWtC;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI1D;;;;;;OAMG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAc/F;;;;;OAKG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAKxF;;;;;;OAMG;IACH,sBAAsB,CAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,QAAQ,GAAG,YAAY,GACtC,OAAO,CAAC,kBAAkB,CAAC;IAK9B;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAKxD"}

package/lib/types/store/ObjectsApi.d.ts

@@ -0,0 +1,139 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { canGenerateRendition, ComplexSearchPayload, ComputeObjectFacetPayload, ContentObject, ContentObjectItem, ContentObjectProcessingPriority, ContentSource, CreateContentObjectPayload, Embedding, ExportPropertiesPayload, ExportPropertiesResponse, FindPayload, GetFileUrlPayload, GetFileUrlResponse, GetRenditionParams, GetRenditionResponse, getSupportedRenditionFormats, GetUploadUrlPayload, ListWorkflowRunsResponse, ObjectSearchPayload, SupportedEmbeddingTypes, supportsVisualRendition } from "@vertesia/common";
+export { canGenerateRendition, getSupportedRenditionFormats, supportsVisualRendition };
+import { StreamSource } from "../StreamSource.js";
+import { AnalyzeDocApi } from "./AnalyzeDocApi.js";
+export interface ComputeFacetsResponse {
+    type?: {
+        _id: string;
+        count: number;
+    }[];
+    location?: {
+        _id: string;
+        count: number;
+    }[];
+    status?: {
+        _id: string;
+        count: number;
+    }[];
+    total?: number;
+}
+export interface SearchResponse {
+    results: ContentObjectItem[];
+    facets: ComputeFacetsResponse;
+}
+export declare class ObjectsApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    analyze(objectId: string): AnalyzeDocApi;
+    getUploadUrl(payload: GetUploadUrlPayload): Promise<GetFileUrlResponse>;
+    getDownloadUrl(fileUri: string, name?: string, disposition?: "inline" | "attachment"): Promise<{
+        url: string;
+    }>;
+    getDownloadUrlWithOptions(payload: GetFileUrlPayload): Promise<{
+        url: string;
+    }>;
+    getContentSource(objectId: string): Promise<ContentSource>;
+    /**
+     * List objects with revision filtering options
+     *
+     * @param payload Search/filter parameters
+     * @returns Matching content objects
+     */
+    list<T = any>(payload?: ObjectSearchPayload): Promise<ContentObjectItem<T>[]>;
+    computeFacets(query: ComputeObjectFacetPayload): Promise<ComputeFacetsResponse>;
+    listFolders(path?: string): void;
+    /** Find object based on query */
+    find(payload: FindPayload): Promise<ContentObject[]>;
+    /** Count number of objects matching this query */
+    count(payload: FindPayload): Promise<{
+        count: number;
+    }>;
+    /** Search object — different from find because allow full text search */
+    search(payload: ComplexSearchPayload): Promise<SearchResponse>;
+    retrieve(id: string, select?: string): Promise<ContentObject>;
+    getObjectText(id: string): Promise<{
+        text: string;
+    }>;
+    upload(source: StreamSource | File): Promise<{
+        source: string;
+        name: string;
+        type: string;
+        etag: string | undefined;
+    }>;
+    create(payload: CreateContentObjectPayload, options?: {
+        collection_id?: string;
+        processing_priority?: ContentObjectProcessingPriority;
+    }): Promise<ContentObject>;
+    /**
+     * 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
+     */
+    createFromExternalSource(uri: string, payload?: CreateContentObjectPayload, options?: {
+        collection_id?: string;
+        processing_priority?: ContentObjectProcessingPriority;
+    }): Promise<ContentObject>;
+    /**
+     * 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
+     */
+    update(id: string, payload: Partial<CreateContentObjectPayload>, options?: {
+        createRevision?: boolean;
+        revisionLabel?: string;
+        processing_priority?: ContentObjectProcessingPriority;
+        suppressWorkflows?: boolean;
+    }): Promise<ContentObject>;
+    /**
+     * 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: string): Promise<ContentObjectItem[]>;
+    /**
+     * 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: string): Promise<any[]>;
+    delete(id: string): Promise<{
+        id: string;
+    }>;
+    listWorkflowRuns(documentId: string): Promise<ListWorkflowRunsResponse>;
+    listRenditions(documentId: string): Promise<ContentObjectItem[]>;
+    getRendition(documentId: string, options: GetRenditionParams): Promise<GetRenditionResponse>;
+    /**
+     * 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: string, contentType: string | undefined, options: GetRenditionParams): Promise<GetRenditionResponse | null>;
+    exportProperties(payload: ExportPropertiesPayload): Promise<ExportPropertiesResponse>;
+    setEmbedding(id: string, type: SupportedEmbeddingTypes, payload: Embedding): Promise<Record<SupportedEmbeddingTypes, Embedding>>;
+}

package/lib/types/store/ObjectsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectsApi.d.ts","sourceRoot":"","sources":["../../../src/store/ObjectsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,oBAAoB,EAEpB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,+BAA+B,EAC/B,aAAa,EACb,0BAA0B,EAC1B,SAAS,EACT,uBAAuB,EACvB,wBAAwB,EACxB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EAEnB,uBAAuB,EACvB,uBAAuB,EAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,qBAAa,UAAW,SAAQ,QAAQ;gBACxB,MAAM,EAAE,UAAU;IAI9B,OAAO,CAAC,QAAQ,EAAE,MAAM;IAIxB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMvE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/G,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1D;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EACR,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAgBlC,aAAa,CACT,KAAK,EAAE,yBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC;IAMjC,WAAW,CAAC,IAAI,GAAE,MAAY;IAI9B,iCAAiC;IACjC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAMpD,kDAAkD;IAClD,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD,yEAAyE;IACzE,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAM9D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ7D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9C,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;;;;;;IA+DlC,MAAM,CACR,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,+BAA+B,CAAC;KACzD,GACF,OAAO,CAAC,aAAa,CAAC;IAyBzB;;;;;;;;OAQG;IACG,wBAAwB,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,0BAA+B,EACxC,OAAO,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,+BAA+B,CAAC;KACzD,GACF,OAAO,CAAC,aAAa,CAAC;IA4BzB;;;;;;;;;;;OAWG;IACG,MAAM,CACR,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,0BAA0B,CAAC,EAC5C,OAAO,CAAC,EAAE;QACN,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,+BAA+B,CAAC;QACtD,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC/B,GACF,OAAO,CAAC,aAAa,CAAC;IAiCzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAI1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIvE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhE,YAAY,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,oBAAoB,CAAC;IAahC;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CACZ,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAOvC,gBAAgB,CACZ,OAAO,EAAE,uBAAuB,GACjC,OAAO,CAAC,wBAAwB,CAAC;IAMpC,YAAY,CACR,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,SAAS,GACnB,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;CAKzD"}

package/lib/types/store/PendingAsksApi.d.ts

@@ -0,0 +1,79 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ListPendingAsksResponse, PendingAskData, UserChannel } from "@vertesia/common";
+/**
+ * Request to register a pending ask.
+ */
+export interface RegisterPendingAskRequest {
+    /** Temporal workflow run ID */
+    runId: string;
+    /** Temporal workflow ID */
+    workflowId: string;
+    /** Name of the agent/interaction */
+    agentName: string;
+    /** Questions asked by the agent */
+    questions: string[];
+    /** Timeout in hours (default 48) */
+    timeoutHours?: number;
+    /** User communication channels */
+    userChannels: UserChannel[];
+}
+/**
+ * Response from registering a pending ask.
+ */
+export interface RegisterPendingAskResponse {
+    /** Whether registration succeeded */
+    success: boolean;
+    /** Generated ask ID */
+    askId?: string;
+    /** Whether webhook was sent */
+    webhookSent?: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Request to resolve a pending ask.
+ */
+export interface ResolvePendingAskRequest {
+    /** User's response */
+    response: string;
+}
+/**
+ * Response from resolving a pending ask.
+ */
+export interface ResolvePendingAskResponse {
+    /** Whether resolution succeeded */
+    success: boolean;
+    /** Whether webhook was sent */
+    webhookSent?: boolean;
+    /** How long the user took to respond (ms) */
+    waitDurationMs?: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Pending Asks API for tracking ask_user requests.
+ * Handles registration, resolution, and listing of pending asks.
+ */
+export declare class PendingAsksApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    /**
+     * Register a new pending ask.
+     * Called when an agent calls ask_user.
+     * Stores in Redis and sends webhook if configured.
+     */
+    register(request: RegisterPendingAskRequest): Promise<RegisterPendingAskResponse>;
+    /**
+     * 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: string, request: ResolvePendingAskRequest): Promise<ResolvePendingAskResponse>;
+    /**
+     * List all pending asks for the current project.
+     */
+    list(): Promise<ListPendingAsksResponse>;
+    /**
+     * Get a specific pending ask by ID.
+     */
+    retrieve(askId: string): Promise<PendingAskData>;
+}

package/lib/types/store/PendingAsksApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingAsksApi.d.ts","sourceRoot":"","sources":["../../../src/store/PendingAsksApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;gBAC5B,MAAM,EAAE,UAAU;IAI9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAIjF;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAI7F;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAIxC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGnD"}

package/lib/types/store/SchedulesApi.d.ts

@@ -0,0 +1,89 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { AgentSchedule, AgentScheduleWithTemporalInfo, CreateSchedulePayload, ScheduleListItem, UpdateSchedulePayload } from "@vertesia/common";
+/**
+ * Client API for managing agent schedules.
+ *
+ * Schedules allow agents to run on a recurring basis using cron expressions.
+ */
+export declare class SchedulesApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    /**
+     * List all schedules in the project.
+     */
+    list(): Promise<ScheduleListItem[]>;
+    /**
+     * Retrieve a schedule by ID.
+     * Includes Temporal execution info if available.
+     */
+    retrieve(id: string): Promise<AgentScheduleWithTemporalInfo>;
+    /**
+     * 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: CreateSchedulePayload): Promise<AgentSchedule>;
+    /**
+     * Update an existing schedule.
+     *
+     * @param id - Schedule ID
+     * @param payload - Fields to update
+     * @returns The updated schedule
+     */
+    update(id: string, payload: UpdateSchedulePayload): Promise<AgentSchedule>;
+    /**
+     * Delete a schedule.
+     *
+     * This also removes the corresponding Temporal schedule.
+     *
+     * @param id - Schedule ID
+     * @returns Object with the deleted schedule ID
+     */
+    delete(id: string): Promise<{
+        id: string;
+    }>;
+    /**
+     * 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: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * 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: string, note?: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Resume a paused schedule.
+     *
+     * @param id - Schedule ID
+     * @param note - Optional note explaining why the schedule was resumed
+     * @returns Success message
+     */
+    resume(id: string, note?: string): Promise<{
+        message: string;
+    }>;
+}

package/lib/types/store/SchedulesApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchedulesApi.d.ts","sourceRoot":"","sources":["../../../src/store/SchedulesApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACH,aAAa,EACb,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACxB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,QAAQ;gBAC1B,MAAM,EAAE,UAAU;IAI9B;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAInC;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI5D;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1E;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3C;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjD;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9D;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGlE"}

package/lib/types/store/ToolsApi.d.ts

@@ -0,0 +1,13 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import type { BuiltinToolsCatalogResponse } from "@vertesia/common";
+/**
+ * API for accessing the builtin tools catalog
+ */
+export declare class ToolsApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    /**
+     * Get the builtin tools catalog
+     * @returns List of all available builtin tools with their descriptions and parameter schemas
+     */
+    getBuiltinCatalog(): Promise<BuiltinToolsCatalogResponse>;
+}

package/lib/types/store/ToolsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsApi.d.ts","sourceRoot":"","sources":["../../../src/store/ToolsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,MAAM,EAAE,UAAU;IAI9B;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,2BAA2B,CAAC;CAG5D"}