@aisa-one/cli 0.1.2 → 0.1.4

package/README.md

@@ -187,6 +187,10 @@ Settings:
 
 Environment variable `AISA_API_KEY` takes precedence over stored key.
 
+## Known Issues
+
+**GPT-4.1 streaming returns empty output.** The AISA gateway currently strips `choices[].delta.content` from GPT model SSE chunks, so streaming mode produces blank output for GPT models. Workaround: use `--no-stream` or switch to Claude/Qwen models which stream correctly. Non-streaming GPT works fine.
+
 ## Development
 
 ```bash
@@ -198,6 +202,24 @@ npm run dev         # watch mode
 npm test            # run tests
 ```
 
+## Appendix: Architecture Notes for Contributors
+
+**Two base URLs.** The AISA platform uses separate base paths:
+- LLM endpoints (chat, models): `https://api.aisa.one/v1/`
+- Domain API endpoints (search, finance, twitter, video): `https://api.aisa.one/apis/v1/`
+
+The `domain: true` option in `RequestOptions` (see `src/api.ts`) selects which base URL to use. The `run` command auto-detects based on the slug prefix.
+
+**Parameter naming varies by endpoint.** Smart/full search uses `q`, scholar uses `query`, finance uses `ticker` (not `symbol`), Twitter uses `userName` (camelCase). Always check the [API Reference](https://docs.aisa.one/reference) for exact parameter names.
+
+**Video generation is async.** POST to `/services/aigc/video-generation/video-synthesis` with header `X-DashScope-Async: enable`, then poll `GET /services/aigc/tasks?task_id=<id>` for status. Response shape uses `output.task_id`, `output.task_status`, `output.video_url`.
+
+**Twitter write operations require login cookies.** `create_tweet_v2` and other action endpoints need `login_cookies` and `proxy` fields — they don't work with just the API key.
+
+**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.
+
 ## License
 
 MIT

package/dist/commands/account.d.ts

@@ -1,5 +1,5 @@
 export declare function balanceAction(): Promise<void>;
-export declare function usageAction(options: {
+export declare function usageAction(_options: {
     limit?: string;
     days?: string;
 }): Promise<void>;

package/dist/commands/account.js

@@ -1,47 +1,13 @@
-import ora from "ora";
 import chalk from "chalk";
 import { requireApiKey } from "../config.js";
-import { apiRequest } from "../api.js";
-import { error, table } from "../utils/display.js";
+import { hint } from "../utils/display.js";
 export async function balanceAction() {
-    const key = requireApiKey();
-    const spinner = ora("Fetching balance...").start();
-    const res = await apiRequest(key, "credits/balance");
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to fetch balance");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    console.log(`  Balance: ${chalk.green("$" + res.data.balance.toFixed(2))} ${res.data.currency}`);
-    console.log(chalk.gray("  Add credits at https://aisa.one/dashboard/wallet"));
+    requireApiKey();
+    console.log(chalk.yellow("  Balance API is not yet available."));
+    hint("Check your balance at https://aisa.one/dashboard");
 }
-export async function usageAction(options) {
-    const key = requireApiKey();
-    const spinner = ora("Fetching usage...").start();
-    const query = {};
-    if (options.limit)
-        query.limit = options.limit;
-    if (options.days)
-        query.days = options.days;
-    const res = await apiRequest(key, "credits/usage", { query });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to fetch usage");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { records } = res.data;
-    if (records.length === 0) {
-        console.log("  No usage records found.");
-        return;
-    }
-    const rows = records.map((r) => [
-        new Date(r.timestamp).toLocaleDateString(),
-        r.api,
-        r.endpoint,
-        `$${r.cost.toFixed(4)}`,
-        r.status,
-    ]);
-    console.log(table(["Date", "API", "Endpoint", "Cost", "Status"], rows));
+export async function usageAction(_options) {
+    requireApiKey();
+    console.log(chalk.yellow("  Usage API is not yet available."));
+    hint("View usage history at https://aisa.one/dashboard");
 }

package/dist/commands/api.d.ts

@@ -1,10 +1,10 @@
-export declare function apiListAction(options: {
+export declare function apiListAction(_options: {
     category?: string;
 }): Promise<void>;
-export declare function apiSearchAction(query: string, options: {
+export declare function apiSearchAction(_query: string, _options: {
     limit?: string;
 }): Promise<void>;
-export declare function apiShowAction(slug: string, path?: string): Promise<void>;
-export declare function apiCodeAction(slug: string, path: string, options: {
+export declare function apiShowAction(_slug: string, _path?: string): Promise<void>;
+export declare function apiCodeAction(_slug: string, _path: string, _options: {
     lang?: string;
 }): Promise<void>;

package/dist/commands/api.js

@@ -1,116 +1,26 @@
-import ora from "ora";
 import chalk from "chalk";
 import { requireApiKey } from "../config.js";
-import { apiRequest } from "../api.js";
-import { error, badge, table, hint, truncate } from "../utils/display.js";
-export async function apiListAction(options) {
-    const key = requireApiKey();
-    const spinner = ora("Listing APIs...").start();
-    const query = {};
-    if (options.category)
-        query.category = options.category;
-    const res = await apiRequest(key, "cli/apis", { query });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to list APIs");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { apis } = res.data;
-    if (apis.length === 0) {
-        console.log("  No APIs found.");
-        return;
-    }
-    for (const api of apis) {
-        console.log(`\n  ${chalk.cyan.bold(api.name)} ${chalk.gray(api.slug)} ${badge(api.category)}`);
-        console.log(`  ${chalk.gray(api.description)}`);
-        const shown = api.endpoints.slice(0, 3);
-        for (const ep of shown) {
-            console.log(`    ${chalk.yellow(ep.method.padEnd(6))} ${ep.path} ${chalk.gray("- " + truncate(ep.description, 50))}`);
-        }
-        if (api.endpoints.length > 3) {
-            hint(`+${api.endpoints.length - 3} more endpoints`);
-        }
-    }
-    console.log(chalk.gray("\n  Run 'aisa api show <slug>' for endpoint details"));
+import { hint } from "../utils/display.js";
+const COMING_SOON = chalk.yellow("  API catalog is not yet available.");
+const BROWSE_HINT = "Browse available APIs at https://docs.aisa.one/reference";
+export async function apiListAction(_options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
+    hint("Use 'aisa run <slug> <path>' to call APIs directly");
 }
-export async function apiSearchAction(query, options) {
-    const key = requireApiKey();
-    const spinner = ora(`Searching "${query}"...`).start();
-    const res = await apiRequest(key, "cli/apis/search", {
-        method: "POST",
-        body: { query, limit: parseInt(options.limit || "10") },
-    });
-    if (!res.success || !res.data) {
-        spinner.fail("Search failed");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const { apis } = res.data;
-    if (apis.length === 0) {
-        console.log(`  No APIs found for "${query}".`);
-        return;
-    }
-    for (const api of apis) {
-        console.log(`\n  ${chalk.cyan.bold(api.name)} ${chalk.gray(api.slug)} ${badge(api.category)}`);
-        console.log(`  ${chalk.gray(api.description)}`);
-        for (const ep of api.endpoints.slice(0, 2)) {
-            console.log(`    ${chalk.yellow(ep.method.padEnd(6))} ${ep.path}`);
-        }
-    }
-    console.log(chalk.gray("\n  Run 'aisa run <slug> <path>' to execute"));
+export async function apiSearchAction(_query, _options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }
-export async function apiShowAction(slug, path) {
-    const key = requireApiKey();
-    const spinner = ora(`Loading ${slug}${path ? " " + path : ""}...`).start();
-    const endpoint = path ? `cli/apis/${slug}${path}` : `cli/apis/${slug}`;
-    const res = await apiRequest(key, endpoint);
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to load API details");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    const data = res.data;
-    if ("endpoints" in data) {
-        // ApiGroup
-        console.log(`\n  ${chalk.cyan.bold(data.name)} ${badge(data.category)}`);
-        console.log(`  ${data.description}\n`);
-        for (const ep of data.endpoints) {
-            console.log(`  ${chalk.yellow(ep.method.padEnd(6))} ${ep.path}`);
-            console.log(`  ${chalk.gray(ep.description)}`);
-        }
-    }
-    else {
-        // ApiEndpoint with parameters
-        console.log(`\n  ${chalk.yellow(data.method)} ${data.path}`);
-        console.log(`  ${data.description}\n`);
-        if (data.parameters && data.parameters.length > 0) {
-            const rows = data.parameters.map((p) => [
-                p.name,
-                p.type,
-                p.required ? chalk.red("required") : "optional",
-                truncate(p.description, 40),
-            ]);
-            console.log(table(["Name", "Type", "Required", "Description"], rows));
-        }
-        console.log(chalk.gray(`\n  Example: aisa run ${slug} ${data.path} -q "param=value"`));
-    }
+export async function apiShowAction(_slug, _path) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }
-export async function apiCodeAction(slug, path, options) {
-    const key = requireApiKey();
-    const lang = options.lang || "typescript";
-    const spinner = ora(`Generating ${lang} code...`).start();
-    const res = await apiRequest(key, "cli/apis/code", {
-        method: "POST",
-        body: { slug, path, language: lang },
-    });
-    if (!res.success || !res.data) {
-        spinner.fail("Failed to generate code");
-        error(res.error || "Unknown error");
-        return;
-    }
-    spinner.stop();
-    console.log(`\n${res.data.code}`);
+export async function apiCodeAction(_slug, _path, _options) {
+    requireApiKey();
+    console.log(COMING_SOON);
+    hint(BROWSE_HINT);
 }

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.2";
+export declare const VERSION = "0.1.4";
 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.2";
+export const VERSION = "0.1.4";
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisa-one/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",