@mindstudio-ai/agent 0.1.62 → 0.1.63

package/llms.txt

@@ -680,9 +680,10 @@ Replace personally identifiable information in text with placeholders using Micr
 
 #### removeBackgroundFromImage
 Remove the background from an image using AI, producing a transparent PNG.
-- Uses the Bria background removal model via fal.ai.
+- Uses the Bria background removal model via fal.ai by default.
+- Uses WaveSpeed's Ideogram background removal model when type is "advanced".
 - Output is re-hosted on the CDN as a PNG with transparency.
-- Input: `{ imageUrl: string }`
+- Input: `{ type?: "standard" | "advanced", imageUrl: string }`
 - Output: `{ imageUrl: string }`
 
 #### resizeVideo
@@ -1517,6 +1518,66 @@ For example, has:media alone is invalid, but #AI has:media is valid.
 - Input: `{ query: string, scope: "recent" | "all", options: { startTime?: string, endTime?: string, maxResults?: number } }`
 - Output: `{ posts: { id: string, authorId: string, dateCreated: string, text: string, stats: { retweets: number, replies: number, likes: number } }[] }`
 
+### You.com
+
+#### youDotComFinanceResearch
+Ask a financial research question using You.com Finance Research and return the sourced response.
+- Use this for financial questions such as company analysis, earnings, market research, filings, macroeconomics, and due diligence.
+- researchEffort supports deep (default) or exhaustive.
+- Finance Research returns the same response shape as Web Research, but searches a finance-optimized index.
+- Use it for cited synthesis, not raw price feeds or structured time-series exports.
+- Input: `{ input: string, researchEffort?: "deep" | "exhaustive" }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComGetPageContent
+Fetch clean Markdown, HTML, or metadata for known URLs using the You.com Contents API.
+- Use this step when you already know the URLs. Use Web Search with livecrawl when You.com should discover pages from a query.
+- A single request supports up to 10 URLs.
+- Request only the formats you need. Markdown is recommended for LLM consumption.
+- Increase crawlTimeout for JavaScript-heavy pages, up to 60 seconds.
+- Individual pages can partially fail; check each returned item before processing.
+- Input: `{ urls: string[], formats?: ("markdown" | "html" | "metadata")[], crawlTimeout?: number }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComLiveNews
+Fetch live news articles through the You.com Search API and return the full structured response.
+- Defaults freshness to day for breaking or recent news.
+- Use country and language together to monitor regional or non-English news.
+- Use livecrawl: 'news' with livecrawlFormats: ['markdown'] when you need full article text.
+- Use a custom freshness range like YYYY-MM-DDtoYYYY-MM-DD for historical news windows.
+- Input: `{ query: string, freshness?: string, count?: number, country?: string, language?: string, safesearch?: "off" | "moderate" | "strict", livecrawl?: "news" | "all", livecrawlFormats?: ("markdown" | "html")[] }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComWebResearch
+Ask a research question and return a grounded You.com Research API answer with sources.
+- Use Web Search when you need raw URLs and snippets. Use Web Research when you want a synthesized answer with citations.
+- researchEffort controls depth and latency: lite, standard, deep, or exhaustive. standard is a good default.
+- sourceControl can restrict, exclude, or boost domains, and can apply freshness or country filters.
+- includeDomains cannot be combined with excludeDomains or boostDomains.
+- outputSchema returns structured output.content and is supported by standard, deep, and exhaustive, not lite.
+- Input: `{ input: string, researchEffort?: "lite" | "standard" | "deep" | "exhaustive", sourceControl?: { includeDomains?: string[], excludeDomains?: string[], boostDomains?: string[], freshness?: string, country?: string } | string, outputSchema?: object | string }`
+- Output: `{ data: object | unknown[] }`
+
+#### youDotComWebSearch
+Search the web and news using the You.com Search API and return the full structured response.
+- Query supports You.com search operators:
+| Operator | Description | Example |
+| -------- | ----------- | ------- |
+| site: | Search within a domain and its subdomains | site:uscourts.gov |
+| filetype: | Search for a specific file type | filetype:pdf |
+| + | Require the exact term after the operator | +GAAP |
+| - | Exclude the exact term after the operator | -prs |
+| AND | Require both expressions | guitar AND Fender |
+| OR | Match either expression | guitar OR drum |
+| NOT | Negate an expression | NOT site:uscourts.gov |
+- Use livecrawl with livecrawlFormats: ['markdown'] when you need full page content instead of snippets.
+- Use the Get Page Content step when you already know the URLs to fetch.
+- Use freshness for recency: day, week, month, year, or YYYY-MM-DDtoYYYY-MM-DD.
+- Use country (ISO 3166-1 alpha-2) and language (BCP 47) to focus results geographically or linguistically.
+- includeDomains cannot be combined with excludeDomains or boostDomains.
+- Input: `{ query: string, count?: number, freshness?: string, country?: string, language?: string, offset?: number, safesearch?: "off" | "moderate" | "strict", livecrawl?: "web" | "news" | "all", livecrawlFormats?: ("markdown" | "html")[], crawlTimeout?: number, includeDomains?: string[], excludeDomains?: string[], boostDomains?: string[] }`
+- Output: `{ data: object | unknown[] }`
+
 ### YouTube
 
 #### fetchYoutubeCaptions

package/package.json

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