@mindstudio-ai/agent 0.1.101 → 0.1.103

package/llms.txt

@@ -776,8 +776,10 @@ Search the web using Google and return structured results.
 - Defaults to us/english, but can optionally specify country and/or language.
 - Defaults to any time, but can optionally specify last hour, last day, week, month, or year.
 - Defaults to top 30 results, but can specify 1 to 100 results to return.
-- Input: `{ query: string, exportType: "text" | "json", countryCode?: string, languageCode?: string, dateRange?: "hour" | "day" | "week" | "month" | "year" | "any", numResults?: number }`
-- Output: `{ results: { title: string, description: string, url: string }[] }`
+- Set fetchTopN to also read the page content of the first N results in the same step, instead of following up with a separate Scrape URL step per result. Costs meaningfully more (each page is a full scrape), so ask for the fewest you need.
+- Also returns Google's "people also ask" and related searches when available, which are useful for choosing a follow-up query.
+- Input: `{ query: string, exportType: "text" | "json", countryCode?: string, languageCode?: string, dateRange?: "hour" | "day" | "week" | "month" | "year" | "any", numResults?: number, fetchTopN?: number }`
+- Output: `{ results: { title: string, description: string, url: string, content?: string }[], peopleAlsoAsk?: { question?: string, snippet?: string, link?: string }[], relatedSearches?: string[] }`
 
 #### searchGoogleImages
 Search Google Images and return image results with URLs and metadata.
@@ -1810,7 +1812,7 @@ const { url } = await mindstudio.uploadFile(readFileSync('photo.png'), { extensi
 Output: `{ url: string }` — The permanent public CDN URL.
 
 #### `files` — per-app file storage (private by default)
-Typed per-app file storage: user uploads, generated documents, images, marketing assets. Think of a store as a CDN-backed bucket the app talks to — NOT app-defined state like a `db` table. The API is *shaped* like the `db` namespace (define a store at module scope, then read/write), but its contents aren't modeled by code, and one store is shared across dev and prod (a file uploaded in the dev editor is already live in prod at the same URL). Creates are safe by default because keys default to unique (UUID, or a content-addressed hash); the operations to treat with care are `delete(key)` and overwriting a fixed key. Files are served on the app's own domain: private stores (the default) are signed / session-authorized; public stores are world-readable, CDN-served, and images resize via query params (e.g. `?w=400&h=300&fit=cover`). Prefer this over the deprecated `uploadFile()` for app storage.
+Typed per-app file storage: user uploads, generated documents, images, marketing assets. Think of a store as a CDN-backed bucket the app talks to — NOT app-defined state like a `db` table. The API is *shaped* like the `db` namespace (define a store at module scope, then read/write), but its contents aren't modeled by code, and one store is shared across dev and prod (a file uploaded in the dev editor is already live in prod at the same URL). Creates are safe by default because keys default to unique (UUID, or a content-addressed hash); the operations to treat with care are `delete(key)` and overwriting a fixed key. Public objects are CDN-cached per their `Cache-Control`, set at put time via `cacheControl`: auto-minted keys default to immutable (cache-forever — the key is never reused), and named keys default to `public, max-age=300`, so overwriting one propagates publicly within ~5 minutes; pass `cacheControl` to tune (e.g. `'public, max-age=60'` for near-live config, `'no-store'` to revalidate every read). Files are served on the app's own domain: private stores (the default) are signed / session-authorized; public stores are world-readable, CDN-served, and images resize via query params (e.g. `?w=400&h=300&fit=cover`). Prefer this over the deprecated `uploadFile()` for app storage.
 
 ```typescript
 import { files } from '@mindstudio-ai/agent';
@@ -1826,7 +1828,7 @@ await file.shareUrl(); // absolute signed URL that works with NO session (email/
 ```
 
 Store methods:
-- `put(content, { key?, contentType?, filename?, contentAddressed? })` → `StoredFile`. `content` is `Buffer | Uint8Array | string`. Omit `key` for a random UUID; `contentAddressed: true` derives an immutable `<sha256>.<ext>` key.
+- `put(content, { key?, contentType?, filename?, contentAddressed?, cacheControl? })` → `StoredFile`. `content` is `Buffer | Uint8Array | string`. Omit `key` for a random UUID; `contentAddressed: true` derives an immutable `<sha256>.<ext>` key. `cacheControl` sets the CDN caching of a public object (defaults: auto-minted keys immutable, named keys `public, max-age=300`).
 - `get(key)` → `Buffer` · `head(key)` → `StoredFile` · `exists(key)` → `boolean`
 - `list({ prefix?, cursor?, limit? })` → `{ files: StoredFile[]; cursor? }`
 - `delete(key)` → `void`
@@ -1839,7 +1841,7 @@ Store methods:
 User uploads (client-direct — bytes go straight to storage, never through the app backend): a backend method mints a token, the frontend submits it with `@mindstudio-ai/interface`.
 ```typescript
 // backend method
-const token = await Uploads.createUploadToken({ contentType, maxSize: 25 * 1024 * 1024 });
+const token = await Uploads.createUploadToken({ contentType, maxSize: 25 * 1024 * 1024 }); // also accepts cacheControl
 return token;
 // frontend (@mindstudio-ai/interface)
 import { platform } from '@mindstudio-ai/interface';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/agent",
-  "version": "0.1.101",
+  "version": "0.1.103",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",