@brandazine/solari-sdk 0.1.0 → 0.2.0

package/README.md

@@ -14,20 +14,36 @@ import { Solari } from "@brandazine/solari-sdk";
 const solari = new Solari({ token: process.env.SOLARI_TOKEN });
 
 const hits = await solari.tools.catalog.instagram.account.search({ query: "nike", limit: 3 });
-const brand = await solari.call("solari_insight_instagram_brand_overview", { username: "nike" });
+const brand = await solari.tools.insight.instagram.brand.overview({ username: "nike" });
 const tools = await solari.listTools();
 ```
 
 Get a token with `solari auth token` on a machine that is signed in to the [solari CLI](https://solari.sh/docs), or pass a token you already hold from an MCP connector. With no `token` option the client reads `SOLARI_TOKEN`.
 
+## Typed tools
+
+`solari.tools` is generated from the SOLARI tool registry, so every tool path, argument name, argument type, and enum value is checked by the TypeScript compiler and completed by your editor. A missing required argument, a misspelled key, or an out-of-range enum fails at compile time.
+
+```ts
+await solari.tools.catalog.instagram.account.search({ query: "nike", query_type: "bio" });
+await solari.tools.catalog.instagram.account.search({ limit: 3 }); // error: query is required
+await solari.tools.catalog.instagram.account.search({ query: "nike", query_type: "fuzzy" }); // error: not an enum value
+```
+
+Tool responses are JSON whose shape is documented per tool at [solari.sh/docs](https://solari.sh/docs); pass a type parameter to name it: `search<AccountHits>({ ... })`.
+
+`solari.call(name, args)` checks the arguments the same way when `name` is one of the generated `SolariToolName` values. Any other name — for example the per-account `solari_apps_*` tools — is accepted with free-form arguments, and `solari.dynamic.<any>.<path>(args)` spells such a call as a path without type checking.
+
 ## API
 
 - `new Solari({ token?, baseUrl?, fetch?, timeoutMs?, userAgent? })` — `baseUrl` defaults to `https://solari.sh`; `fetch` lets you inject a custom implementation.
+- `solari.tools.<family>.<platform>.<group>.<name>(args)` — typed tool calls; segments mirror the `solari_` tool names.
+- `solari.call<T>(name, args)` — run a tool by name and get its JSON payload back.
 - `solari.listTools()` — every tool the signed-in account can call, with its JSON input schema.
 - `solari.getTool(name)` — one tool.
-- `solari.call(name, args)` — run a tool and get its JSON payload back. Typed as `call<T>()`.
-- `solari.tools.<family>.<platform>.<group>.<name>(args)` — the same call spelled as a path; segments join with `_` under the `solari_` prefix. The path is dynamic, so it is not type-checked against the live tool list.
 - `solari.me()` — the identity behind the token.
+- `solari.dynamic` — untyped path proxy for tools that are not in the generated catalog.
+- `SOLARI_TOOL_NAMES`, `SolariToolName`, `SolariToolMap`, `SolariTools`, `<Tool>Args` — the generated types.
 
 Errors throw `SolariError` with `status`, `code`, `message`, `tool`, `retryAfterSeconds`, and a `retryable` flag (429, 502, 503, 504). Codes come straight from the API: `invalid_arguments`, `tool_not_found`, `rate_limited`, `forbidden`, `upstream_timeout`, `app_warming_up`, ...
 
@@ -35,6 +51,9 @@ Errors throw `SolariError` with `status`, `code`, `message`, `tool`, `retryAfter
 
 ```
 bun install
