@aisa-one/cli 0.2.1 → 0.2.3

package/dist/constants.d.ts

@@ -1,15 +1,65 @@
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.2.3";
+/** Root of the platform. Per-surface bases are derived in api.ts#resolveBases. */
 export declare const BASE_URL = "https://api.aisa.one";
-export declare const CLI_BASE_URL = "https://api.aisa.one/v1";
-export declare const APIS_BASE_URL = "https://api.aisa.one/apis/v1";
 export declare const ENV_VAR_NAME = "AISA_API_KEY";
 export declare const MCP_URL = "https://docs.aisa.one/mcp";
+/**
+ * First path segment of every route the LLM gateway serves under /v1 (plus
+ * /v1beta for Gemini). Everything else is an integration API under /apis/v1.
+ *
+ * This list is deliberately the whitelist rather than the provider slugs: the
+ * gateway routes are hardcoded server-side and change about once a year, while
+ * provider slugs are data that operations add and remove continuously. Keeping
+ * the whitelist on the slow-moving side means a newly added provider works
+ * without a CLI release.
+ */
+export declare const LLM_ROUTE_PREFIXES: readonly string[];
 export declare const AGENT_DIRS: Record<string, string>;
 export declare const MCP_CONFIGS: Record<string, {
     path: string;
     key: string;
 }>;
-export declare const API_CATEGORIES: readonly ["llm", "search", "finance", "twitter", "video", "scholar"];
-export type ApiCategory = (typeof API_CATEGORIES)[number];
+/**
+ * Ticker symbol → CoinGecko coin id.
+ *
+ * CoinGecko keys everything by id ("bitcoin"), not symbol ("BTC"), and dozens
+ * of unrelated tokens share popular symbols — resolving by symbol alone would
+ * happily return the price of the wrong coin. This table covers the symbols
+ * people actually type; anything else falls back to an explicit lookup.
+ */
+export declare const COINGECKO_IDS: Record<string, string>;
+/**
+ * Models routed to /v1/video/generations, and the request body each one wants.
+ *
+ * The gateway only rewrites the top-level `model` and passes the rest through,
+ * so the body shape belongs to whichever vendor owns the model — a Bailian-style
+ * `{input, parameters}` sent to Seedance is rejected outright with a 400.
+ *
+ * `requiresMedia` records the `input.media[].type` an image/clip-driven model
+ * needs. Without it the upstream accepts the submission and only fails a minute
+ * later, after billing, so the CLI refuses up front instead.
+ */
+export type VideoFamily = "bailian" | "seedance";
+export interface VideoModelSpec {
+    family: VideoFamily;
+    requiresMedia?: MediaType;
+}
+/** Accepted values for `input.media[].type` (enumerated by the upstream error). */
+export declare const MEDIA_TYPES: readonly ["first_frame", "last_frame", "driving_audio", "first_clip"];
+export type MediaType = (typeof MEDIA_TYPES)[number];
+export declare const VIDEO_MODELS: Record<string, VideoModelSpec>;
+export declare const DEFAULT_VIDEO_MODEL = "wan2.7-t2v";
+/** Model families are matched by prefix so new revisions work without a release. */
+export declare function videoModelSpec(model: string): VideoModelSpec;
+/**
+ * Client-side grouping of integration providers.
+ *
+ * The catalog returns no description or tags — `buildCatalogItem` never
+ * populates them — so there is nothing server-side to filter on. Entries are
+ * matched by prefix, which keeps the polymarket-* family together.
+ */
+export declare const PROVIDER_CATEGORIES: Record<string, string[]>;
+export declare function categoryOf(providerId: string): string;
+export declare const API_CATEGORIES: readonly [...string[], "other"];
 export declare const MODEL_PROVIDERS: readonly ["openai", "anthropic", "google", "deepseek", "xai", "moonshot", "alibaba", "bytedance"];
 export type ModelProvider = (typeof MODEL_PROVIDERS)[number];

package/dist/constants.js

@@ -1,9 +1,31 @@
-export const VERSION = "0.2.0";
+export const VERSION = "0.2.3";
+/** Root of the platform. Per-surface bases are derived in api.ts#resolveBases. */
 export const BASE_URL = "https://api.aisa.one";
-export const CLI_BASE_URL = `${BASE_URL}/v1`;
-export const APIS_BASE_URL = `${BASE_URL}/apis/v1`;
 export const ENV_VAR_NAME = "AISA_API_KEY";
 export const MCP_URL = "https://docs.aisa.one/mcp";
