@vertesia/client 0.24.0-dev.202601221707

package/lib/esm/store/DataApi.js

@@ -0,0 +1,429 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+import { DataStoreApiHeaders, } from "@vertesia/common";
+import { DashboardApi } from "./DashboardApi.js";
+/**
+ * Client API for managing versioned analytical data stores.
+ *
+ * Data stores provide DuckDB-powered analytical databases with:
+ * - AI-manageable schemas
+ * - Multi-table atomic imports
+ * - Version history and rollback
+ * - Named snapshots
+ */
+export class DataApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/data");
+    }
+    /**
+     * Create headers with data store ID for Cloud Run session affinity.
+     * This routes requests for the same store to the same instance.
+     */
+    storeHeaders(id) {
+        return { [DataStoreApiHeaders.DATA_STORE_ID]: id };
+    }
+    // ============================================================
+    // Store Operations
+    // ============================================================
+    /**
+     * List all data stores in the project.
+     */
+    list() {
+        return this.get("/");
+    }
+    /**
+     * Create a new data store.
+     *
+     * @param payload - Store configuration including name and optional description
+     * @returns The created data store
+     *
+     * @example
+     * ```typescript
+     * const store = await client.data.create({
+     *   name: 'analytics',
+     *   description: 'Customer analytics data'
+     * });
+     * ```
+     */
+    create(payload) {
+        return this.post("/", { payload });
+    }
+    /**
+     * Retrieve a data store by ID.
+     *
+     * @param id - Data store ID
+     * @returns The data store with full details
+     */
+    retrieve(id) {
+        return this.get(`/${id}`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Archive (soft delete) a data store.
+     *
+     * The store data remains in GCS but is no longer accessible via API.
+     *
+     * @param id - Data store ID
+     * @returns Object with the archived store ID
+     */
+    delete(id) {
+        return this.del(`/${id}`, { headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Schema Operations
+    // ============================================================
+    /**
+     * Get the schema of a data store.
+     *
+     * @param id - Data store ID
+     * @param format - Optional format: 'ai' returns AI-friendly simplified schema
+     * @returns The schema (full or AI-friendly format)
+     *
+     * @example
+     * ```typescript
+     * // Get full schema
+     * const schema = await client.data.getSchema(storeId);
+     *
+     * // Get AI-friendly schema for agent context
+     * const aiSchema = await client.data.getSchema(storeId, 'ai');
+     * ```
+     */
+    getSchema(id, format) {
+        const query = format ? `?format=${format}` : '';
+        return this.get(`/${id}/schema${query}`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Update the schema of a data store.
+     *
+     * Use this for AI-driven schema evolution. The schema version is automatically
+     * incremented based on the type of change (major, minor, patch).
+     *
+     * @param id - Data store ID
+     * @param payload - Schema update payload with bump type
+     * @returns The updated schema
+     */
+    updateSchema(id, payload) {
+        return this.put(`/${id}/schema`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Get the schema version history of a data store.
+     *
+     * @param id - Data store ID
+     * @returns List of schema versions with timestamps
+     */
+    getSchemaHistory(id) {
+        return this.get(`/${id}/schema/history`, { headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Table Operations
+    // ============================================================
+    /**
+     * List all tables in a data store.
+     *
+     * @param id - Data store ID
+     * @returns List of table summaries with metadata
+     */
+    listTables(id) {
+        return this.get(`/${id}/tables`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Create tables in a data store atomically.
+     *
+     * All tables are created in a single transaction - if any table fails,
+     * no tables are created.
+     *
+     * @param id - Data store ID
+     * @param payload - Tables to create and commit message
+     * @returns Array of created tables
+     *
+     * @example
+     * ```typescript
+     * const tables = await client.data.createTables(storeId, {
+     *   message: 'Create e-commerce schema',
+     *   tables: [
+     *     {
+     *       name: 'customers',
+     *       columns: [
+     *         { name: 'id', type: 'INTEGER', primary_key: true },
+     *         { name: 'email', type: 'STRING' },
+     *       ]
+     *     },
+     *     {
+     *       name: 'orders',
+     *       columns: [
+     *         { name: 'id', type: 'INTEGER', primary_key: true },
+     *         { name: 'customer_id', type: 'INTEGER' },
+     *       ],
+     *       foreign_keys: [
+     *         { column: 'customer_id', references_table: 'customers', references_column: 'id' }
+     *       ]
+     *     }
+     *   ]
+     * });
+     * ```
+     */
+    createTables(id, payload) {
+        return this.post(`/${id}/tables`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Get a table by name.
+     *
+     * @param id - Data store ID
+     * @param tableName - Table name
+     * @param sample - If true, includes sample rows
+     * @returns The table with metadata and optional sample data
+     */
+    getTable(id, tableName, sample) {
+        const query = sample ? '?sample=true' : '';
+        return this.get(`/${id}/tables/${tableName}${query}`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Alter a table schema.
+     *
+     * @param id - Data store ID
+     * @param tableName - Table name
+     * @param payload - Changes to apply (add/drop/modify columns, etc.)
+     * @returns The updated table
+     */
+    alterTable(id, tableName, payload) {
+        return this.put(`/${id}/tables/${tableName}`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Drop a table from the data store.
+     *
+     * @param id - Data store ID
+     * @param tableName - Table name
+     */
+    dropTable(id, tableName) {
+        return this.del(`/${id}/tables/${tableName}`, { headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Import Operations
+    // ============================================================
+    /**
+     * Import data into one or more tables atomically.
+     *
+     * If any table import fails, the entire operation is rolled back.
+     * Creates a version snapshot before the import for recovery.
+     *
+     * @param id - Data store ID
+     * @param payload - Import configuration with tables and data
+     * @returns Import job with status
+     *
+     * @example
+     * ```typescript
+     * const job = await client.data.import(storeId, {
+     *   mode: 'append',
+     *   message: 'Monthly data import',
+     *   tables: {
+     *     customers: {
+     *       source: 'gs://bucket/customers.csv',
+     *       format: 'csv'
+     *     },
+     *     orders: {
+     *       data: [
+     *         { id: 1, customer_id: 1, amount: 99.99 }
+     *       ]
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    import(id, payload) {
+        return this.post(`/${id}/import`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Get the status of an import job.
+     *
+     * @param id - Data store ID
+     * @param importId - Import job ID
+     * @returns Import job status
+     */
+    getImportStatus(id, importId) {
+        return this.get(`/${id}/import/${importId}`, { headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Version Operations
+    // ============================================================
+    /**
+     * List versions of a data store.
+     *
+     * @param id - Data store ID
+     * @param snapshotsOnly - If true, only returns named snapshots
+     * @returns List of versions
+     */
+    listVersions(id, snapshotsOnly) {
+        const query = snapshotsOnly ? '?snapshots_only=true' : '';
+        return this.get(`/${id}/versions${query}`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Create a named snapshot of the current state.
+     *
+     * Named snapshots are kept indefinitely (not subject to 30-day cleanup).
+     *
+     * @param id - Data store ID
+     * @param payload - Snapshot name and optional message
+     * @returns The created version/snapshot
+     *
+     * @example
+     * ```typescript
+     * const snapshot = await client.data.createSnapshot(storeId, {
+     *   name: 'before-migration',
+     *   message: 'Snapshot before major schema change'
+     * });
+     * ```
+     */
+    createSnapshot(id, payload) {
+        return this.post(`/${id}/versions`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Rollback to a previous version.
+     *
+     * Creates a new version that is a copy of the target version.
+     *
+     * @param id - Data store ID
+     * @param versionId - Version ID to rollback to
+     * @returns The updated data store
+     */
+    rollback(id, versionId) {
+        return this.post(`/${id}/versions/${versionId}/rollback`, { headers: this.storeHeaders(id) });
+    }
+    /**
+     * Query a specific version or snapshot without rolling back.
+     *
+     * Useful for migrations: read data from old schema format to transform it.
+     *
+     * @param id - Data store ID
+     * @param versionId - Version ID or snapshot ID to query
+     * @param payload - Query configuration
+     * @returns Query results from the version
+     *
+     * @example
+     * ```typescript
+     * // Create snapshot before migration
+     * const snapshot = await client.data.createSnapshot(storeId, {
+     *   name: 'pre-migration',
+     *   message: 'Before name split migration'
+     * });
+     *
+     * // Query old data from snapshot
+     * const oldData = await client.data.queryVersion(storeId, snapshot.id, {
+     *   sql: 'SELECT id, full_name, email FROM customers'
+     * });
+     *
+     * // Transform and import with new schema...
+     * ```
+     */
+    queryVersion(id, versionId, payload) {
+        return this.post(`/${id}/versions/${versionId}/query`, { payload, headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Query Operations
+    // ============================================================
+    /**
+     * Execute a read-only SQL query against the data store.
+     *
+     * @param id - Data store ID
+     * @param payload - Query configuration
+     * @returns Query results
+     *
+     * @example
+     * ```typescript
+     * const result = await client.data.query(storeId, {
+     *   sql: 'SELECT customer_id, SUM(amount) as total FROM orders GROUP BY customer_id',
+     *   limit: 100
+     * });
+     * console.log(result.rows);
+     * ```
+     */
+    query(id, payload) {
+        return this.post(`/${id}/query`, { payload, headers: this.storeHeaders(id) });
+    }
+    /**
+     * Validate SQL queries without executing them.
+     *
+     * Uses DuckDB's EXPLAIN to check syntax and table/column references
+     * against the store's schema. Useful for validating dashboard queries
+     * before saving.
+     *
+     * @param id - Data store ID
+     * @param queries - Array of queries to validate
+     * @returns Validation result with any errors
+     *
+     * @example
+     * ```typescript
+     * const result = await client.data.validateQueries(storeId, [
+     *   { name: 'sales', sql: 'SELECT * FROM sales WHERE date > {{start_date}}' },
+     *   { name: 'products', sql: 'SELECT * FROM productss' } // typo!
+     * ]);
+     *
+     * if (!result.valid) {
+     *   for (const err of result.errors) {
+     *     console.log(`Query '${err.query}': ${err.error}`);
+     *   }
+     * }
+     * ```
+     */
+    validateQueries(id, queries) {
+        return this.post(`/${id}/query/validate`, { payload: { queries }, headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Download Operations (for sandbox sync)
+    // ============================================================
+    /**
+     * Get a signed download URL for the database file.
+     *
+     * Used by sandbox to sync databases for native DuckDB access.
+     * Returns signed URL + gcs_generation for cache validation.
+     *
+     * @param id - Data store ID
+     * @param versionId - Optional: specific version/snapshot ID (default: latest)
+     * @returns Download info with signed URL and cache validation data
+     *
+     * @example
+     * ```typescript
+     * const info = await client.data.getDownloadInfo(storeId);
+     * // Download if gcs_generation changed
+     * if (info.gcs_generation !== localGeneration) {
+     *   await downloadFile(info.url, '/home/daytona/databases/store.duckdb');
+     * }
+     * ```
+     */
+    getDownloadInfo(id, versionId) {
+        const query = versionId ? `?version_id=${versionId}` : '';
+        return this.get(`/${id}/download${query}`, { headers: this.storeHeaders(id) });
+    }
+    // ============================================================
+    // Dashboard Operations
+    // ============================================================
+    /**
+     * Get the Dashboard API for a specific data store.
+     *
+     * @param storeId - Data store ID
+     * @returns DashboardApi instance for managing dashboards
+     *
+     * @example
+     * ```typescript
+     * // List dashboards
+     * const dashboards = await client.data.dashboards(storeId).list();
+     *
+     * // Preview a dashboard before creating
+     * const preview = await client.data.dashboards(storeId).preview({
+     *   queries: [{ name: 'sales', sql: 'SELECT * FROM sales' }],
+     *   panels: [{ title: 'Sales', dataSources: ['sales'], ... }]
+     * });
+     *
+     * // Create a dashboard
+     * const dashboard = await client.data.dashboards(storeId).create({
+     *   name: 'Sales Overview',
+     *   queries: [...],
+     *   panels: [...]
+     * });
+     *
+     * // Render dashboard to PNG
+     * const result = await client.data.dashboards(storeId).render(dashboardId);
+     * ```
+     */
+    dashboards(storeId) {
+        return new DashboardApi(this.client, storeId);
+    }
+}
+//# sourceMappingURL=DataApi.js.map

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

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

package/lib/esm/store/EmailApi.js

@@ -0,0 +1,99 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * Email API for sending emails from workflows.
+ */
+export class EmailApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, "/api/v1/email");
+    }
+    /**
+     * Send an email from an agent/workflow.
+     * Creates a route key if not provided, sends via Resend, and returns routing info.
+     */
+    send(request) {
+        return this.post("/send", { payload: request });
+    }
+    /**
+     * 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) {
+        return this.post("/resolve-route", { payload: { route_key: routeKey } });
+    }
+    // ============================================================================
+    // Routes API - for external service integration
+    // ============================================================================
+    /**
+     * 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) {
+        return this.post("/routes", { payload: request });
+    }
+    /**
+     * Get an email route by key.
+     */
+    getRoute(routeKey) {
+        return this.get(`/routes/${routeKey}`);
+    }
+    /**
+     * Update an email route (e.g., to update threading info).
+     */
+    updateRoute(routeKey, updates) {
+        return this.put(`/routes/${routeKey}`, { payload: updates });
+    }
+    /**
+     * 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, request) {
+        return this.post(`/routes/${routeKey}/forward`, { payload: request });
+    }
+}
+//# sourceMappingURL=EmailApi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EmailApi.js","sourceRoot":"","sources":["../../../src/store/EmailApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AA2GlE;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAClC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,OAAyB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,QAAgB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,+EAA+E;IAC/E,gDAAgD;IAChD,+EAA+E;IAE/E;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,OAA2B;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAgB;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB,EAAE,OAAgC;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,YAAY,CAAC,QAAgB,EAAE,OAA4B;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,QAAQ,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;CACJ"}

package/lib/esm/store/EmbeddingsApi.js

@@ -0,0 +1,25 @@
+import { ApiTopic } from "@vertesia/api-fetch-client";
+/**
+ * @since 0.52.0
+ */
+export class EmbeddingsApi extends ApiTopic {
+    constructor(parent, basePath = "/api/v1/embeddings") {
+        super(parent, basePath);
+    }
+    async status(type) {
+        return this.get(type + "/status");
+    }
+    async activate(type, config) {
+        if (!config.environment) {
+            throw new Error("Invalid configuration: select environment");
+        }
+        return this.post(type + "/enable", { payload: config });
+    }
+    async disable(type) {
+        return this.post(type + "/disable");
+    }
+    async recalculate(type) {
+        return this.post(type + "/recalculate");
+    }
+}
+//# sourceMappingURL=EmbeddingsApi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingsApi.js","sourceRoot":"","sources":["../../../src/store/EmbeddingsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAQlE;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAEvC,YAAY,MAAkB,EAAE,WAAmB,oBAAoB;QACnE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA6B,EAAE,MAA+C;QAEzF,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA6B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC;IAC5C,CAAC;CAEJ"}