+bun run typecheck
 bun test
 bun run build
 ```
+
+`src/tools.generated.ts` is produced from the MCP worker's tool registry by `pnpm run sdk:generate` in `cf-workers/solari-mcp`; CI fails when it is stale.

package/dist/index.d.ts

@@ -1,6 +1,8 @@
+import type { SolariToolMap, SolariToolName, SolariTools, SolariToolsWithoutRequiredArgs } from "./tools.generated";
+export * from "./tools.generated";
 export declare const DEFAULT_BASE_URL = "https://solari.sh";
 export declare const API_PREFIX = "/mcp/api/v1";
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.2.0";
 export declare const TOKEN_ENV = "SOLARI_TOKEN";
 export interface SolariTool {
     name: string;
@@ -30,6 +32,7 @@ export interface ToolPath {
     (args?: ToolArguments): Promise<unknown>;
     [segment: string]: ToolPath;
 }
+export type ToolCallArguments<N extends string> = N extends SolariToolName ? N extends keyof SolariToolsWithoutRequiredArgs ? [args?: SolariToolMap[N]] : [args: SolariToolMap[N]] : [args?: ToolArguments];
 export declare class SolariError extends Error {
     readonly status: number;
     readonly code: string;
@@ -48,7 +51,8 @@ export declare function normalizeBaseUrl(raw: string): string;
 export declare function toolName(segments: readonly string[]): string;
 export declare class Solari {
     readonly baseUrl: string;
-    readonly tools: ToolPath;
+    readonly tools: SolariTools;
+    readonly dynamic: ToolPath;
     private readonly token;
     private readonly fetchImpl;
     private readonly timeoutMs;
@@ -56,7 +60,7 @@ export declare class Solari {
     constructor(options?: SolariOptions);
     listTools(): Promise<SolariTool[]>;
     getTool(name: string): Promise<SolariTool>;
-    call<T = unknown>(name: string, args?: ToolArguments): Promise<T>;
+    call<T = unknown, N extends string = string>(name: N, ...rest: ToolCallArguments<N>): Promise<T>;
     me(): Promise<SolariIdentity>;
     private toolPath;
     private request;

package/dist/index.js

@@ -1,6 +1,7 @@
+export * from "./tools.generated";
 export const DEFAULT_BASE_URL = "https://solari.sh";
 export const API_PREFIX = "/mcp/api/v1";
-export const SDK_VERSION = "0.1.0";
+export const SDK_VERSION = "0.2.0";
 export const TOKEN_ENV = "SOLARI_TOKEN";
 const DEFAULT_TIMEOUT_MS = 150_000;
 export class SolariError extends Error {
@@ -78,6 +79,7 @@ async function parseErrorBody(response) {
 export class Solari {
     baseUrl;
     tools;
+    dynamic;
     token;
     fetchImpl;
     timeoutMs;
@@ -96,7 +98,8 @@ export class Solari {
         this.fetchImpl = options.fetch ?? globalThis.fetch;
         this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
         this.userAgent = options.userAgent ?? `solari-sdk-ts/${SDK_VERSION}`;
-        this.tools = this.toolPath([]);
+        this.dynamic = this.toolPath([]);
+        this.tools = this.dynamic;
     }
     async listTools() {
         const body = (await this.request("GET", `${API_PREFIX}/tools`));
@@ -105,7 +108,8 @@ export class Solari {
     async getTool(name) {
         return (await this.request("GET", `${API_PREFIX}/tools/${encodeURIComponent(name)}`));
     }
-    async call(name, args = {}) {
+    async call(name, ...rest) {
+        const args = rest[0] ?? {};
         return (await this.request("POST", `${API_PREFIX}/tools/${encodeURIComponent(name)}`, args));
     }
     async me() {

package/dist/tools.generated.d.ts

@@ -0,0 +1,517 @@
+/** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Works with any signed-in SOLARI account. */
+export interface CatalogInstagramAccountPostsArgs {
+    /** account_id of the account (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Posts per page, default 12. Values above 200 are clamped to 200. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+    /** Only posts of this format. reel is short-form single-video; video is non-reel video. */
+    "post_type"?: "reel" | "video" | "photo" | "carousel" | undefined;
+}
+/** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry. Works with any signed-in SOLARI account. */
+export interface CatalogInstagramAccountProfileArgs {
+    /** account_id of the account (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+}
+/** Resolves a brand/creator name or Instagram handle to candidate tracked accounts via fast deterministic index search — like a typeahead, all candidates are returned — and also searches profile bio text. query_type picks what the query is matched against: auto (default) matches handles by prefix and profile display names (Korean or English) by text match; username or full_name narrows to just one of those; bio runs a full-text search over profile bio text, which is how you discover accounts by what they say about themselves ("skincare", "협찬 문의", "コスメ") rather than by name. Ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID every other tool takes), username, full_name, biography, follower_count, region, is_verified, and profile_pic_url; found=false with empty items means nothing matched. In the name modes the query must actually appear in the handle or display name — phonetic aliases and abbreviations do not resolve, so retry with the native spelling (for example the English brand name). Set brands_only=true when resolving a brand name to filter out fan and meme accounts; pair it with query_type=bio to sweep a category of brands. Leave region unset unless the user asked for one country — it drops every account outside that region. Works with any signed-in SOLARI account. Use this first to resolve any entity mentioned by name. */
+export interface CatalogInstagramAccountSearchArgs {
+    /** Brand or creator name (Korean/English) or Instagram handle to resolve, or — with query_type=bio — the words to look for in profile bios. */
+    "query": string;
+    /** Which text to match. auto = handle and display name together; username = handle only; full_name = display name only; bio = profile bio text. */
+    "query_type"?: "auto" | "username" | "full_name" | "bio" | undefined;
+    /** Restrict matches to known brand accounts. Recommended when resolving a brand name. */
+    "brands_only"?: boolean | undefined;
+    /** Maximum candidates to return, default 8. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+    /** Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: it filters results to that region and drops the rest. */
+    "region"?: string | undefined;
+}
+/** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Works with any signed-in SOLARI account. */
+export interface CatalogInstagramContentBatchArgs {
+    /** SOLARI post UUIDs to hydrate, at most 100 per call. Not Instagram shortcodes/slugs. */
+    "post_ids": Array<string>;
+    /** Item order: posted_at descending (recent) or like+comment engagement descending. */
+    "sort"?: "recent" | "engagement" | undefined;
+}
+/** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+export interface CatalogInstagramContentDetailArgs {
+    /** The SOLARI post_id UUID. Provide this, slug, or url. */
+    "post_id"?: string | undefined;
+    /** Public Instagram shortcode, the segment after /p/, /reel/, or /tv/ in a post URL. Ignored when post_id is set. */
+    "slug"?: string | undefined;
+    /** Public Instagram post URL such as https://www.instagram.com/p/<shortcode>/ or .../reel/<shortcode>/. Ignored when post_id or slug is set. */
+    "url"?: string | undefined;
+}
+/** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+export interface CatalogInstagramContentSearchArgs {
+    /** Free-text keyword query matched against captions, creator bios, and video transcriptions. */
+    "query": string;
+    /** Region to search. Only these four regions are indexed. */
+    "region"?: "KR" | "JP" | "US" | "TW" | undefined;
+    /** Maximum hits, default 20. Values above 100 are clamped to 100. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. Data older than ~6 months is not indexed. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+}
+/** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Works with any signed-in SOLARI account. */
+export interface CatalogInstagramTagSearchArgs {
+    /** One exact tag. '#ootd' or 'ootd' searches a hashtag; '@oliveyoung_official' searches mentions of that account. No spaces, no wildcards. */
+    "query": string;
+    /** Posts per page, default 20. Values above 1000 are clamped to 1000. Larger pages cost no more than smaller ones. */
+    "limit"?: number | undefined;
+    /** next_cursor from the previous response. Omit for the first page. */
+    "cursor"?: string | undefined;
+}
+/** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Works with any signed-in SOLARI account. */
+export interface CatalogTiktokAccountPostsArgs {
+    /** account_id of the TikTok account (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** TikTok handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Posts per page, default 12. Values above 200 are clamped to 200. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+    /** Only posts of this format. video is a single clip; carousel is an image slideshow. */
+    "post_type"?: "video" | "carousel" | undefined;
+    /** Attach the spoken-word transcript to each item. Off by default because transcripts are long. */
+    "include_transcript"?: boolean | undefined;
+}
+/** Full SOLARI catalog profile for one collected TikTok account: username (the handle), nickname, bio, follower/following/like/video counts, region, verified/private/commerce flags, profile_url, plus embedded previews of recent posts (recent_posts). Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_tiktok_account with that username first, then retry. Works with any signed-in SOLARI account. */
+export interface CatalogTiktokAccountProfileArgs {
+    /** account_id of the TikTok account (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** TikTok handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+}
+/** Resolves a brand/creator name or TikTok handle to candidate tracked TikTok accounts via fast deterministic index search, typeahead-style: matches handles by prefix and display nicknames by text match, ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID the other solari_catalog_tiktok_* tools take; a TikTok account_id is a different value from any Instagram account_id and the two are never interchangeable), username (the TikTok handle), nickname, follower_count, video_count, region, is_verified, is_private, is_commerce_user, commerce_user_category, and profile_url; found=false with empty items means nothing matched. The query must actually appear in the handle or nickname, so retry with the native spelling when a phonetic alias does not resolve. Leave region unset unless the user asked for one country: many tracked TikTok accounts carry no region, and a region filter drops them. A handle that is not tracked yet does not appear here; pass an exact handle to solari_fetch_tiktok_account, then read it with the catalog profile tool. Works with any signed-in SOLARI account. */
+export interface CatalogTiktokAccountSearchArgs {
+    /** Brand or creator name or TikTok handle to resolve. */
+    "query": string;
+    /** Maximum candidates to return, default 8. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+    /** Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: accounts with no known region are dropped when a region is set. */
+    "region"?: string | undefined;
+}
+/** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Works with any signed-in SOLARI account. */
+export interface CatalogTiktokContentBatchArgs {
+    /** SOLARI post UUIDs to hydrate, at most 100 per call. Not TikTok video ids. */
+    "post_ids": Array<string>;
+    /** Item order: posted_at descending (recent) or engagement descending. */
+    "sort"?: "recent" | "engagement" | undefined;
+    /** Attach the spoken-word transcript to each item. Off by default because transcripts are long. */
+    "include_transcript"?: boolean | undefined;
+}
+/** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+export interface CatalogTiktokContentDetailArgs {
+    /** The SOLARI post_id UUID. Provide this, video_id, or url. */
+    "post_id"?: string | undefined;
+    /** Public numeric TikTok video id, the digits after /video/ or /photo/ in a post URL. Ignored when post_id is set. */
+    "video_id"?: string | undefined;
+    /** Public TikTok post URL such as https://www.tiktok.com/@<handle>/video/<id> or a vm.tiktok.com / vt.tiktok.com short link. Ignored when post_id or video_id is set. */
+    "url"?: string | undefined;
+}
+/** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+export interface CatalogTiktokContentSearchArgs {
+    /** Free-text keyword query matched against captions and video transcripts. */
+    "query": string;
+    /** Region to search. Only these four regions are indexed. */
+    "region"?: "KR" | "JP" | "US" | "TW" | undefined;
+    /** Maximum hits, default 20. Values above 100 are clamped to 100. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. Values above 9800 are clamped to 9800. */
+    "offset"?: number | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. Data older than ~6 months is not indexed. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+}
+/** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
+export interface FetchInstagramAccountArgs {
+    /** Instagram handle, with or without a leading @. */
+    "username": string;
+}
+/** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+export interface FetchInstagramPostsArgs {
+    /** Instagram handle, with or without a leading @. */
+    "username": string;
+}
+/** Adds one TikTok account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_tiktok_account_search to resolve a name, then solari_catalog_tiktok_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds; only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+export interface FetchTiktokAccountArgs {
+    /** TikTok handle, with or without a leading @. */
+    "username": string;
+}
+/** Collects posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_tiktok_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+export interface FetchTiktokPostsArgs {
+    /** TikTok handle, with or without a leading @. */
+    "username": string;
+}
+/** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+export interface InsightInstagramAccountAdPostsArgs {
+    /** account_id of the creator (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Lookback window in months, default 3. Values above 24 are clamped to 24. */
+    "months"?: number | undefined;
+    /** Items per page, default 50. Values above 200 are clamped to 200. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+    /** Optional target-brand filter: its account_id (SOLARI account UUID) or Instagram handle. */
+    "target"?: string | undefined;
+}
+/** Recent ad collaborations produced by one creator within a month window. Each item is a target brand (target_account_id, target_username) with collab_count, last_posted_at, and a sample collaboration post. Returns items, has_more, and total; page with limit/offset. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Mirror view of solari_insight_instagram_brand_top_collaborators, which starts from the brand instead. Works with any signed-in SOLARI account. */
+export interface InsightInstagramAccountCollabsArgs {
+    /** account_id of the creator (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Lookback window in months, default 3. Values above 12 are clamped to 12. */
+    "months"?: number | undefined;
+    /** Maximum items per page, default 5. Values above 200 are clamped to 200. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+}
+/** Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. */
+export interface InsightInstagramAccountSimilarArgs {
+    /** Instagram handle to find similar accounts for, without the leading @. */
+    "username": string;
+    /** Number of similar accounts to return, default 50. Values above 100 are clamped to 100. */
+    "limit"?: number | undefined;
+}
+/** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+export interface InsightInstagramBrandAdPostsArgs {
+    /** Brand Instagram handle without the leading @. */
+    "username": string;
+    /** recent pages the full window with an exact total; engagement ranks within ranking_window. */
+    "sort"?: "recent" | "engagement" | undefined;
+    /** Lookback window in months, default 3. Values above 24 are clamped to 24. */
+    "months"?: number | undefined;
+    /** Posts per page, default 50. Values above 200 are clamped to 200. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+}
+/** Exact sponsored-post and collaborating-creator counts for a brand's recent window, plus a bounded play-count sum. Use this for accurate ad-volume figures since solari_insight_instagram_brand_overview ID lists are capped; for the underlying row-level posts use solari_insight_instagram_brand_ad_posts. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. */
+export interface InsightInstagramBrandAdStatsArgs {
+    /** Brand Instagram handle without the leading @. */
+    "username": string;
+}
+/** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+export interface InsightInstagramBrandCollaboratorPostsArgs {
+    /** Brand account_id (SOLARI account UUID). Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Brand Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Creator account_ids (SOLARI account UUIDs) to hydrate, at most 100 per call. */
+    "account_ids": Array<string>;
+}
+/** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+export interface InsightInstagramBrandLookalikeContentArgs {
+    /** Brand account_id (SOLARI account UUID) whose sponsored ads seed the lookalike search. Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Brand Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Maximum lookalike posts returned, default 30. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+    /** Region code such as KR, JP, or US scoping the search. */
+    "region"?: string | undefined;
+}
+/** Returns a brand's profile plus its ad-collaboration footprint: creator IDs who produced ad posts targeting the brand and the ad post IDs themselves (previewed to the first 20 with total counts; set full=true to receive the complete lists, up to 100 each). Feed the post IDs into solari_catalog_instagram_content_batch to hydrate them. Takes the brand's Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+export interface InsightInstagramBrandOverviewArgs {
+    /** Brand Instagram handle without the leading @. */
+    "username": string;
+    /** Return the complete ID lists instead of the first-20 preview. */
+    "full"?: boolean | undefined;
+}
+/** Ranked list of creators who authored resolved ad posts targeting the brand, ordered by collaboration count. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Retrospective collaboration history, not a forward-looking fit score. Works with any signed-in SOLARI account. */
+export interface InsightInstagramBrandTopCollaboratorsArgs {
+    /** Brand account_id (SOLARI account UUID) from solari_catalog_instagram_account_search. Provide this or username. */
+    "account_id"?: string | undefined;
+    /** Brand Instagram handle, with or without a leading @. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Ad-post promotion filter: all rows, promotion=true rows, or promotion=false rows. */
+    "promotion"?: "all" | "true_only" | "false_only" | undefined;
+    /** Maximum creators returned, default 20. Values above 1000 are clamped to 1000. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+}
+/** Counts and engagement rollups over tracked posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average likes by format. Group by account, post_type, hashtag, mention, caption_keyword, or transcription_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view sums and averages, mean follower count, and distinct account counts. Narrow the set with a free-text query, usernames, hashtags, mentions, or post_types. Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months — a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_instagram_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
+export interface InsightInstagramContentAggregateArgs {
+    /** Region to aggregate. Only these four regions are indexed. */
+    "region"?: "KR" | "JP" | "US" | "TW" | undefined;
+    /** Dimension to group by. Omit to aggregate the whole filtered set into a single total bucket. */
+    "group_by"?: "account" | "post_type" | "hashtag" | "mention" | "caption_keyword" | "transcription_keyword" | undefined;
+    /** Calendar interval to split by. Alone it returns one bucket per period; combined with group_by each group carries a series. */
+    "interval"?: "day" | "week" | "month" | undefined;
+    /** Extra metrics beyond post_count, which is always returned. Metric values are snapshots and can lag live counts. */
+    "metrics"?: Array<"like_sum" | "like_avg" | "comment_sum" | "comment_avg" | "view_sum" | "view_avg" | "follower_avg" | "account_count"> | undefined;
+    /** Free-text filter matched against captions, creator bios, and video transcriptions. */
+    "query"?: string | undefined;
+    /** Restrict to these Instagram handles. */
+    "usernames"?: Array<string> | undefined;
+    /** Restrict to posts carrying every one of these hashtags. */
+    "hashtags"?: Array<string> | undefined;
+    /** Restrict to posts that tag every one of these handles. Pair with group_by=account to rank the accounts tagging a given handle. */
+    "mentions"?: Array<string> | undefined;
+    /** Restrict to these post formats. */
+    "post_types"?: Array<string> | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. Defaults to 183 days ago, which is also the earliest accepted bound. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+    /** Maximum groups returned when group_by is set, default 20. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+}
+/** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Works with any signed-in SOLARI account. */
+export interface InsightInstagramContentRisingArgs {
+    /** Region code such as KR, JP, or US. */
+    "region"?: string | undefined;
+    /** Maximum posts per page, default 20. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+    /** Opaque pagination cursor from the previous response's next_cursor. */
+    "cursor"?: string | undefined;
+    /** Optional brand account_id (SOLARI account UUID) for brand-affinity personalization. */
+    "account_id"?: string | undefined;
+    /** Optional brand Instagram handle for brand-affinity personalization. Ignored when account_id is set. */
+    "username"?: string | undefined;
+}
+/** The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account. */
+export interface InsightInstagramContentTrendClustersArgs {
+    /** Region code such as KR, JP, or US. */
+    "region"?: string | undefined;
+    /** Lookback window in days for trending clusters, between 1 and 90. */
+    "since_days"?: number | undefined;
+    /** Maximum trend clusters returned, default 20. Values above 24 are clamped to 24. */
+    "limit"?: number | undefined;
+    /** Optional brand account_id (SOLARI account UUID) for brand-affinity reranking. */
+    "account_id"?: string | undefined;
+    /** Optional brand Instagram handle for brand-affinity reranking. Ignored when account_id is set. */
+    "username"?: string | undefined;
+    /** Rerank clusters by brand affinity when account_id is provided. */
+    "brand_aware"?: boolean | undefined;
+}
+/** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+export interface InsightInstagramContentTrendingArgs {
+    /** Region code such as KR, JP, or US. */
+    "region"?: string | undefined;
+    /** Maximum posts per page, default 20. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+    /** Opaque pagination cursor from the previous response's next_cursor. */
+    "cursor"?: string | undefined;
+    /** Optional brand account_id (SOLARI account UUID) for brand-affinity personalization. */
+    "account_id"?: string | undefined;
+    /** Optional brand Instagram handle for brand-affinity personalization. Ignored when account_id is set. */
+    "username"?: string | undefined;
+}
+/** Counts and engagement rollups over tracked TikTok posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average plays by format. Group by account, post_type, hashtag, mention, or caption_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view/share/collect sums and averages (the view_* metrics count plays), mean follower count, and distinct account counts. Narrow the set with a free-text query (captions and video transcripts), usernames, hashtags, mentions, or post_types (video, carousel). Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months; a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_tiktok_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
+export interface InsightTiktokContentAggregateArgs {
+    /** Region to aggregate. Only these four regions are indexed. */
+    "region"?: "KR" | "JP" | "US" | "TW" | undefined;
+    /** Dimension to group by. Omit to aggregate the whole filtered set into a single total bucket. */
+    "group_by"?: "account" | "post_type" | "hashtag" | "mention" | "caption_keyword" | undefined;
+    /** Calendar interval to split by. Alone it returns one bucket per period; combined with group_by each group carries a series. */
+    "interval"?: "day" | "week" | "month" | undefined;
+    /** Extra metrics beyond post_count, which is always returned. view_* metrics count plays. Metric values are snapshots and can lag live counts. */
+    "metrics"?: Array<"like_sum" | "like_avg" | "comment_sum" | "comment_avg" | "view_sum" | "view_avg" | "share_sum" | "share_avg" | "collect_sum" | "collect_avg" | "follower_avg" | "account_count"> | undefined;
+    /** Free-text filter matched against captions and video transcripts. */
+    "query"?: string | undefined;
+    /** Restrict to these TikTok handles. */
+    "usernames"?: Array<string> | undefined;
+    /** Restrict to posts carrying every one of these hashtags. */
+    "hashtags"?: Array<string> | undefined;
+    /** Restrict to posts that tag every one of these handles. Pair with group_by=account to rank the accounts tagging a given handle. */
+    "mentions"?: Array<string> | undefined;
+    /** Restrict to these post formats. */
+    "post_types"?: Array<"video" | "carousel"> | undefined;
+    /** Only posts on or after this UTC date, YYYY-MM-DD inclusive. Defaults to 183 days ago, which is also the earliest accepted bound. */
+    "since"?: string | undefined;
+    /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
+    "until"?: string | undefined;
+    /** Maximum groups returned when group_by is set, default 20. Values above 50 are clamped to 50. */
+    "limit"?: number | undefined;
+}
+export interface SolariToolMap {
+    "solari_catalog_instagram_account_posts": CatalogInstagramAccountPostsArgs;
+    "solari_catalog_instagram_account_profile": CatalogInstagramAccountProfileArgs;
+    "solari_catalog_instagram_account_search": CatalogInstagramAccountSearchArgs;
+    "solari_catalog_instagram_content_batch": CatalogInstagramContentBatchArgs;
+    "solari_catalog_instagram_content_detail": CatalogInstagramContentDetailArgs;
+    "solari_catalog_instagram_content_search": CatalogInstagramContentSearchArgs;
+    "solari_catalog_instagram_tag_search": CatalogInstagramTagSearchArgs;
+    "solari_catalog_tiktok_account_posts": CatalogTiktokAccountPostsArgs;
+    "solari_catalog_tiktok_account_profile": CatalogTiktokAccountProfileArgs;
+    "solari_catalog_tiktok_account_search": CatalogTiktokAccountSearchArgs;
+    "solari_catalog_tiktok_content_batch": CatalogTiktokContentBatchArgs;
+    "solari_catalog_tiktok_content_detail": CatalogTiktokContentDetailArgs;
+    "solari_catalog_tiktok_content_search": CatalogTiktokContentSearchArgs;
+    "solari_fetch_instagram_account": FetchInstagramAccountArgs;
+    "solari_fetch_instagram_posts": FetchInstagramPostsArgs;
+    "solari_fetch_tiktok_account": FetchTiktokAccountArgs;
+    "solari_fetch_tiktok_posts": FetchTiktokPostsArgs;
+    "solari_insight_instagram_account_ad_posts": InsightInstagramAccountAdPostsArgs;
+    "solari_insight_instagram_account_collabs": InsightInstagramAccountCollabsArgs;
+    "solari_insight_instagram_account_similar": InsightInstagramAccountSimilarArgs;
+    "solari_insight_instagram_brand_ad_posts": InsightInstagramBrandAdPostsArgs;
+    "solari_insight_instagram_brand_ad_stats": InsightInstagramBrandAdStatsArgs;
+    "solari_insight_instagram_brand_collaborator_posts": InsightInstagramBrandCollaboratorPostsArgs;
+    "solari_insight_instagram_brand_lookalike_content": InsightInstagramBrandLookalikeContentArgs;
+    "solari_insight_instagram_brand_overview": InsightInstagramBrandOverviewArgs;
+    "solari_insight_instagram_brand_top_collaborators": InsightInstagramBrandTopCollaboratorsArgs;
+    "solari_insight_instagram_content_aggregate": InsightInstagramContentAggregateArgs;
+    "solari_insight_instagram_content_rising": InsightInstagramContentRisingArgs;
+    "solari_insight_instagram_content_trend_clusters": InsightInstagramContentTrendClustersArgs;
+    "solari_insight_instagram_content_trending": InsightInstagramContentTrendingArgs;
+    "solari_insight_tiktok_content_aggregate": InsightTiktokContentAggregateArgs;
+}
+export type SolariToolName = keyof SolariToolMap;
+export declare const SOLARI_TOOL_NAMES: readonly SolariToolName[];
+export type SolariToolsWithoutRequiredArgs = {
+    "solari_catalog_instagram_account_posts": true;
+    "solari_catalog_instagram_account_profile": true;
+    "solari_catalog_instagram_content_detail": true;
+    "solari_catalog_tiktok_account_posts": true;
+    "solari_catalog_tiktok_account_profile": true;
+    "solari_catalog_tiktok_content_detail": true;
+    "solari_insight_instagram_account_ad_posts": true;
+    "solari_insight_instagram_account_collabs": true;
+    "solari_insight_instagram_brand_lookalike_content": true;
+    "solari_insight_instagram_brand_top_collaborators": true;
+    "solari_insight_instagram_content_aggregate": true;
+    "solari_insight_instagram_content_rising": true;
+    "solari_insight_instagram_content_trend_clusters": true;
+    "solari_insight_instagram_content_trending": true;
+    "solari_insight_tiktok_content_aggregate": true;
+};
+export interface SolariTools {
+    catalog: {
+        instagram: {
+            account: {
+                /** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Works with any signed-in SOLARI account. */
+                posts<T = unknown>(args?: CatalogInstagramAccountPostsArgs): Promise<T>;
+                /** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry. Works with any signed-in SOLARI account. */
+                profile<T = unknown>(args?: CatalogInstagramAccountProfileArgs): Promise<T>;
+                /** Resolves a brand/creator name or Instagram handle to candidate tracked accounts via fast deterministic index search — like a typeahead, all candidates are returned — and also searches profile bio text. query_type picks what the query is matched against: auto (default) matches handles by prefix and profile display names (Korean or English) by text match; username or full_name narrows to just one of those; bio runs a full-text search over profile bio text, which is how you discover accounts by what they say about themselves ("skincare", "협찬 문의", "コスメ") rather than by name. Ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID every other tool takes), username, full_name, biography, follower_count, region, is_verified, and profile_pic_url; found=false with empty items means nothing matched. In the name modes the query must actually appear in the handle or display name — phonetic aliases and abbreviations do not resolve, so retry with the native spelling (for example the English brand name). Set brands_only=true when resolving a brand name to filter out fan and meme accounts; pair it with query_type=bio to sweep a category of brands. Leave region unset unless the user asked for one country — it drops every account outside that region. Works with any signed-in SOLARI account. Use this first to resolve any entity mentioned by name. */
+                search<T = unknown>(args: CatalogInstagramAccountSearchArgs): Promise<T>;
+            };
+            content: {
+                /** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Works with any signed-in SOLARI account. */
+                batch<T = unknown>(args: CatalogInstagramContentBatchArgs): Promise<T>;
+                /** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+                detail<T = unknown>(args?: CatalogInstagramContentDetailArgs): Promise<T>;
+                /** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: CatalogInstagramContentSearchArgs): Promise<T>;
+            };
+            tag: {
+                /** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: CatalogInstagramTagSearchArgs): Promise<T>;
+            };
+        };
+        tiktok: {
+            account: {
+                /** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Works with any signed-in SOLARI account. */
+                posts<T = unknown>(args?: CatalogTiktokAccountPostsArgs): Promise<T>;
+                /** Full SOLARI catalog profile for one collected TikTok account: username (the handle), nickname, bio, follower/following/like/video counts, region, verified/private/commerce flags, profile_url, plus embedded previews of recent posts (recent_posts). Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_tiktok_account with that username first, then retry. Works with any signed-in SOLARI account. */
+                profile<T = unknown>(args?: CatalogTiktokAccountProfileArgs): Promise<T>;
+                /** Resolves a brand/creator name or TikTok handle to candidate tracked TikTok accounts via fast deterministic index search, typeahead-style: matches handles by prefix and display nicknames by text match, ranked by match quality and follower count. Returns found plus items ordered best-first (items[0] is the top match), each with account_id (the SOLARI account UUID the other solari_catalog_tiktok_* tools take; a TikTok account_id is a different value from any Instagram account_id and the two are never interchangeable), username (the TikTok handle), nickname, follower_count, video_count, region, is_verified, is_private, is_commerce_user, commerce_user_category, and profile_url; found=false with empty items means nothing matched. The query must actually appear in the handle or nickname, so retry with the native spelling when a phonetic alias does not resolve. Leave region unset unless the user asked for one country: many tracked TikTok accounts carry no region, and a region filter drops them. A handle that is not tracked yet does not appear here; pass an exact handle to solari_fetch_tiktok_account, then read it with the catalog profile tool. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: CatalogTiktokAccountSearchArgs): Promise<T>;
+            };
+            content: {
+                /** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Works with any signed-in SOLARI account. */
+                batch<T = unknown>(args: CatalogTiktokContentBatchArgs): Promise<T>;
+                /** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+                detail<T = unknown>(args?: CatalogTiktokContentDetailArgs): Promise<T>;
+                /** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: CatalogTiktokContentSearchArgs): Promise<T>;
+            };
+        };
+    };
+    fetch: {
+        instagram: {
+            /** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
+            account<T = unknown>(args: FetchInstagramAccountArgs): Promise<T>;
+            /** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+            posts<T = unknown>(args: FetchInstagramPostsArgs): Promise<T>;
+        };
+        tiktok: {
+            /** Adds one TikTok account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_tiktok_account_search to resolve a name, then solari_catalog_tiktok_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds; only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+            account<T = unknown>(args: FetchTiktokAccountArgs): Promise<T>;
+            /** Collects posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_tiktok_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+            posts<T = unknown>(args: FetchTiktokPostsArgs): Promise<T>;
+        };
+    };
+    insight: {
+        instagram: {
+            account: {
+                ad: {
+                    /** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    posts<T = unknown>(args?: InsightInstagramAccountAdPostsArgs): Promise<T>;
+                };
+                /** Recent ad collaborations produced by one creator within a month window. Each item is a target brand (target_account_id, target_username) with collab_count, last_posted_at, and a sample collaboration post. Returns items, has_more, and total; page with limit/offset. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Mirror view of solari_insight_instagram_brand_top_collaborators, which starts from the brand instead. Works with any signed-in SOLARI account. */
+                collabs<T = unknown>(args?: InsightInstagramAccountCollabsArgs): Promise<T>;
+                /** Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. */
+                similar<T = unknown>(args: InsightInstagramAccountSimilarArgs): Promise<T>;
+            };
+            brand: {
+                ad: {
+                    /** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+                    posts<T = unknown>(args: InsightInstagramBrandAdPostsArgs): Promise<T>;
+                    /** Exact sponsored-post and collaborating-creator counts for a brand's recent window, plus a bounded play-count sum. Use this for accurate ad-volume figures since solari_insight_instagram_brand_overview ID lists are capped; for the underlying row-level posts use solari_insight_instagram_brand_ad_posts. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. */
+                    stats<T = unknown>(args: InsightInstagramBrandAdStatsArgs): Promise<T>;
+                };
+                collaborator: {
+                    /** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    posts<T = unknown>(args: InsightInstagramBrandCollaboratorPostsArgs): Promise<T>;
+                };
+                lookalike: {
+                    /** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    content<T = unknown>(args?: InsightInstagramBrandLookalikeContentArgs): Promise<T>;
+                };
+                /** Returns a brand's profile plus its ad-collaboration footprint: creator IDs who produced ad posts targeting the brand and the ad post IDs themselves (previewed to the first 20 with total counts; set full=true to receive the complete lists, up to 100 each). Feed the post IDs into solari_catalog_instagram_content_batch to hydrate them. Takes the brand's Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+                overview<T = unknown>(args: InsightInstagramBrandOverviewArgs): Promise<T>;
+                top: {
+                    /** Ranked list of creators who authored resolved ad posts targeting the brand, ordered by collaboration count. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Retrospective collaboration history, not a forward-looking fit score. Works with any signed-in SOLARI account. */
+                    collaborators<T = unknown>(args?: InsightInstagramBrandTopCollaboratorsArgs): Promise<T>;
+                };
+            };
+            content: {
+                /** Counts and engagement rollups over tracked posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average likes by format. Group by account, post_type, hashtag, mention, caption_keyword, or transcription_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view sums and averages, mean follower count, and distinct account counts. Narrow the set with a free-text query, usernames, hashtags, mentions, or post_types. Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months — a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_instagram_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
+                aggregate<T = unknown>(args?: InsightInstagramContentAggregateArgs): Promise<T>;
+                /** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Works with any signed-in SOLARI account. */
+                rising<T = unknown>(args?: InsightInstagramContentRisingArgs): Promise<T>;
+                trend: {
+                    /** The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account. */
+                    clusters<T = unknown>(args?: InsightInstagramContentTrendClustersArgs): Promise<T>;
+                };
+                /** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+                trending<T = unknown>(args?: InsightInstagramContentTrendingArgs): Promise<T>;
+            };
+        };
+        tiktok: {
+            content: {
+                /** Counts and engagement rollups over tracked TikTok posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average plays by format. Group by account, post_type, hashtag, mention, or caption_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view/share/collect sums and averages (the view_* metrics count plays), mean follower count, and distinct account counts. Narrow the set with a free-text query (captions and video transcripts), usernames, hashtags, mentions, or post_types (video, carousel). Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months; a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_tiktok_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
+                aggregate<T = unknown>(args?: InsightTiktokContentAggregateArgs): Promise<T>;
+            };
+        };
+    };
+}

package/dist/tools.generated.js

@@ -0,0 +1,34 @@
+// AUTO-GENERATED by cf-workers/solari-mcp/scripts/generate-sdk-tools.ts from the SOLARI MCP tool registry. Do not edit by hand; run `pnpm run sdk:generate` in cf-workers/solari-mcp.
+export const SOLARI_TOOL_NAMES = [
+    "solari_catalog_instagram_account_posts",
+    "solari_catalog_instagram_account_profile",
+    "solari_catalog_instagram_account_search",
+    "solari_catalog_instagram_content_batch",
+    "solari_catalog_instagram_content_detail",
+    "solari_catalog_instagram_content_search",
+    "solari_catalog_instagram_tag_search",
+    "solari_catalog_tiktok_account_posts",
+    "solari_catalog_tiktok_account_profile",
+    "solari_catalog_tiktok_account_search",
+    "solari_catalog_tiktok_content_batch",
+    "solari_catalog_tiktok_content_detail",
+    "solari_catalog_tiktok_content_search",
+    "solari_fetch_instagram_account",
+    "solari_fetch_instagram_posts",
+    "solari_fetch_tiktok_account",
+    "solari_fetch_tiktok_posts",
+    "solari_insight_instagram_account_ad_posts",
+    "solari_insight_instagram_account_collabs",
+    "solari_insight_instagram_account_similar",
+    "solari_insight_instagram_brand_ad_posts",
+    "solari_insight_instagram_brand_ad_stats",
+    "solari_insight_instagram_brand_collaborator_posts",
+    "solari_insight_instagram_brand_lookalike_content",
+    "solari_insight_instagram_brand_overview",
+    "solari_insight_instagram_brand_top_collaborators",
+    "solari_insight_instagram_content_aggregate",
+    "solari_insight_instagram_content_rising",
+    "solari_insight_instagram_content_trend_clusters",
+    "solari_insight_instagram_content_trending",
+    "solari_insight_tiktok_content_aggregate",
+];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brandazine/solari-sdk",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "TypeScript client for the SOLARI API — creator and brand intelligence across Instagram and TikTok.",
 	"license": "MIT",
 	"homepage": "https://solari.sh/api",