@mindstudio-ai/agent 0.1.62 → 0.1.64

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
@@ -1475,6 +1476,62 @@ Update the content of an existing Notion page.
 - Input: `{ pageId: string, content: string, mode: "append" | "overwrite", connectionId?: string }`
 - Output: `{ pageId: string, pageUrl: string }`
 
+### Particle Podcasts
+
+#### particlePodcastsFindMentions
+Find every dialogue line mentioning a specific entity or company across all podcasts.
+- Provide `entityId` (for people, products, places) OR `companyId` (for organizations). At least one is required.
+- Use `contextLines` to include surrounding dialogue with each mention (default behavior is set by Particle).
+- Resolve a name to an `entityId` / `companyId` first via Search Companies (or by inspecting a Search Dialogue response).
+- Cursor-paginated; expect potentially large result sets for popular entities.
+- Input: `{ entityId?: string, companyId?: string, contextLines?: number, limit?: number, cursor?: string }`
+- Output: `unknown`
+
+#### particlePodcastsGetEpisode
+Fetch full metadata for a single episode: details, speakers, entities, clips, and ads — merged into one response.
+- Pass an episode ID or slug as `id`.
+- Returns five sub-resources merged: `episode` (metadata), `speakers` (diarized speaker list), `entities` (knowledge-graph mentions), `clips` (AI-extracted highlights), `ads` (detected ad spots).
+- Use Get Episode Transcript separately when you need the full transcript text — it isn't bundled here because the payload is large and has its own format/range options.
+- Bills as 5 units against the get-episode event type (one per sub-call).
+- Input: `{ id: string }`
+- Output: `unknown`
+
+#### particlePodcastsGetEpisodeTranscript
+Fetch the diarized transcript for an episode in dialogue, plain text, or SRT subtitle format.
+- Pass an episode ID or slug as `id`.
+- Use `format` = "dialogue" (default, with speaker turns), "text" (plain), or "srt" (subtitle).
+- Filter to a single speaker with `speaker`, or to a time range with `start` / `end` (seconds).
+- Transcripts are large — prefer time-range filtering when you only need a snippet.
+- Input: `{ id: string, format?: "dialogue" | "text" | "srt", speaker?: string, start?: number, end?: number }`
+- Output: `unknown`
+
+#### particlePodcastsSearchCompanies
+Search the Particle knowledge graph for companies by name, ticker, domain, CIK, or QID.
+- Provide one or more identifiers: `q` (free-text name), `ticker` (e.g. "TSLA"), `domain` (e.g. "tesla.com"), `cik` (SEC), or `qid` (Wikidata).
+- Use this to resolve a company name to a canonical `companyId` for use with Find Mentions or Search Dialogue.
+- Returned company objects include slugs, domains, and IDs — any of these can be passed to downstream blocks.
+- Input: `{ q?: string, ticker?: string, domain?: string, cik?: string, qid?: string, entityId?: string, updatedAfter?: string, limit?: number, cursor?: string }`
+- Output: `unknown`
+
+#### particlePodcastsSearchDialogue
+Search across podcast dialogue using semantic or keyword search. Returns matched lines grouped by episode.
+- Provide `semanticSearch` for meaning-based discovery ("find moments where someone talks about market timing") or `keywordSearch` for exact phrase/proper-noun matching. At least one must be provided.
+- Filter to a specific entity or company by passing `entityId` / `companyId`.
+- Each returned dialogue line carries the source episode + speaker so you can chain to Get Episode or Get Episode Transcript for context.
+- Cursor-paginated.
+- Input: `{ semanticSearch?: string, keywordSearch?: string, entityId?: string, companyId?: string, limit?: number, cursor?: string }`
+- Output: `unknown`
+
+#### particlePodcastsSearchPodcasts
+Search and list podcasts in the Particle catalog by keyword, topic, or language.
+- Use `q` for free-text keyword search across podcast titles and descriptions.
+- Use `topic` to filter to a Particle taxonomy topic.
+- Use `language` (BCP 47, e.g. "en") to restrict to a language.
+- Returns podcast objects with canonical IDs and slugs. Pass either to other Particle Podcasts blocks.
+- Cursor-paginated; pass the returned `cursor` back to `cursor` for the next page.
+- Input: `{ q?: string, topic?: string, language?: string, suitabilityTier?: string, limit?: number, cursor?: string }`
+- Output: `unknown`
+
 ### X
 
 #### postToX
@@ -1517,6 +1574,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.64",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",