+/**
+ * First path segment of every route the LLM gateway serves under /v1 (plus
+ * /v1beta for Gemini). Everything else is an integration API under /apis/v1.
+ *
+ * This list is deliberately the whitelist rather than the provider slugs: the
+ * gateway routes are hardcoded server-side and change about once a year, while
+ * provider slugs are data that operations add and remove continuously. Keeping
+ * the whitelist on the slow-moving side means a newly added provider works
+ * without a CLI release.
+ */
+export const LLM_ROUTE_PREFIXES = [
+    "chat",
+    "responses",
+    "embeddings",
+    "messages",
+    "models",
+    "rerank",
+    "classify",
+    "images",
+    "credits",
+    "video",
+    "v1beta",
+];
 export const AGENT_DIRS = {
     claude: "~/.claude/skills/",
     cursor: "~/.cursor/skills/",
@@ -24,14 +46,117 @@ export const MCP_CONFIGS = {
         key: "mcpServers",
     },
 };
-export const API_CATEGORIES = [
-    "llm",
-    "search",
-    "finance",
-    "twitter",
-    "video",
-    "scholar",
-];
+/**
+ * Ticker symbol → CoinGecko coin id.
+ *
+ * CoinGecko keys everything by id ("bitcoin"), not symbol ("BTC"), and dozens
+ * of unrelated tokens share popular symbols — resolving by symbol alone would
+ * happily return the price of the wrong coin. This table covers the symbols
+ * people actually type; anything else falls back to an explicit lookup.
+ */
+export const COINGECKO_IDS = {
+    btc: "bitcoin",
+    eth: "ethereum",
+    usdt: "tether",
+    bnb: "binancecoin",
+    sol: "solana",
+    usdc: "usd-coin",
+    xrp: "ripple",
+    doge: "dogecoin",
+    ada: "cardano",
+    trx: "tron",
+    avax: "avalanche-2",
+    shib: "shiba-inu",
+    dot: "polkadot",
+    link: "chainlink",
+    bch: "bitcoin-cash",
+    near: "near",
+    matic: "matic-network",
+    ltc: "litecoin",
+    icp: "internet-computer",
+    uni: "uniswap",
+    leo: "leo-token",
+    dai: "dai",
+    etc: "ethereum-classic",
+    apt: "aptos",
+    render: "render-token",
+    hbar: "hedera-hashgraph",
+    fil: "filecoin",
+    arb: "arbitrum",
+    atom: "cosmos",
+    imx: "immutable-x",
+    op: "optimism",
+    vet: "vechain",
+    inj: "injective-protocol",
+    sui: "sui",
+    ton: "the-open-network",
+    pepe: "pepe",
+    tao: "bittensor",
+    sei: "sei-network",
+    aave: "aave",
+    algo: "algorand",
+    xlm: "stellar",
+    cro: "crypto-com-chain",
+    mnt: "mantle",
+    wld: "worldcoin-wld",
+};
+/** Accepted values for `input.media[].type` (enumerated by the upstream error). */
+export const MEDIA_TYPES = ["first_frame", "last_frame", "driving_audio", "first_clip"];
+export const VIDEO_MODELS = {
+    "wan2.7-t2v": { family: "bailian" },
+    "wan2.7-i2v": { family: "bailian", requiresMedia: "first_frame" },
+    "wan2.7-r2v": { family: "bailian", requiresMedia: "first_clip" },
+    "happyhorse-1.1-t2v": { family: "bailian" },
+    "happyhorse-1.1-i2v": { family: "bailian", requiresMedia: "first_frame" },
+    "happyhorse-1.1-r2v": { family: "bailian", requiresMedia: "first_clip" },
+    "dreamina-seedance-2-0-260128": { family: "seedance" },
+    "dreamina-seedance-2-0-fast-260128": { family: "seedance" },
+};
+export const DEFAULT_VIDEO_MODEL = "wan2.7-t2v";
+/** Model families are matched by prefix so new revisions work without a release. */
+export function videoModelSpec(model) {
+    if (VIDEO_MODELS[model])
+        return VIDEO_MODELS[model];
+    const family = model.startsWith("dreamina-seedance") ? "seedance" : "bailian";
+    if (/-i2v\b|-i2v$/.test(model))
+        return { family, requiresMedia: "first_frame" };
+    if (/-r2v\b|-r2v$/.test(model))
+        return { family, requiresMedia: "first_clip" };
+    return { family };
+}
+/**
+ * Client-side grouping of integration providers.
+ *
+ * The catalog returns no description or tags — `buildCatalogItem` never
+ * populates them — so there is nothing server-side to filter on. Entries are
+ * matched by prefix, which keeps the polymarket-* family together.
+ */
+export const PROVIDER_CATEGORIES = {
+    finance: ["financial", "fred", "edinet", "coingecko", "polymarket", "kalshi"],
+    search: [
+        "search",
+        "tavily",
+        "brave",
+        "exa",
+        "perplexity",
+        "querit",
+        "parallel",
+        "dataforseo",
+        "jina",
+        "scholar",
+    ],
+    social: ["twitter", "aisa-twitter", "youtube", "scrape-creators", "waveinflu"],
+    productivity: ["agentmail", "apollo", "composio"],
+};
+export function categoryOf(providerId) {
+    for (const [category, prefixes] of Object.entries(PROVIDER_CATEGORIES)) {
+        if (prefixes.some((p) => providerId === p || providerId.startsWith(`${p}-`) || providerId.startsWith(`${p}.`))) {
+            return category;
+        }
+    }
+    return "other";
+}
+export const API_CATEGORIES = [...Object.keys(PROVIDER_CATEGORIES), "other"];
 export const MODEL_PROVIDERS = [
     "openai",
     "anthropic",

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { VERSION } from "./constants.js";
+import { VERSION, DEFAULT_VIDEO_MODEL } from "./constants.js";
 // Auth
 import { loginAction, logoutAction, whoamiAction } from "./commands/auth.js";
 // Account
@@ -27,6 +27,10 @@ import { skillsListAction, skillsSearchAction, skillsShowAction, skillsInstallAc
 import { mcpSetupAction, mcpStatusAction } from "./commands/mcp.js";
 // Config
 import { configSetAction, configGetAction, configListAction, configResetAction } from "./commands/configCmd.js";
+// Cache
+import { cacheClearAction, cachePathAction } from "./commands/cacheCmd.js";
+// Completion
+import { completionAction, completeAction } from "./commands/completionCmd.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function wrap(fn) {
     return (...args) => {
@@ -58,34 +62,48 @@ program
 // ── Account ──
 program
     .command("balance")
-    .description("Show credit balance (WIP)")
+    .description("Show credit balance")
+    .option("--json", "Output raw JSON")
     .action(wrap(balanceAction));
 program
     .command("usage")
-    .description("Show usage history (WIP)")
+    .description("Show usage history (awaiting gateway support)")
     .option("--limit <n>", "Max records")
     .option("--days <n>", "Lookback days")
     .action(wrap(usageAction));
 // ── API ──
-const api = program.command("api").description("Discover and inspect APIs (WIP)");
+const api = program.command("api").description("Discover and inspect APIs");
 api
     .command("list")
-    .description("List available API endpoints (WIP)")
-    .option("--category <cat>", "Filter by category (llm, search, finance, twitter, video, scholar)")
+    .description("List available APIs")
+    .option("--category <cat>", "Filter by category (client-side grouping): finance, search, social, productivity, other")
+    .option("--health", "Include provider health status")
+    .option("--json", "Output raw JSON")
+    .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiListAction));
 api
     .command("search <query>")
-    .description("Search APIs by keyword (WIP)")
-    .option("--limit <n>", "Max results")
+    .description("Search APIs and endpoints by keyword")
+    .option("--provider <id>", "Restrict to one API")
+    .option("--limit <n>", "Max results", "20")
+    .option("--json", "Output raw JSON")
+    .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiSearchAction));
 api
