@aisa-one/cli 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.3] — 2026-09-30
+
+### Changed
+
+- Default `aisa chat` to `deepseek-v4.1-flash` for new configurations and
+  when no model is configured. Preserve saved `defaultModel` and `--model` overrides.
+
+### Fixed
+
+- Display metered provider and endpoint catalog pricing as `usage-based` in
+  `api list` and `api show`, rather than treating `normal: 0` as free.
+- Label the catalog price column `PRICING` and show usage-based details as
+  `Pricing: usage-based (cost varies)`, with guidance to request a quote.
+- Include `pricing_note` with quote guidance on metered providers and endpoints
+  in catalog JSON, preserving the original pricing metadata and list structure.
+
 ## [0.6.2] — 2026-09-23
 
 ### Added
@@ -461,7 +477,8 @@ supports today; nothing here depends on a backend change.
 - Config commands (`aisa config get|set|list|reset`) and auth
   (`aisa login|logout|whoami`).
 
-[Unreleased]: https://github.com/AIsa-team/cli/compare/v0.6.2...HEAD
+[Unreleased]: https://github.com/AIsa-team/cli/compare/v0.6.3...HEAD
+[0.6.3]: https://github.com/AIsa-team/cli/compare/v0.6.2...v0.6.3
 [0.6.2]: https://github.com/AIsa-team/cli/compare/v0.6.1...v0.6.2
 [0.6.1]: https://github.com/AIsa-team/cli/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/AIsa-team/cli/compare/v0.5.2...v0.6.0

package/README.md

@@ -31,7 +31,7 @@ aisa quote --input '{"calls":[{"call_id":"c1","tool":"get_financial_company_fact
 
 `aisa login` opens a browser, signs you in, and stores OAuth tokens. You do not
 need to create or paste a key from the console. For CI or scripts, set
-`AISA_API_KEY` or run `aisa login --key <key>`. New accounts receive $5 in
+`AISA_API_KEY` or run `aisa login --key <key>`. New accounts receive $1 in
 free credits.
 
 This first block does not run `aisa chat` or `aisa call`. Quote is a price
@@ -163,6 +163,13 @@ A provider **id is not always its URL slug** — `brave-search` serves
 `/apis/v1/brave/...`, and `api show` prints the catalog path. The catalog
 reports every method as `GET`; treat that as advisory.
 
+Prices with `type: metered` display as `usage-based` (billing depends on usage),
+even when the catalog returns `normal: 0`. Details show `usage-based (cost varies)`.
+Use `aisa quote` for a request-specific estimate; JSON keeps the original pricing metadata.
+In `--json` output, metered providers and endpoints also include `pricing_note`
+with quote guidance, including endpoints nested in provider details. The list
+remains an array, and the original `pricing` fields are unchanged.
+
 The catalog is cached in `~/.aisa/cache` (override with `AISA_CACHE_DIR`). Pass
 `--refresh` to any command to bypass it, or `aisa cache clear`.
 
@@ -172,7 +179,7 @@ GPT, Claude, Gemini, DeepSeek, Kimi, GLM, Qwen and the rest behind one
 OpenAI-compatible endpoint.
 
 ```bash
-aisa chat "your message" --model gpt-4.1-mini
+aisa chat "your message" --model deepseek-v4.1-flash
 aisa chat "explain this" --model claude-opus-4-6
 aisa chat "respond in JSON" --model gemini-2.5-pro --json
 echo "summarize this" | aisa chat                  # pipe support
@@ -340,7 +347,7 @@ aisa config reset
 ```
 
 Settings:
