@mindstudio-ai/agent 0.1.87 → 0.1.89

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/llms.txt CHANGED
@@ -303,7 +303,7 @@ Convert each page of a PDF document into a PNG image.
303
303
  - Output: `{ imageUrls: string[] }`
304
304
 
305
305
  #### createDataSource
306
- Create a new empty vector data source for the current app.
306
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Create a new empty vector data source for the current app.
307
307
  - Creates a new data source (vector database) associated with the current app version.
308
308
  - The data source is created empty — use the "Upload Data Source Document" block to add documents.
309
309
  - Returns the new data source ID which can be used in subsequent blocks.
@@ -319,7 +319,7 @@ Create a draft email in the connected Gmail account.
319
319
  - Output: `{ draftId: string }`
320
320
 
321
321
  #### deleteDataSource
322
- Delete a vector data source from the current app.
322
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Delete a vector data source from the current app.
323
323
  - Soft-deletes a data source (vector database) by marking it as deleted.
324
324
  - The Milvus partition is cleaned up asynchronously by a background cron job.
325
325
  - The data source must belong to the current app version.
@@ -327,7 +327,7 @@ Delete a vector data source from the current app.
327
327
  - Output: `unknown`
328
328
 
329
329
  #### deleteDataSourceDocument
330
- Delete a single document from a data source.
330
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Delete a single document from a data source.
331
331
  - Soft-deletes a document by marking it as deleted.
332
332
  - Requires both the data source ID and document ID.
333
333
  - After deletion, reloads vectors into Milvus so the data source reflects the change immediately.
@@ -422,7 +422,7 @@ Download a file from a URL and extract its text content. Supports PDFs (includin
422
422
  - Output: `{ text: string | string[] }`
423
423
 
424
424
  #### fetchDataSourceDocument
425
- Fetch the full extracted text contents of a document in a data source.
425
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Fetch the full extracted text contents of a document in a data source.
426
426
  - Loads a document by ID and returns its full extracted text content.
427
427
  - The document must have been successfully processed (status "done").
428
428
  - Also returns document metadata (name, summary, word count).
@@ -557,7 +557,7 @@ Insert b-roll clips into a base video at a timecode, optionally with an xfade tr
557
557
  - Output: `{ videoUrl: string }`
558
558
 
559
559
  #### listDataSources
560
- List all data sources for the current app.
560
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. List all data sources for the current app.
561
561
  - Returns metadata for every data source associated with the current app version.
562
562
  - Each entry includes the data source ID, name, description, status, and document list.
563
563
  - Input: `object`
@@ -659,7 +659,7 @@ when parameterize is false.
659
659
  - Output: `{ rows: unknown[], changes: number }`
660
660
 
661
661
  #### queryDataSource
662
- Search a vector data source (RAG) and return relevant document chunks.
662
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Search a vector data source (RAG) and return relevant document chunks.
663
663
  - Queries a vectorized data source and returns the most relevant chunks.
664
664
  - Useful for retrieval-augmented generation (RAG) workflows.
665
665
  - Input: `{ dataSourceId: string, query: string, maxResults: number }`
@@ -958,7 +958,7 @@ Add or remove labels on Gmail messages, identified by message IDs or a search qu
958
958
  - Output: `{ updatedMessageIds: string[] }`
959
959
 
960
960
  #### uploadDataSourceDocument
961
- Upload a file into an existing data source from a URL or raw text content.
961
+ Legacy v1 data sources. v2 apps should use `dataSources.defineDataSource()` from @mindstudio-ai/agent instead, which owns parsing, chunking, embedding and citations. Upload a file into an existing data source from a URL or raw text content.
962
962
  - If "file" is a single URL, the file is downloaded from that URL and uploaded.
963
963
  - If "file" is any other string, a .txt document is created from that content and uploaded.
964
964
  - The block waits (polls) for processing to complete before transitioning, up to 5 minutes.
@@ -1841,6 +1841,12 @@ import { platform } from '@mindstudio-ai/interface';
1841
1841
  const { url } = await platform.upload(token, file, { onProgress });
1842
1842
  ```
1843
1843
 
1844
+ Generated assets: any action that produces a file (`generateImage`, `generateVideo`, `generateSpeech`, `generatePdf`, `upscaleImage`, …) can put its output straight into one of these stores — pass the store handle as `store` in the OPTIONS object (second argument). Optional: omit it and the asset goes to the shared MindStudio CDN as before. Reach for it when the asset belongs to the app — private to a user, or listed alongside its other files.
1845
+
1846
+ ```typescript
1847
+ const { imageUrl } = await mindstudio.generateImage({ prompt: 'a red sneaker' }, { store: Assets });
1848
+ ```
1849
+
1844
1850
  #### `dataSources` — searchable document corpora (RAG)
1845
1851
 
1846
1852
  Declare a data source at module scope and import the handle. The platform owns parsing, chunking, embedding, storage and tenant isolation; every hit returns a citation.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mindstudio-ai/agent",
3
- "version": "0.1.87",
3
+ "version": "0.1.89",
4
4
  "description": "TypeScript SDK for MindStudio direct step execution",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",