-    .command("show <slug> [path]")
-    .description("Show API endpoint details (WIP)")
+    .command("show <api> [path]")
+    .description("Show an API's endpoints, or one endpoint's details")
+    .option("--all", "Show every endpoint instead of the first 40")
+    .option("--group", "Group by the provider's raw endpoint groups")
+    .option("--health", "Include provider health status")
+    .option("--json", "Output raw JSON")
+    .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiShowAction));
 api
     .command("code <slug> <path>")
-    .description("Generate code snippet (WIP)")
-    .option("--lang <language>", "Language: typescript, python, curl", "typescript")
+    .description("Generate a request snippet for an endpoint")
+    .option("--lang <language>", "Language: curl, python, node, typescript", "curl")
+    .option("--method <method>", "HTTP method (the catalog's method is advisory)", "GET")
+    .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiCodeAction));
 // ── Run ──
 program
@@ -96,12 +114,18 @@ program
     .option("--method <method>", "HTTP method")
     .option("--raw", "Raw JSON output")
     .option("--stream", "Stream response")
+    .option("--domain", "Force the integration API base (/apis/v1) — the default")
+    .option("--llm", "Force the LLM gateway base (/v1)")
+    .option("--show-cost", "Print the billing headers the gateway reported (stderr)")
     .action((slug, path, opts) => wrap(runAction)(slug, path, {
     q: opts.query,
     d: opts.data,
     method: opts.method,
     raw: opts.raw,
     stream: opts.stream,
+    llm: opts.llm,
+    domain: opts.domain,
+    showCost: opts.showCost,
 }));
 // ── Chat (LLM Gateway) ──
 program
