@aisa-one/cli 0.1.4 → 0.1.6

package/README.md

@@ -60,16 +60,15 @@ aisa models show gpt-4.1             # model details + pricing
 ### API Discovery & Execution
 
 ```bash
-aisa api list                                # list all API endpoints
-aisa api list --category finance             # filter by category
-aisa api search "email finder"               # natural language search
-aisa api show finance /stock/price           # endpoint details + params
-aisa api code finance /stock/price --lang python  # generate code snippet
-
-# Execute any API
-aisa run finance /stock/price -q "symbol=AAPL"
+aisa api list                                # 🚧 WIP — not yet available
+aisa api search "email finder"               # 🚧 WIP
+aisa api show finance /stock/price           # 🚧 WIP
+aisa api code finance /stock/price --lang python  # 🚧 WIP
+
+# Execute any API (works now)
+aisa run financial /insider-trades -q "ticker=AAPL"
 aisa run tavily /search -d '{"query": "AI news"}'
-aisa run twitter /tweet/advanced-search -q "query=AI agents" --raw
+aisa run twitter /tweet/advanced_search -q "query=AI agents" --raw
 ```
 
 ### Web Search
@@ -85,11 +84,13 @@ aisa scholar "transformer architecture"     # academic papers
 ### Finance
 
 ```bash
-aisa stock AAPL                     # stock price
-aisa stock MSFT --field earnings    # earnings data
+aisa stock AAPL                     # summary: company info + estimates + news
+aisa stock AAPL --field insider     # insider trades
+aisa stock AAPL --field news        # company news
 aisa stock TSLA --field filings     # SEC filings
-aisa stock NVDA --field insider     # insider trades
-aisa crypto BTC                     # crypto price
+aisa stock MSFT --field estimates   # analyst EPS & revenue estimates
+aisa stock AAPL --field financials  # balance sheets, income statements
+aisa crypto BTC                     # crypto price snapshot
 aisa crypto ETH --period 30d       # historical
 aisa screener --sector Technology   # stock screener
 ```
@@ -97,11 +98,10 @@ aisa screener --sector Technology   # stock screener
 ### Twitter/X
 
 ```bash
-aisa tweet "Hello world!"                   # post a tweet
-aisa tweet "Reply" --reply-to 123456        # reply
-aisa twitter search "AI agents" --limit 20  # search tweets
 aisa twitter user elonmusk                  # user profile
+aisa twitter search "AI agents" --limit 20  # search tweets
 aisa twitter trends                         # trending topics
+aisa tweet "Hello world!"                   # post (⚠️ requires login cookies, see docs)
 ```
 
 ### Video Generation
@@ -115,9 +115,8 @@ aisa video status <task-id>                      # check status
 ### Account
 
 ```bash
-aisa balance                # credit balance
-aisa usage --limit 20       # usage history
-aisa usage --days 7         # last 7 days
+aisa balance                # 🚧 WIP — check https://aisa.one/dashboard
+aisa usage --limit 20       # 🚧 WIP
 ```
 
 ## Skills