-- `defaultModel` — default model for `aisa chat` (default: `gpt-4.1-mini`)
+- `defaultModel` — default model for `aisa chat` (default: `deepseek-v4.1-flash`). Existing saved model settings are preserved.
 - `baseUrl` — platform root; the LLM (`/v1`), integration (`/apis/v1`), and
   catalog bases are all derived from it
 - `routerUrl` — Tool Router origin (default `https://tools.aisa.one`,

package/dist/catalog.d.ts

@@ -11,7 +11,7 @@
  */
 export interface CatalogPricing {
     type: string;
-    /** Dollars per request, as a float — not micros. */
+    /** Dollars per request, as a float — not micros. Metered prices may use 0 as a placeholder. */
     normal: number;
 }
 export interface CatalogProvider {
@@ -66,8 +66,9 @@ export declare function toRunPath(path: string): string;
  */
 export declare function runSlugOf(detail: CatalogDetail): string | undefined;
 /**
- * Format a per-request price. Real values span $0.000001 to $0.08, so a fixed
+ * Format catalog pricing, keeping metered billing distinct from a free request.
+ * Fixed prices span $0.000001 to $0.08, so a fixed
  * number of decimals either rounds the cheap endpoints to $0.00 or pads the
  * rest with noise — keep two significant digits instead.
  */
-export declare function formatPrice(usd?: number): string;
+export declare function formatPrice(pricing?: CatalogPricing): string;

package/dist/catalog.js

@@ -62,11 +62,15 @@ export function runSlugOf(detail) {
     return first ? toRunPath(first.path).split("/")[0] : undefined;
 }
 /**
- * Format a per-request price. Real values span $0.000001 to $0.08, so a fixed
+ * Format catalog pricing, keeping metered billing distinct from a free request.
+ * Fixed prices span $0.000001 to $0.08, so a fixed
  * number of decimals either rounds the cheap endpoints to $0.00 or pads the
  * rest with noise — keep two significant digits instead.
  */
-export function formatPrice(usd) {
+export function formatPrice(pricing) {
+    if (pricing?.type === "metered")
+        return "usage-based";
+    const usd = pricing?.normal;
     if (usd == null)
         return "—";
     if (usd === 0)

package/dist/commands/api.js

@@ -4,6 +4,21 @@ import { error, formatJson, hint, table, truncate } from "../utils/display.js";
 import { API_CATEGORIES, categoryOf } from "../constants.js";
 import { getProviders, getProviderDetail, getHealth, flatEndpoints, toRunPath, runSlugOf, formatPrice, } from "../catalog.js";
 const DEFAULT_ENDPOINT_LIMIT = 40;
+const CATALOG_HINT = "Catalog paths and prices are browsing metadata. Use aisa schema for parameters and aisa quote for a request-specific estimate.";
+const USAGE_BASED_PRICING_NOTE = "Usage-based billing. Use aisa quote for a request-specific estimate.";
+function withPricingNote(item) {
+    return item.pricing?.type === "metered"
+        ? { ...item, pricing_note: USAGE_BASED_PRICING_NOTE }
+        : item;
+}
+function pricingDescription(pricing, from = false) {
+    const price = formatPrice(pricing);
+    if (pricing?.type === "metered")
+        return `${price} (cost varies)`;
+    if (pricing?.normal == null)
+        return price;
+    return `${from && pricing.normal > 0 ? "from " : ""}${price} per request`;
+}
 function statusBadge(status) {
     switch (status) {
         case "healthy":
@@ -41,13 +56,13 @@ export async function apiListAction(options) {
     }
     if (options.json) {
         console.log(formatJson(providers.map((p) => ({
-            ...p,
+            ...withPricingNote(p),
             category: categoryOf(p.id),
             ...(options.health ? { health: healthById.get(p.id)?.status } : {}),
         }))));
         return;
     }
-    const headers = ["API", "CATEGORY", "ENDPOINTS", "FROM", "UPDATED"];
+    const headers = ["API", "CATEGORY", "ENDPOINTS", "PRICING", "UPDATED"];
     if (options.health)
         headers.push("STATUS");
     const rows = providers.map((p) => {
@@ -55,7 +70,9 @@ export async function apiListAction(options) {
             p.id,
             categoryOf(p.id),
             String(p.endpoint_count),
-            formatPrice(p.pricing?.normal),
+            p.pricing?.type !== "metered" && p.pricing?.normal != null && p.pricing.normal > 0
+                ? `from ${formatPrice(p.pricing)}`
+                : formatPrice(p.pricing),
             shortDate(p.updated_at),
         ];
         if (options.health)
@@ -68,7 +85,7 @@ export async function apiListAction(options) {
     console.log();
     console.log(chalk.gray(`  ${providers.length} APIs · ${total} endpoints`));
     hint("Details: aisa api show <api>");
-    hint("Catalog paths and prices are browsing metadata, not a substitute for aisa schema or aisa quote.");
+    hint(CATALOG_HINT);
 }
 /** Resolve a provider by id, or by the URL slug its endpoints are served under. */
 async function findProvider(idOrSlug, refresh) {
@@ -93,13 +110,13 @@ function printEndpointDetail(detail, endpoint) {
         console.log(`  ${endpoint.description}`);
     console.log(`\n  Path:     ${endpoint.path}`);
     console.log(`  Provider: ${detail.id}`);
-    console.log(`  Price:    ${formatPrice(endpoint.pricing?.normal)} per request`);
+    console.log(`  Pricing:  ${pricingDescription(endpoint.pricing)}`);
     const params = [...runPath.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
     if (params.length > 0) {
         console.log(`  Path params: ${params.join(", ")}`);
     }
     console.log();
-    hint("Catalog paths and prices are browsing metadata, not a substitute for aisa schema or aisa quote.");
+    hint(CATALOG_HINT);
 }
 export async function apiShowAction(idOrSlug, path, options = {}) {
     const spinner = ora(`Loading ${idOrSlug}...`).start();
@@ -140,21 +157,30 @@ export async function apiShowAction(idOrSlug, path, options = {}) {
             return;
         }
         if (options.json) {
-            console.log(formatJson(matches[0]));
+            console.log(formatJson(withPricingNote(matches[0])));
             return;
         }
         printEndpointDetail(detail, matches[0]);
         return;
     }
     if (options.json) {
-        console.log(formatJson(detail));
+        console.log(formatJson({
+            ...withPricingNote(detail),
+            ...(detail.endpoint_groups ? {
+                endpoint_groups: detail.endpoint_groups.map((group) => ({
+                    ...group,
+                    ...(group.endpoints ? { endpoints: group.endpoints.map(withPricingNote) } : {}),
+                })),
+            } : {}),
+        }));
         return;
     }
     const health = options.health
         ? (await getHealth({ refresh: options.refresh })).find((h) => h.id === detail.id)
         : undefined;
     console.log(`\n  ${chalk.cyan.bold(detail.id)} ${chalk.gray(`(${categoryOf(detail.id)})`)}`);
-    console.log(`  ${detail.endpoint_count} endpoints · from ${formatPrice(detail.pricing?.normal)} per request`);
+    console.log(`  ${detail.endpoint_count} endpoints`);
+    console.log(`  Pricing:  ${pricingDescription(detail.pricing, true)}`);
     console.log(`  Updated ${shortDate(detail.updated_at)}`);
     if (health) {
         // Health is tracked per provider, not per endpoint — the per-endpoint
@@ -185,6 +211,6 @@ export async function apiShowAction(idOrSlug, path, options = {}) {
     if (runSlugOf(detail)) {
         console.log();
         hint(`Detail: aisa api show ${detail.id} <path>`);
-        hint("Catalog paths and prices are browsing metadata, not a substitute for aisa schema or aisa quote.");
+        hint(CATALOG_HINT);
     }
 }

package/dist/commands/chat.js

@@ -4,6 +4,7 @@ import { requireAccessToken, getConfig } from "../config.js";
 import { apiRequest, apiRequestRaw } from "../api.js";
 import { error } from "../utils/display.js";
 import { handleSSEStream } from "../utils/streaming.js";
+import { DEFAULT_CHAT_MODEL } from "../constants.js";
 export async function chatAction(message, options) {
     const key = await requireAccessToken();
     // Read from stdin if no message provided
@@ -23,7 +24,7 @@ export async function chatAction(message, options) {
         error("Empty message");
         process.exit(1);
     }
-    const model = options.model || getConfig("defaultModel") || "gpt-4.1-mini";
+    const model = options.model || getConfig("defaultModel") || DEFAULT_CHAT_MODEL;
     const stream = options.stream !== false; // default true
     const messages = [];
     if (options.system) {

package/dist/commands/skills.js

@@ -4,7 +4,7 @@ import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { error, success, hint, truncate } from "../utils/display.js";
 import { expandHome, ensureDir, writeSkillFiles, removeDir, detectAgents } from "../utils/file.js";
-import { AGENT_DIRS } from "../constants.js";
+import { AGENT_DIRS, DEFAULT_CHAT_MODEL } from "../constants.js";
 import { SKILLS_REPO, getSkillIndex, listSkills, resolveSlug, leafName, fetchSkillFiles, fetchSkillMarkdown, parseSkillFrontmatter, } from "../skills-registry.js";
 // --- Skill Templates (for init) ---
 // Domain labels may stay; runnable steps use retained commands only.
@@ -74,7 +74,7 @@ export AISA_API_KEY=sk-your-key
 ## Chat Completion
 
 \`\`\`bash
-aisa chat "Your question here" --model gpt-4.1-mini
+aisa chat "Your question here" --model ${DEFAULT_CHAT_MODEL}
 \`\`\`
 
 ## Streaming

package/dist/config.js

@@ -5,7 +5,7 @@ import { join } from "node:path";
 import lockfile from "proper-lockfile";
 import { createHash, randomUUID } from "node:crypto";
 import { httpFetch } from "./utils/http.js";
-import { AUTH_SERVER, MISSING_API_KEY_GUIDANCE, ENV_VAR_NAME } from "./constants.js";
+import { AUTH_SERVER, MISSING_API_KEY_GUIDANCE, ENV_VAR_NAME, DEFAULT_CHAT_MODEL } from "./constants.js";
 // tokens.json is authoritative; conf is a write-only compatibility mirror.
 const aisaDir = () => join(homedir(), ".aisa");
 const keyFile = () => join(aisaDir(), "key");
@@ -118,7 +118,7 @@ const config = new Conf({
     schema: {
         tokens: { type: "object", default: {} },
         apiKey: { type: "string", default: "" },
-        defaultModel: { type: "string", default: "gpt-4.1-mini" },
+        defaultModel: { type: "string", default: DEFAULT_CHAT_MODEL },
         baseUrl: { type: "string", default: "https://api.aisa.one/v1" },
         routerUrl: { type: "string", default: "" },
         outputFormat: { type: "string", default: "text" },

package/dist/constants.d.ts

@@ -1,4 +1,6 @@
-export declare const VERSION = "0.6.2";
+export declare const VERSION = "0.6.3";
+/** Default for chat when no model is configured or supplied explicitly. */
+export declare const DEFAULT_CHAT_MODEL = "deepseek-v4.1-flash";
 /** 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 ENV_VAR_NAME = "AISA_API_KEY";

package/dist/constants.js

@@ -1,4 +1,6 @@
-export const VERSION = "0.6.2";
+export const VERSION = "0.6.3";
+/** Default for chat when no model is configured or supplied explicitly. */
+export const DEFAULT_CHAT_MODEL = "deepseek-v4.1-flash";
 /** Root of the platform. Per-surface bases are derived in api.ts#resolveBases. */
 export const BASE_URL = "https://api.aisa.one";
 export const ENV_VAR_NAME = "AISA_API_KEY";

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Command, Option } from "commander";
-import { VERSION } from "./constants.js";
+import { VERSION, DEFAULT_CHAT_MODEL } from "./constants.js";
 import { CliError } from "./cli-error.js";
 // Auth
 import { loginAction, logoutAction, whoamiAction } from "./commands/auth.js";
@@ -152,7 +152,7 @@ api
     .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("--json", "Output catalog JSON with pricing guidance")
     .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiListAction));
 api
@@ -161,14 +161,14 @@ api
     .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("--json", "Output catalog JSON with pricing guidance")
     .option("--refresh", "Bypass the cached catalog")
     .action(wrap(apiShowAction));
 // ── Chat (LLM Gateway) ──
 program
     .command("chat [message]")
     .description("Chat with AI models via the AIsa gateway")
-    .option("--model <model>", "Model ID (default: gpt-4.1-mini)")
+    .option("--model <model>", `Model ID (default: ${DEFAULT_CHAT_MODEL})`)
     .option("--system <prompt>", "System prompt")
     .option("--no-stream", "Disable streaming")
     .option("--json", "Output raw JSON response")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisa-one/cli",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "CLI for the AIsa unified AI infrastructure platform - one API key for 80+ LLMs and 900+ endpoints across finance, search, social, and video APIs",
   "type": "module",
   "main": "dist/index.js",