@@ -129,7 +153,7 @@ models
 program
     .command("web-search <query>")
     .description("Search the web")
-    .option("--type <type>", "Search type: smart, full, youtube, scholar, tavily", "smart")
+    .option("--type <type>", "Search type: tavily, youtube, scholar, smart (degraded), full (degraded)", "tavily")
     .option("--limit <n>", "Max results")
     .option("--raw", "Raw JSON output")
     .action(wrap(webSearchAction));
@@ -149,13 +173,17 @@ program
 program
     .command("crypto <symbol>")
     .description("Look up crypto price")
-    .option("--period <period>", "Time period: current, 1d, 7d, 30d, 1y")
+    .option("--period <period>", "Time period: current, 1d, 7d, 30d, 90d, 1y")
+    .option("--id <coingecko-id>", "Use an exact CoinGecko id instead of resolving the symbol")
+    .option("--source <source>", "Data source: coingecko (default) or financial")
     .option("--raw", "Raw JSON output")
     .action(wrap(cryptoAction));
 program
     .command("screener")
     .description("Screen stocks by criteria")
-    .option("--sector <sector>", "Filter by sector")
+    .option("--sector <sector>", "Filter by GICS sector (e.g. 'Information Technology')")
+    .option("--min-market-cap <n>", "Minimum market cap in USD")
+    .option("--filter <f...>", "Extra filter as field:operator:value (e.g. market_cap:gt:1e12)")
     .option("--limit <n>", "Max results")
     .option("--raw", "Raw JSON output")
     .action(wrap(screenerAction));
@@ -387,14 +415,20 @@ const video = program.command("video").description("AI video generation");
 video
     .command("create <prompt>")
     .description("Create a video generation task")
-    .option("--model <model>", "Generation model")
+    .option("--model <model>", `Generation model (default: ${DEFAULT_VIDEO_MODEL})`)
+    .option("--image <url...>", "Source image for i2v models (shorthand for --media first_frame=<url>)")
+    .option("--media <type=url...>", "Source media: first_frame, last_frame, driving_audio, first_clip")
+    .option("--resolution <res>", "Resolution, e.g. 720P or 1080P", "720P")
+    .option("--duration <seconds>", "Clip duration in seconds", "5")
+    .option("--body <json>", "Send this request body verbatim (escape hatch for unmodelled vendors)")
     .option("--wait", "Wait for completion")
-    .option("--output <path>", "Download output path")
+    .option("--output <path>", "Download the finished video to this path (implies --wait)")
     .option("--raw", "Raw JSON output")
-    .action(wrap(videoCreateAction));
+    .action((prompt, opts) => wrap(videoCreateAction)(prompt, { ...opts, wait: Boolean(opts.wait || opts.output) }));
 video
     .command("status <task-id>")
     .description("Check video task status")
+    .option("--output <path>", "Download the finished video to this path")
     .option("--raw", "Raw JSON output")
     .action(wrap(videoStatusAction));
 // ── Skills ──
@@ -402,13 +436,15 @@ const skills = program.command("skills").description("Browse and manage agent sk
 skills
     .command("list")
     .description("List available skills")
-    .option("--category <cat>", "Filter by category")
+    .option("--category <cat>", "Filter by category (ai-models, financial, marketing, ...)")
     .option("--limit <n>", "Max results")
+    .option("--refresh", "Bypass the cached skill index")
     .action(wrap(skillsListAction));
 skills
     .command("search <query>")
     .description("Search skills by keyword")
     .option("--limit <n>", "Max results")
+    .option("--refresh", "Bypass the cached skill index")
     .action(wrap(skillsSearchAction));
 skills
     .command("show <slug>")
@@ -418,11 +454,13 @@ skills
     .command("install <slug>")
     .description("Install a skill to agent directories")
     .option("--agent <agent>", "Target agent: claude, cursor, copilot, windsurf, codex, gemini, openclaw, all")
+    .option("--force", "Overwrite a directory holding a different skill")
     .action(wrap(skillsInstallAction));
 skills
     .command("remove <slug>")
     .description("Remove an installed skill")
     .option("--agent <agent>", "Target agent")
+    .option("--force", "Remove even if the directory holds a different skill")
     .action(skillsRemoveAction);
 skills
     .command("init <name>")
@@ -462,13 +500,38 @@ configCmd
 // ── Top-level aliases ──
 program
     .command("search <query>")
-    .description("Search APIs (alias for 'api search') (WIP)")
-    .option("--limit <n>", "Max results")
+    .description("Search APIs (alias for 'api search')")
+    .option("--provider <id>", "Restrict to one API")
+    .option("--limit <n>", "Max results", "20")
+    .option("--json", "Output raw JSON")
+    .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiSearchAction));
 program
     .command("code <slug> <path>")