@@ -127,12 +126,11 @@ Skills are markdown files that teach AI coding agents (Claude Code, Cursor, Copi
 ### Browse & Install
 
 ```bash
-aisa skills list                              # browse skills
-aisa skills search "financial analysis"       # search
-aisa skills show aisa-team/finance-analyst    # details
-aisa skills add aisa-team/finance-analyst     # install to all agents
-aisa skills add aisa-team/llm-assistant --agent claude  # specific agent
-aisa skills remove aisa-team/finance-analyst  # uninstall
+aisa skills list                              # 🚧 WIP — requires backend
+aisa skills search "financial analysis"       # 🚧 WIP
+aisa skills show aisa-team/finance-analyst    # 🚧 WIP
+aisa skills add aisa-team/finance-analyst     # 🚧 WIP
+aisa skills remove aisa-team/finance-analyst  # 🚧 WIP
 ```
 
 Skills install to agent directories automatically:
@@ -150,12 +148,12 @@ Skills install to agent directories automatically:
 ### Create & Publish
 
 ```bash
-aisa skills init my-skill                          # create from default template
+aisa skills init my-skill                          # create from default template (works locally)
 aisa skills init my-skill --template finance       # finance template
 aisa skills init my-skill --template llm           # LLM template
-aisa skills submit ./my-skill                      # submit to AISA
-aisa skills push owner/my-skill                    # push updates
-aisa skills request-verification owner/my-skill    # request review
+aisa skills submit ./my-skill                      # 🚧 WIP — requires backend
+aisa skills push owner/my-skill                    # 🚧 WIP
+aisa skills request-verification owner/my-skill    # 🚧 WIP
 ```
 
 Available templates: `default`, `llm`, `search`, `finance`, `twitter`, `video`
@@ -218,7 +216,7 @@ The `domain: true` option in `RequestOptions` (see `src/api.ts`) selects which b
 
 **Models API follows OpenAI format.** The `/v1/models` endpoint returns `owned_by` (not `provider`) and has no `name`, `pricing`, or `contextWindow` fields.
 
-**Some financial endpoints return empty data.** `financial/prices` and `financial/financial-metrics/snapshot` may return `{}` for certain tickers. `financial/insider-trades`, `financial/news`, and `financial/filings` work reliably.
+**Some financial endpoints return empty data.** `financial/prices` and `financial/financial-metrics/snapshot` return `{}` for all tickers (backend issue). The default `aisa stock` now fetches `company/facts` + `analyst-estimates` + `news` instead. Working fields: `info`, `estimates`, `financials`, `filings`, `insider`, `institutional`, `news`.
 
 ## License
 

package/dist/commands/finance.js

@@ -1,40 +1,79 @@
 import ora from "ora";
+import chalk from "chalk";
 import { requireApiKey } from "../config.js";
 import { apiRequest } from "../api.js";
 import { error, formatJson } from "../utils/display.js";
 const FIELD_ENDPOINTS = {
-    price: "financial/prices",
-    earnings: "financial/earnings/press-releases",
+    info: "financial/company/facts",
+    estimates: "financial/analyst-estimates",
     financials: "financial/financials",
     filings: "financial/filings",
     insider: "financial/insider-trades",
     institutional: "financial/institutional-ownership",
-    metrics: "financial/financial-metrics/snapshot",
     news: "financial/news",
 };
 export async function stockAction(symbol, options) {
     const key = requireApiKey();
-    const field = options.field || "price";
+    const field = options.field || "info";
+    const ticker = symbol.toUpperCase();
+    // Default: show a summary of company info + estimates + news
+    if (!options.field) {
+        const spinner = ora(`Fetching ${ticker}...`).start();
+        const [infoRes, estRes, newsRes] = await Promise.all([
+            apiRequest(key, "financial/company/facts", { query: { ticker }, domain: true }),
+            apiRequest(key, "financial/analyst-estimates", { query: { ticker }, domain: true }),
+            apiRequest(key, "financial/news", { query: { ticker, limit: "3" }, domain: true }),
+        ]);
+        spinner.stop();
+        if (options.raw) {
+            console.log(JSON.stringify({ info: infoRes.data, estimates: estRes.data, news: newsRes.data }));
+            return;
+        }
+        // Company info
+        const facts = infoRes.data?.company_facts;
+        if (facts) {
+            console.log(`\n  ${chalk.cyan.bold(facts.name || ticker)} ${chalk.gray(`(${facts.ticker || ticker})`)}`);
+            const details = [facts.exchange, facts.sector, facts.industry].filter(Boolean).join(" · ");
+            if (details)
+                console.log(`  ${chalk.gray(details)}`);
+            if (facts.location)
+                console.log(`  ${chalk.gray(facts.location)}`);
+        }
+        else {
+            console.log(`\n  ${chalk.cyan.bold(ticker)}`);
+        }
+        // Analyst estimates
+        const estimates = estRes.data?.analyst_estimates;
+        if (estimates && estimates.length > 0) {
+            console.log(`\n  ${chalk.white.bold("Analyst Estimates")}`);
+            for (const e of estimates.slice(0, 3)) {
+                const period = e.fiscal_period?.split("T")[0] || e.period || "";
+                const eps = e.earnings_per_share != null ? `EPS $${e.earnings_per_share.toFixed(2)}` : "";
+                const rev = e.revenue != null ? `Rev $${(e.revenue / 1e9).toFixed(1)}B` : "";
+                console.log(`    ${chalk.gray(period)}  ${eps}  ${rev}`);
+            }
+        }
+        // Latest news
+        const news = newsRes.data?.news;
+        if (news && news.length > 0) {
+            console.log(`\n  ${chalk.white.bold("Latest News")}`);
+            for (const n of news) {
+                const date = n.date ? new Date(n.date).toLocaleDateString() : "";
+                console.log(`    ${chalk.gray(date)}  ${n.title}`);
+            }
+        }
+        console.log();
+        return;
+    }
+    // Specific field
     const endpoint = FIELD_ENDPOINTS[field];
     if (!endpoint) {
         error(`Unknown field: ${field}. Valid: ${Object.keys(FIELD_ENDPOINTS).join(", ")}`);
         return;
     }
-    const spinner = ora(`Fetching ${field} for ${symbol.toUpperCase()}...`).start();
-    const query = { ticker: symbol.toUpperCase() };
-    // Price endpoint needs additional params for sensible defaults
-    if (field === "price") {
-        const end = new Date();
-        const start = new Date();
-        start.setDate(start.getDate() - 30);
-        query.interval = "day";
-        query.interval_multiplier = "1";
-        query.start_date = start.toISOString().split("T")[0];
-        query.end_date = end.toISOString().split("T")[0];
-        query.limit = "30";
-    }
+    const spinner = ora(`Fetching ${field} for ${ticker}...`).start();
     const res = await apiRequest(key, endpoint, {
-        query,
+        query: { ticker },
         domain: true,
     });
     if (!res.success) {

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.4";
+export declare const VERSION = "0.1.6";
 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";

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const VERSION = "0.1.4";
+export const VERSION = "0.1.6";
 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`;

package/dist/index.js

@@ -58,33 +58,33 @@ program
 // ── Account ──
 program
     .command("balance")
-    .description("Show credit balance")
+    .description("Show credit balance (WIP)")
     .action(wrap(balanceAction));
 program
     .command("usage")
-    .description("Show usage history")
+    .description("Show usage history (WIP)")
     .option("--limit <n>", "Max records")
     .option("--days <n>", "Lookback days")
     .action(wrap(usageAction));
 // ── API ──
-const api = program.command("api").description("Discover and inspect APIs");
+const api = program.command("api").description("Discover and inspect APIs (WIP)");
 api
     .command("list")
-    .description("List available API endpoints")
+    .description("List available API endpoints (WIP)")
     .option("--category <cat>", "Filter by category (llm, search, finance, twitter, video, scholar)")
     .action(wrap(apiListAction));
 api
     .command("search <query>")
-    .description("Search APIs by keyword")
+    .description("Search APIs by keyword (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(apiSearchAction));
 api
     .command("show <slug> [path]")
-    .description("Show API endpoint details")
+    .description("Show API endpoint details (WIP)")
     .action(wrap(apiShowAction));
 api
     .command("code <slug> <path>")
-    .description("Generate code snippet")
+    .description("Generate code snippet (WIP)")
     .option("--lang <language>", "Language: typescript, python, curl", "typescript")
     .action(wrap(apiCodeAction));
 // ── Run ──
@@ -143,7 +143,7 @@ program
 program
     .command("stock <symbol>")
     .description("Look up stock data")
-    .option("--field <field>", "Data field: price, earnings, financials, filings, insider, institutional, metrics, news", "price")
+    .option("--field <field>", "Data field: info, estimates, financials, filings, insider, institutional, news")
     .option("--raw", "Raw JSON output")
     .action(wrap(stockAction));
 program
@@ -202,32 +202,32 @@ video
 const skills = program.command("skills").description("Browse and manage agent skills");
 skills
     .command("list")
-    .description("List available skills")
+    .description("List available skills (WIP)")
     .option("--category <cat>", "Filter by category")
     .option("--limit <n>", "Max results")
     .action(wrap(skillsListAction));
 skills
     .command("search <query>")
-    .description("Search skills")
+    .description("Search skills (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(skillsSearchAction));
 skills
     .command("show <slug>")
-    .description("Show skill details")
+    .description("Show skill details (WIP)")
     .action(wrap(skillsShowAction));
 skills
     .command("add <slug>")
-    .description("Install a skill to agent directories")
+    .description("Install a skill to agent directories (WIP)")
     .option("--agent <agent>", "Target agent: claude, cursor, copilot, windsurf, codex, gemini, openclaw, all")
     .action(wrap(skillsAddAction));
 skills
     .command("remove <slug>")
-    .description("Remove an installed skill")
+    .description("Remove an installed skill (WIP)")
     .option("--agent <agent>", "Target agent")
     .action(skillsRemoveAction);
 skills
     .command("update [slug]")
-    .description("Update installed skill(s)")
+    .description("Update installed skill(s) (WIP)")
     .action(wrap(skillsUpdateAction));
 skills
     .command("init <name>")
@@ -237,15 +237,15 @@ skills
     .action(skillsInitAction);
 skills
     .command("submit <path>")
-    .description("Submit a skill to AISA")
+    .description("Submit a skill to AISA (WIP)")
     .action(wrap(skillsSubmitAction));
 skills
     .command("push <slug>")
-    .description("Push local changes to a submitted skill")
+    .description("Push local changes to a submitted skill (WIP)")
     .action(wrap(skillsPushAction));
 skills
     .command("request-verification <slug>")
-    .description("Request skill verification")
+    .description("Request skill verification (WIP)")
     .action(wrap(skillsVerifyAction));
 // ── MCP ──
 const mcp = program.command("mcp").description("MCP server integration");
@@ -279,12 +279,12 @@ configCmd
 // ── Top-level aliases ──
 program
     .command("search <query>")
-    .description("Search APIs (alias for 'api search')")
+    .description("Search APIs (alias for 'api search') (WIP)")
     .option("--limit <n>", "Max results")
     .action(wrap(apiSearchAction));
 program
     .command("code <slug> <path>")
-    .description("Generate code (alias for 'api code')")
+    .description("Generate code (alias for 'api code') (WIP)")
     .option("--lang <language>", "Language", "typescript")
     .action(wrap(apiCodeAction));
 // ── Parse ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisa-one/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "CLI for the AISA unified AI infrastructure platform - access 70+ LLMs, web search, finance, Twitter, and video generation APIs",
   "type": "module",
   "main": "dist/index.js",