@springbrand/cli 0.1.1 → 0.1.2-alpha.1

package/dist/lib/uninstall.js

@@ -0,0 +1,72 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { clearApiKeyFromEnvironment, clearConfig, configFile, resolveProfilePath } from './auth.js';
+import { clearSkillLockEntry } from './skill-vendor.js';
+import { skillLockPath, skillTargetDir } from './skill-paths.js';
+const SKILL_AGENTS = ['claude-code', 'codex', 'command-code', 'cursor', 'hermes-agent', 'opencode', 'pi'];
+export function uninstallPlan() {
+    return {
+        skillDirs: [...new Set(SKILL_AGENTS.map(skillTargetDir))],
+        skillLock: skillLockPath(),
+        config: configFile(),
+        profile: resolveProfilePath(path.basename(process.env['SHELL'] ?? ''), process.platform),
+        cliPackage: '@springbrand/cli',
+    };
+}
+function backupRoot() {
+    return path.join(os.homedir(), '.springbrand', 'uninstall-backups', String(Date.now()));
+}
+/** Move exact SpringBrand skill directories aside so an uninstall remains recoverable. */
+export function applySkillRemoval(skillDirs, root = backupRoot()) {
+    const existing = skillDirs.filter((dir) => fs.existsSync(dir));
+    if (existing.length === 0)
+        return { moved: [] };
+    fs.mkdirSync(root, { recursive: true, mode: 0o700 });
+    const moved = [];
+    for (const dir of existing) {
+        const relative = path.relative(os.homedir(), dir);
+        const backupName = relative.split(path.sep).map((part) => part === '..' ? 'up' : part).join('-').replace(/[^A-Za-z0-9._-]/g, '_');
+        const destination = path.join(root, backupName);
+        fs.mkdirSync(path.dirname(destination), { recursive: true, mode: 0o700 });
+        fs.renameSync(dir, destination);
+        moved.push(dir);
+    }
+    return { moved, backupRoot: root };
+}
+export function removeLocalState() {
+    return {
+        configRemoved: clearConfig(),
+        profile: clearApiKeyFromEnvironment(),
+    };
+}
+export function clearSkillLock() {
+    clearSkillLockEntry({ verbose: true });
+}
+export function hasLocalCredential() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(configFile(), 'utf8'));
+        return typeof parsed.api_key === 'string' && parsed.api_key.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function hasSkill(dir) {
+    try {
+        return fs.lstatSync(dir).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function hasSkillLockEntry() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(skillLockPath(), 'utf8'));
+        return Boolean(parsed.skills && Object.hasOwn(parsed.skills, 'use-springbrand'));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/lib/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/lib/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/lib/workbuddy-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbuddy-config.d.ts","sourceRoot":"","sources":["../../src/lib/workbuddy-config.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAYnF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,6BAA6B,IAAI,kBAAkB,CAElE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}
+{"version":3,"file":"workbuddy-config.d.ts","sourceRoot":"","sources":["../../src/lib/workbuddy-config.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAanF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,6BAA6B,IAAI,kBAAkB,CAElE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAE3F;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/dist/lib/workbuddy-config.js

@@ -2,6 +2,7 @@
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { planWrite, readSpringbrandEntry, removeServer, writeMcpConfig } from './mcp-json-config.js';
+import { mcpServerName } from './mcp-endpoint.js';
 const WORKBUDDY_TARGET = {
     serverKey: 'springbrand',
     dir: () => path.join(os.homedir(), '.workbuddy-ai'),
@@ -18,7 +19,7 @@ export function readWorkbuddySpringbrandEntry() {
     return readSpringbrandEntry(WORKBUDDY_TARGET);
 }
 export function writeWorkbuddyMcpConfig(mcpUrl, apiKey) {
-    return writeMcpConfig(WORKBUDDY_TARGET, mcpUrl, apiKey);
+    return writeMcpConfig({ ...WORKBUDDY_TARGET, serverKey: mcpServerName(mcpUrl) }, mcpUrl, apiKey);
 }
 export function removeWorkbuddyMcpServer() {
     return removeServer(WORKBUDDY_TARGET);

package/dist/lib/workbuddy-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"workbuddy-config.js","sourceRoot":"","sources":["../../src/lib/workbuddy-config.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErG,MAAM,gBAAgB,GAAG;IACrB,SAAS,EAAE,aAAa;IACxB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;IACnD,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,CAAC;IAChE,IAAI,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC5B,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAe;IAC9D,OAAO,SAAS,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B;IACzC,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAAe;IACnE,OAAO,cAAc,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,wBAAwB;IACpC,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"workbuddy-config.js","sourceRoot":"","sources":["../../src/lib/workbuddy-config.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAGhE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,gBAAgB,GAAG;IACrB,SAAS,EAAE,aAAa;IACxB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC;IACnD,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,CAAC;IAChE,IAAI,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC5B,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAe;IAC9D,OAAO,SAAS,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B;IACzC,OAAO,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAAe;IACnE,OAAO,cAAc,CAAC,EAAE,GAAG,gBAAgB,EAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,wBAAwB;IACpC,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/cli",
-  "version": "0.1.1",
+  "version": "0.1.2-alpha.1",
   "description": "SpringBrand CLI — connect MCP hosts to the SpringBrand Gateway",
   "type": "module",
   "bin": {
@@ -9,6 +9,7 @@
   "files": [
     "dist",
     "skill",
+    "assets",
     "README.md"
   ],
   "publishConfig": {

package/skill/springbrand-action-api/SKILL.md

@@ -5,17 +5,32 @@ description: Use SpringBrand Action APIs for available API services and their op
 
 # SpringBrand Action API
 
-Use the unified SpringBrand MCP for SpringBrand-managed API services. The CLI
-has already configured and authenticated the MCP connection. This Skill does
-not manage third-party connections or install a service.
+Use the unified SpringBrand MCP through the generic Tool contract. The CLI has
+already configured and authenticated the MCP connection. Tool-specific
+purpose, usage, prerequisites and follow-up behavior come from the selected
+Tool description. This Skill does not manage third-party connections or
+install a service.
 
 ## Discover and inspect
 
+Ask one focused question only when a missing service, platform, operation,
+object or modality, output, input, time range, or budget decision blocks
+discovery or schema-valid input. Do not ask for a Tool ID or implementation
+name; discover those from the live catalog.
+
 Call `search_tools` once with one concise English query that states the
 intended result, service, important input, and output. Search results are
-bounded; an incomplete result is not proof of absence. Select an Action API
-operation, copy its opaque Tool ID unchanged, and call `get_tool_schemas` for
-its current input and output contract.
+bounded; an incomplete result is not proof of absence. Select an operation,
+copy its opaque Tool ID unchanged, and call `get_tool_schemas` for its current
+description and input/output contract. Use any returned `recommendedPrompt` as
+current Tool guidance; do not replace it with a static catalogue entry.
+
+`get_tool_schemas` returns `{ tools: [...] }`. Each public Tool Contract has
+`toolId`, `name`, `description`, and `inputSchema`, and may include
+`outputSchema`, `summary`, `recommendedPrompt`, `price`, `risk`, `access`,
+`revision`, `notes`, `usage`, `hints`, `billing`, `produces`,
+`attachmentInputFields`, `auth`, and `relatedTools`. Use the current schemas
+and description as the source of truth.
 
 Do not parse a Tool ID to infer a supplier, model, version, or domain. Do not
 execute a result whose described effect belongs to Platform or Connector; use
@@ -28,8 +43,9 @@ charge, reported risk, and any output limitation. Ask for missing business
 values rather than using placeholders. Execute once with schema-valid
 arguments and a stable idempotency key.
 
-Only `succeeded` means complete. If an execution ID is returned, copy it
-exactly and use `get_execution` to read its status or saved result. Running or
+Read the returned Tool description before execution. Only `succeeded` means
+complete. If an execution ID is returned, copy it exactly and use
+`get_execution` to read its status or saved result. Running or
 queued remains in progress. A failed or cancelled result is reported with its
 actual safe reason. `outcome_unknown` means the request may have taken effect:
 never retry or re-execute automatically; verify the external effect using the

package/skill/springbrand-action-api/references/action-discovery.md

@@ -6,27 +6,23 @@ remain authoritative.
 
 ## Build one search
 
-Call `search_tools` with one concise English query. Translate a non-English
+Call `search_tools` once with one concise English query. Translate a non-English
 request yourself and preserve every explicit constraint that distinguishes the
 operation: required supplier, platform or product, operation, object or
 modality, and output type. Keep topic content, dates, formatting preferences,
 and other execution arguments in task state unless they help identify the
 operation.
 
-Use [action-aliases.md](action-aliases.md) only to canonicalize an unambiguous
-concept. Do not invent a supplier, model version, platform, operation, or
-modality. Do not send synonyms as multiple searches.
+The query can search the currently available operations by intended result,
+service or supplier, platform or product, operation, object or modality, and
+required output. It searches the live bounded catalog; it does not search a
+local alias table or require a pre-known Tool ID. Ask one focused question when
+safe refinement lacks one of these decisions; otherwise search immediately.
 
-Examples of useful queries:
-
-- `Xiaohongshu note search`
-- `TikHub Xiaohongshu note search` only when the user explicitly requires
-  TikHub
-- `text to image`
-- `Seedance 2.0 image to video` when both model and modality were explicit
-
-SpringBrand host names, courtesy language, and generic phrases such as "use
-an API" do not distinguish an Action and should not dominate the query.
+Do not invent a supplier, model version, platform, operation, or modality. Do
+not send synonyms as multiple searches. SpringBrand host names, courtesy
+language, and generic phrases such as "use an API" do not distinguish an
+operation and should not dominate the query.
 
 ## Interpret the bounded result
 
@@ -73,10 +69,12 @@ ID unchanged to `get_tool_schemas` and use the returned current contract to
 check:
 
 - the operation description and access state;
+- any current `recommendedPrompt` guidance returned with the Tool;
 - exact input and output schemas;
 - risk and known costs;
 - revision information;
-- attachment and produced-material requirements.
+- attachment and produced-material requirements;
+- the Tool description's own usage instructions.
 
 Never construct, edit, decode, or classify the Tool ID. A contract error is a
 lookup failure, not proof that the Action does not exist. Do not fall through

package/skill/use-springbrand/SKILL.md

@@ -65,6 +65,5 @@ workflow.
 ## Results
 
 Only `succeeded` means an operation completed. A running or queued execution
-remains in progress; use `get_execution` only with the exact returned ID. Keep
-saved image previews and links as returned by the Gateway and do not fetch an
-original file merely to improve presentation.
+remains in progress; use `get_execution` only with the exact returned ID. Use
+the selected Tool description and returned contract to interpret its result.

package/skill/springbrand-action-api/references/action-aliases.md

@@ -1,156 +0,0 @@
-# Action discovery alias map
-
-Use this map when a request names an API service, supplier, platform/product,
-model, object, or operation through an abbreviation, alternative spelling, or
-non-English name. It converts that wording into one catalogue-facing English
-form for the unified `search_tools` query; it does not choose or authorize an
-Action.
-
-Do not invent a supplier, model version, platform, operation, or modality when
-an alias is ambiguous.
-
-## Inventory provenance and maintenance
-
-This snapshot was audited on 2026-09-05 against the then-current Action
-inventory, which contained 52 entries across the ten Supplier ID families
-listed below. It is a terminology aid, not a current availability guarantee.
-
-The mappings below were curated from public catalogue text and common,
-unambiguous names; never claim that the service returned them as alias
-metadata. Never copy an ID from this historical snapshot into contract lookup
-or execution: only a current opaque Tool ID returned by unified discovery is
-usable.
-
-This is a temporary Agent-side discovery aid. Current unified discovery is
-bounded rather than a complete inventory, so update the map only from an
-authoritative catalogue audit outside a user workflow. A later server-side
-discovery improvement should replace the need for this maintained map.
-
-## Inventory coverage
-
-| Supplier ID family | Entries | Public catalogue families reviewed |
-| --- | ---: | --- |
-| `supplier.frank.apify` | 9 | Facebook Ad Library; Reddit scraper and monitor; Google Keyword Volume, Maps Reviews, and Trends; Instagram Profile; TikTok Ads and Data |
-| `supplier.frank.apollo-io` | 2 | Organization Enrichment; People Search |
-| `supplier.frank.elevenlabs` | 1 | Text to Speech |
-| `supplier.frank.exa` | 2 | Web Content Extraction; Web Search |
-| `supplier.frank.firecrawl` | 3 | Structured Data Extraction; Web Scraping; Web Search and Scrape |
-| `supplier.frank.kie-ai-image` | 5 | Seedream 5 Lite image-to-image and text-to-image; Nano Banana 2; GPT Image 2 image-to-image and text-to-image |
-| `supplier.frank.kie-ai-video` | 3 | Seedance 2.0 Fast, Mini, and standard video |
-| `supplier.frank.people-data-labs` | 2 | Company and Person Enrichment |
-| `supplier.frank.serper` | 5 | Google Image, Maps, News, Places, and Shopping Search |
-| `supplier.frank.tikhub` | 20 | Instagram (4); Reddit (2); TikTok (4); X (3); Xiaohongshu (4); YouTube (3) |
-
-## Canonicalization rules
-
-- Match aliases case-insensitively after ordinary Unicode normalization. For short
-  abbreviations such as `X`, `IG`, `TT`, `YT`, `PDL`, `TTS`, `T2I`, and `I2V`,
-  require a whole token and capability-relevant context.
-- Prefer the longest, most specific alias when forms overlap. Preserve explicit
-  model variants such as `Fast` and `Mini`, and preserve every platform,
-  supplier, operation, object, and modality constraint the user actually gave.
-- Preserve canonical phrases such as `Text to Image` and `Image to Video`
-  intact when extracting keywords; `to` defines the modality direction.
-- Emit one canonical English form in the search query. Do not stuff aliases
-  into the query and do not fan out multiple searches.
-- An alias supplies only the concept in its row. A platform alias does not
-  invent an operation or object, and a model-family alias does not invent a
-  version or input modality.
-- Treat the canonicalized concept as a hard compatibility constraint when the
-  user stated it explicitly. Include a supplier in the query only when the
-  user explicitly requires that supplier.
-
-## Service and supplier aliases
-
-Every current entry uses a `supplier.frank.*` Supplier ID. `Frank` alone is
-non-discriminating across the present inventory, so omit it from the search
-query unless the user explicitly makes it a constraint.
-
-| Canonical form | Curated aliases | Current inventory family |
-| --- | --- | --- |
-| `Apify` | — | `supplier.frank.apify` |
-| `Apollo` | `Apollo.io`, `Apollo IO` | `supplier.frank.apollo-io` |
-| `ElevenLabs` | `Eleven Labs`, `11Labs` | `supplier.frank.elevenlabs` |
-| `Exa` | `Exa.ai` | `supplier.frank.exa` |
-| `Firecrawl` | `Fire Crawl` | `supplier.frank.firecrawl` |
-| `Kie.ai` | `Kie AI`, `KIE` | `supplier.frank.kie-ai-image`, `supplier.frank.kie-ai-video` |
-| `People Data Labs` | `PDL`, `PeopleDataLabs`, `People DataLabs` | `supplier.frank.people-data-labs` |
-| `Serper` | `Serper.dev` | `supplier.frank.serper` |
-| `TikHub` | `Tik Hub` | `supplier.frank.tikhub` |
-
-## Platform and product aliases
-
-| Canonical form | Curated aliases | Current inventory scope |
-| --- | --- | --- |
-| `Facebook Ad Library` | `Facebook Ads Library`, `FB Ad Library`, `Meta Ad Library`, `Meta Ads Library`, `脸书广告库` | `action.apify.scrape_facebook_ad_library` |
-| `Reddit` | `红迪` | `action.apify.scrape_reddit__practical-tools-apify`, `action.apify.monitor_reddit_mentions`, `action.tikhub.reddit-*` |
-| `Google Keyword Volume` | `Google Search Volume`, `keyword search volume`, `关键词搜索量` | `action.apify.keyword_volume` |
-| `Google Maps` | `Google Map`, `GMaps`, `谷歌地图` | `action.apify.scrape_google_maps_reviews`, `action.serper.maps` |
-| `Google Trends` | `GTrends`, `谷歌趋势` | `action.apify.scrape_google_trends` |
-| `Instagram` | `IG`, `Insta` | `action.apify.scrape_profiles`, `action.tikhub.instagram-*` |
-| `TikTok Ads Library` | `TikTok Ads`, `TikTok广告库` | `action.apify.scrape_tiktok_ads_library` |
-| `TikTok` | `Tik Tok`, `TT`, `抖音国际版`, `国际版抖音` | `action.apify.tiktok_api`, `action.tikhub.tiktok-*` |
-| `Douyin` | `抖音`, `抖音短视频` | `catalogue-summary-only` |
-| `X` | `Twitter`, `推特`, `X.com`, `X/Twitter` | `action.tikhub.twitter-*` |
-| `Xiaohongshu` | `xhs`, `小红书`, `RedNote`, `Red Note`, `little red book`, `RED` | `action.tikhub.xhs-*` |
-| `YouTube` | `YT`, `You Tube`, `油管` | `action.tikhub.youtube-*` |
-| `Google Image` | `Google Images`, `谷歌图片` | `action.serper.images` |
-| `Google News` | `谷歌新闻` | `action.serper.news` |
-| `Google Places` | `Google Place`, `谷歌地点` | `action.serper.places` |
-| `Google Shopping` | `谷歌购物` | `action.serper.shopping` |
-| `Web` | `website`, `web page`, `网页`, `网站` | `action.exa.*`, `action.firecrawl.*` |
-
-`Douyin` appears in the TikHub catalogue summary, but the audited 52-entry
-inventory has no dedicated Douyin Action. Preserve `Douyin` as the platform
-constraint and, if current discovery finds no compatible entry, report that
-bounded result honestly. Never silently rewrite `Douyin` to `TikTok`.
-Likewise, treat bare `X` as the social platform only when the surrounding
-request refers to posts, profiles, social search, or `X.com`.
-
-## Model and vendor aliases
-
-| Canonical form | Curated aliases | Current inventory scope |
-| --- | --- | --- |
-| `ByteDance` | `Bytedance`, `字节跳动`, `字节` | `action.kie-ai-image.seedream-*`, `action.kie-ai-video.bytedance-*` |
-| `Seedream` | `即梦`, `即梦AI` | `action.kie-ai-image.seedream-5-lite-*` |
-| `Seedream 5 Lite` | `Seedream5 Lite` | `action.kie-ai-image.seedream-5-lite-*` |
-| `Nano Banana 2` | `NanoBanana2`, `Nano Banana` | `action.kie-ai-image.google-nanobanana2` |
-| `OpenAI` | `Open AI` | `action.kie-ai-image.gpt-gpt-image-2-*` |
-| `GPT Image 2` | `GPT-Image-2`, `GPT Image2` | `action.kie-ai-image.gpt-gpt-image-2-*` |
-| `Seedance 2.0` | `Seedance 2`, `Seedance2` | `action.kie-ai-video.bytedance-seedance-2*` |
-
-`Nano Banana` currently resolves to `Nano Banana 2` because it is the only
-Nano Banana family in this inventory snapshot. Re-audit that shorthand as
-soon as another version appears. Bare `Seedream` is a family form; `Seedream
-5 Lite` is the exact current model. Retain every explicit version, `Fast`, or
-`Mini` modifier instead of silently selecting one.
-
-## Object, modality, and operation aliases
-
-| Canonical form | Curated aliases | Current inventory meaning |
-| --- | --- | --- |
-| `Search` | `find`, `look up`, `lookup`, `query`, `搜索`, `查找`, `检索` | Locate existing catalogue data. |
-| `Details` | `detail`, `info`, `information`, `详情`, `详细信息` | Fetch one exact post, note, or video. |
-| `User Profile` | `profile`, `account profile`, `user info`, `账号资料`, `用户资料`, `主页` | Fetch a public account profile. |
-| `User Posts` | `account posts`, `author posts`, `用户帖子`, `账号内容` | List content published by one user. |
-| `Comments` | `comment`, `replies`, `responses`, `评论`, `回复` | Fetch replies on one content item. |
-| `Reviews` | `review`, `ratings`, `评价`, `评分` | Fetch Google Maps reviews. |
-| `Monitor` | `track`, `watch`, `monitoring`, `监控`, `追踪` | Monitor Reddit brand mentions. |
-| `Scrape` | `scraper`, `crawl`, `抓取`, `爬取` | Retrieve public web or social data. |
-| `Extract` | `extraction`, `抽取`, `提取` | Extract web content or structured fields. |
-| `Enrichment` | `enrich`, `data enrichment`, `补全`, `数据补充` | Enrich a person, company, or organization. |
-| `Post` | `posts`, `帖子`, `动态` | A social post; `tweet` and `推文` mean `X Post` only in X/Twitter context. |
-| `Note` | `notes`, `笔记` | A Xiaohongshu content item. |
-| `Video` | `videos`, `短视频` | A TikTok or YouTube video, or generated video. |
-| `Image` | `images`, `picture`, `photo`, `图片`, `图像` | An existing or generated image. |
-| `Text to Speech` | `TTS`, `text2speech`, `txt2speech`, `文本转语音`, `语音合成` | ElevenLabs speech generation. |
-| `Text to Image` | `T2I`, `text2image`, `txt2img`, `文生图`, `文字生成图片` | Generate an image from text. |
-| `Image to Image` | `I2I`, `image2image`, `img2img`, `图生图`, `图片编辑` | Edit or transform an existing image. |
-| `Text to Video` | `T2V`, `text2video`, `txt2vid`, `文生视频`, `文字生成视频` | Generate video with text input. |
-| `Image to Video` | `I2V`, `image2video`, `img2vid`, `图生视频`, `图片生成视频` | Generate video with image input. |
-
-Operation and modality mappings are compatibility constraints, not synonyms
-for one another. `Search` cannot satisfy `Details`; `Comments` cannot satisfy
-`User Posts`; `Text to Image` cannot satisfy `Image to Image`; and `Text to
-Video` cannot satisfy `Image to Video` when the user explicitly requires the
-input modality.