-    .description("Generate code (alias for 'api code') (WIP)")
-    .option("--lang <language>", "Language", "typescript")
+    .description("Generate a request snippet (alias for 'api code')")
+    .option("--lang <language>", "Language: curl, python, node, typescript", "curl")
+    .option("--method <method>", "HTTP method")
     .action(wrap(apiCodeAction));
+const cache = program.command("cache").description("Manage the local catalog and skills cache");
+cache
+    .command("clear")
+    .description("Delete all cached catalog and skills data")
+    .action(cacheClearAction);
+cache
+    .command("path")
+    .description("Print the cache directory")
+    .action(cachePathAction);
+// ── Shell completion ──
+program
+    .command("completion [shell]")
+    .description("Print a shell completion script (bash, zsh, fish)")
+    .action(completionAction);
+// Called by the generated scripts on every Tab press. Hidden, and tolerant of
+// whatever half-typed input the shell hands it.
+program
+    .command("__complete [words...]", { hidden: true })
+    .allowUnknownOption()
+    .allowExcessArguments()
+    .action((words = []) => completeAction(program, words));
 // ── Parse ──
 program.parse();

package/dist/skills-registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * GitHub-backed skill registry.
+ *
+ * The repo nests skills two levels deep (`<category>/<name>/SKILL.md`), so the
+ * canonical slug is the repo-relative directory. Everything here is driven off
+ * a single recursive tree fetch: api.github.com allows only 60 unauthenticated
+ * requests per hour per IP, and the previous per-command fetching burned
+ * several of those on every invocation.
+ */
+export declare const SKILLS_REPO = "AIsa-team/agent-skills";
+export declare const GH_RAW = "https://raw.githubusercontent.com/AIsa-team/agent-skills/main";
+export interface SkillBlob {
+    path: string;
+    sha: string;
+}
+export interface SkillIndex {
+    /** Canonical slugs (`<category>/<name>`), sorted. */
+    slugs: string[];
+    /** All blobs under each slug, including SKILL.md. */
+    blobs: Record<string, SkillBlob[]>;
+}
+export interface SkillInfo {
+    slug: string;
+    name: string;
+    description: string;
+    emoji: string;
+}
+/**
+ * Fetch (or reuse) the skill index. Memoized per process on top of a 1h disk
+ * cache with ETag revalidation, so repeated commands cost at most one
+ * conditional request.
+ */
+export declare function getSkillIndex(options?: {
+    refresh?: boolean;
+}): Promise<SkillIndex>;
+/** Last path segment — what the skill is called once installed. */
+export declare function leafName(slug: string): string;
+/**
+ * Accept either a canonical `<category>/<name>` slug or a bare name. A bare
+ * name that matches several skills is an error rather than a guess: installing
+ * the wrong skill silently is worse than asking.
+ */
+export declare function resolveSlug(input: string, index: SkillIndex): string;
+/** Parse YAML frontmatter from SKILL.md content. */
+export declare function parseSkillFrontmatter(slug: string, content: string): SkillInfo;
+export declare function fetchSkillMarkdown(slug: string): Promise<string>;
+/**
+ * Metadata for every skill. Cached by blob sha, so a warm cache needs zero
+ * content requests and only re-fetches the skills that actually changed.
+ */
+export declare function listSkills(index: SkillIndex): Promise<SkillInfo[]>;
+export interface SkillFile {
+    path: string;
+    content: Buffer;
+}
+/**
+ * Download every file in a skill directory. Content is kept as bytes: skills
+ * may ship images or fonts, and decoding those as UTF-8 corrupts them.
+ *
+ * A partial download is an error, not a smaller skill. Installing replaces the
+ * target directory, so silently dropping failed files would delete a working
+ * skill and leave a broken one — possibly without its SKILL.md.
+ */
+export declare function fetchSkillFiles(slug: string, index: SkillIndex): Promise<SkillFile[]>;