@aisa-one/cli 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to `@aisa-one/cli` are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Fixed
+
+- **Skills registry now points at the canonical `agent-skills` repo.** The
+  `SKILLS_REPO` constant in `src/commands/skills.ts` was pinned to
+  `AIsa-team/OpenClaw-Skills`, which has been renamed to
+  `AIsa-team/agent-skills`. Every `aisa skills` subcommand kept working
+  only because GitHub serves a 301 redirect on the old slug; the constant
+  now references the canonical name so the registry no longer depends on
+  that redirect. ([#3](https://github.com/AIsa-team/cli/pull/3))
+- **`aisa skills list` and `aisa skills show` now render emojis for live
+  skills.** `parseSkillFrontmatter` only read `metadata.openclaw.emoji`,
+  but skills in `agent-skills` publish under `metadata.aisa.emoji`. The
+  parser now reads the new key first and falls back to the legacy
+  `openclaw` key for any older skills still in the wild.
+  ([#4](https://github.com/AIsa-team/cli/pull/4))
+
+### Changed
+
+- **`aisa skills init` templates aligned with `agent-skills` conventions.**
+  All six built-in scaffolds (`default`, `llm`, `search`, `finance`,
+  `twitter`, `video`) now emit:
+  - `homepage: https://aisa.one` (was `https://openclaw.ai`)
+  - `metadata.aisa.*` instead of `metadata.openclaw.*`
+  - `compatibility: ["openclaw", "claude-code", "hermes"]` to match the
+    shape used by `marketpulse`, `multi-source-search`,
+    `prediction-market-arbitrage`, and the rest of the live skills.
+
+  Skills scaffolded with `aisa skills init` will now render correctly in
+  the registry and pass review when contributed back upstream.
+  ([#5](https://github.com/AIsa-team/cli/pull/5))
+
+### Documentation
+
+- README Skills section now references
+  [`AIsa-team/agent-skills`](https://github.com/AIsa-team/agent-skills)
+  directly instead of the renamed `OpenClaw-Skills`.
+  ([#2](https://github.com/AIsa-team/cli/pull/2))
+
+## [0.2.0] — Initial public release
+
+- LLM gateway commands (`aisa chat`, `aisa models`).
+- API discovery and execution (`aisa run`, `aisa api …` WIP).
+- Web search (`aisa web-search`, `aisa scholar`).
+- Finance (`aisa stock`, `aisa crypto`, `aisa screener`).
+- Twitter/X (`aisa twitter …`, `aisa tweet`).
+- Video generation (`aisa video create|status`).
+- Skills registry (`aisa skills list|search|show|install|remove|init`).
+- MCP server auto-config (`aisa mcp setup|status`).
+- Config commands (`aisa config get|set|list|reset`) and auth
+  (`aisa login|logout|whoami`).
+
+[Unreleased]: https://github.com/AIsa-team/cli/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/AIsa-team/cli/releases/tag/v0.2.0

package/README.md

@@ -47,14 +47,14 @@ aisa whoami               # Show auth status
 Chat with 70+ models (GPT, Claude, Gemini, Qwen, Deepseek, Grok) through a single OpenAI-compatible endpoint.
 
 ```bash
-aisa chat "your message" --model gpt-4.1
+aisa chat "your message" --model gpt-4.1-mini
 aisa chat "explain this" --model claude-opus-4-6 --stream
 aisa chat "respond in JSON" --model gemini-2.5-pro --json
 echo "summarize this" | aisa chat                        # pipe support
 
 aisa models                          # list all models
 aisa models --provider anthropic     # filter by provider
-aisa models show gpt-4.1             # model details
+aisa models show gpt-4.1-mini        # model details
 ```
 
 ### API Discovery & Execution
@@ -121,16 +121,16 @@ aisa usage --limit 20       # 🚧 WIP
 
 ## Skills
 
-Skills are markdown files that teach AI coding agents (Claude Code, Cursor, Copilot, etc.) how to use AISA APIs. Skills are sourced from the [OpenClaw-Skills](https://github.com/AIsa-team/OpenClaw-Skills) repository.
+Skills are markdown files that teach AI coding agents (Claude Code, Cursor, Copilot, etc.) how to use AISA APIs. Skills are sourced from the [agent-skills](https://github.com/AIsa-team/agent-skills) repository.
 
 ### Browse & Install
 
 ```bash
 aisa skills list                              # list all available skills
 aisa skills search "financial analysis"       # search by keyword
-aisa skills show market                       # show skill details
-aisa skills install market                     # install to agent directories
-aisa skills remove market                     # uninstall
+aisa skills show marketpulse                  # show skill details
+aisa skills install marketpulse               # install to agent directories
+aisa skills remove marketpulse                # uninstall
 ```
 
 Skills install to agent directories automatically:
@@ -155,7 +155,7 @@ aisa skills init my-skill --template llm           # LLM template
 
 Available templates: `default`, `llm`, `search`, `finance`, `twitter`, `video`
 
-To publish a skill, submit a pull request to [AIsa-team/OpenClaw-Skills](https://github.com/AIsa-team/OpenClaw-Skills).
+To publish a skill, submit a pull request to [AIsa-team/agent-skills](https://github.com/AIsa-team/agent-skills).
 
 ## MCP Server
 
@@ -178,7 +178,7 @@ aisa config reset                               # reset to defaults
 ```
 
 Settings:
-- `defaultModel` — default model for `aisa chat` (default: `gpt-4.1`)
+- `defaultModel` — default model for `aisa chat` (default: `gpt-4.1-mini`)
 - `baseUrl` — API base URL (default: `https://api.aisa.one`)
 - `outputFormat` — output format: `text` or `json`
 

package/dist/agent/env-setup.d.ts

@@ -0,0 +1,5 @@
+import type { AgentManifest } from "@aisa-one/agent-spec";
+export type Prompt = (question: string) => Promise<string>;
+export declare function collectEnv(manifest: AgentManifest, existingEnvText: string | null, deps?: {
+    prompt?: Prompt;
+}): Promise<string>;

package/dist/agent/env-setup.js

@@ -0,0 +1,49 @@
+import { getApiKey } from "../config.js";
+function parseEnvText(text) {
+    const map = new Map();
+    for (const line of (text ?? "").split("\n")) {
+        const m = line.match(/^([A-Z][A-Z0-9_]*)=(.*)$/);
+        if (m && m[2] !== "")
+            map.set(m[1], m[2]);
+    }
+    return map;
+}
+export async function collectEnv(manifest, existingEnvText, deps = {}) {
+    const prompt = deps.prompt ?? (async () => "");
+    const existing = parseEnvText(existingEnvText);
+    const values = new Map(existing);
+    // .env is user keys only. System defaults travel in the artifact's
+    // agent.json (render reads them; the installer passes them as process
+    // env for old artifacts). Legacy installs seeded system vars into .env
+    // — strip them, or updates would freeze them forever (HERMES_HOME even
+    // overrides hermes' --profile switch).
+    for (const legacy of ["HERMES_HOME", "PROFILE_ID", "MODEL_DEFAULT", "MODEL_PROVIDER"])
+        values.delete(legacy);
+    for (const v of manifest.env.required) {
+        if (values.has(v.name))
+            continue;
+        let val = process.env[v.name] || "";
+        if (!val && v.name === "AISA_API_KEY")
+            val = getApiKey() ?? "";
+        if (!val)
+            val = await prompt(`${v.name} (${v.description}): `);
+        if (!val)
+            throw new Error(`missing required ${v.name} — set it in your environment` +
+                (v.name === "AISA_API_KEY" ? ` or run "aisa login --key <key>"` : ""));
+        values.set(v.name, val);
+    }
+    const lines = [
+        `# ${manifest.name} — profile environment (managed by aisa agent install)`,
+    ];
+    for (const [k, v] of values)
+        lines.push(`${k}=${v}`);
+    for (const v of manifest.env.optional) {
+        if (values.has(v.name))
+            continue;
+        if (process.env[v.name])
+            lines.push(`${v.name}=${process.env[v.name]}`);
+        else
+            lines.push(`# ${v.name}=  (${v.description}${v.degrade ? `; degrade: ${v.degrade}` : ""})`);
+    }
+    return lines.join("\n") + "\n";
+}

package/dist/agent/index-client.d.ts

@@ -0,0 +1,7 @@
+import { type AgentIndex } from "@aisa-one/agent-spec";
+export declare const DEFAULT_INDEX_URL = "https://raw.githubusercontent.com/AIsa-team/agent-index/main/index.json";
+export type FetchLike = (url: string, init?: RequestInit) => Promise<Response>;
+export declare function indexUrl(): string;
+export declare function fetchIndex(fetchImpl?: FetchLike): Promise<AgentIndex>;
+export declare function requireAgent(index: AgentIndex, id: string): AgentIndex["agents"][string];
+export declare function siblingAssetUrl(artifactUrl: string, filename: string): string;

package/dist/agent/index-client.js

@@ -0,0 +1,22 @@
+import { parseIndex } from "@aisa-one/agent-spec";
+export const DEFAULT_INDEX_URL = "https://raw.githubusercontent.com/AIsa-team/agent-index/main/index.json";
+export function indexUrl() {
+    return process.env.AISA_AGENT_INDEX_URL || DEFAULT_INDEX_URL;
+}
+export async function fetchIndex(fetchImpl = fetch) {
+    const res = await fetchImpl(indexUrl());
+    if (!res.ok)
+        throw new Error(`failed to fetch agent index (${res.status}): ${indexUrl()}`);
+    return parseIndex(await res.text());
+}
+export function requireAgent(index, id) {
+    const entry = index.agents[id];
+    if (!entry) {
+        const available = Object.keys(index.agents).sort().join(", ") || "(none)";
+        throw new Error(`unknown agent "${id}"\navailable agents: ${available}`);
+    }
+    return entry;
+}
+export function siblingAssetUrl(artifactUrl, filename) {
+    return artifactUrl.replace(/[^/]+$/, filename);
+}

package/dist/agent/installer.d.ts

@@ -0,0 +1,19 @@
+import { type AgentManifest } from "@aisa-one/agent-spec";
+import type { FetchLike } from "./index-client.js";
+export interface InstalledMarker {
+    id: string;
+    version: string;
+    target: "hermes";
+    pinned: boolean;
+}
+export declare function hermesRoot(): string;
+export declare function profileDir(id: string): string;
+export declare function downloadArtifact(url: string, sha256: string, fetchImpl?: FetchLike): Promise<Buffer>;
+export declare function extractBundle(buf: Buffer, destDir: string): Promise<void>;
+export declare function readBundleManifest(destDir: string): Promise<AgentManifest>;
+export declare function writeMarker(destDir: string, m: InstalledMarker): Promise<void>;
+export declare function readMarker(dir: string): Promise<InstalledMarker | null>;
+export declare function listInstalled(): Promise<{
+    dir: string;
+    marker: InstalledMarker;
+}[]>;

package/dist/agent/installer.js

@@ -0,0 +1,70 @@
+import { mkdir, readFile, writeFile, readdir, rename, rm, mkdtemp } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import * as tar from "tar";
+import { parseManifest } from "@aisa-one/agent-spec";
+import { stringify as yamlStringify } from "yaml";
+import { expandHome } from "../utils/file.js";
+const MARKER = ".agentspec.json";
+export function hermesRoot() {
+    return expandHome(process.env.HERMES_HOME || "~/.hermes");
+}
+export function profileDir(id) {
+    return join(hermesRoot(), "profiles", id);
+}
+export async function downloadArtifact(url, sha256, fetchImpl = fetch) {
+    const res = await fetchImpl(url);
+    if (!res.ok)
+        throw new Error(`download failed (${res.status}): ${url}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    const actual = createHash("sha256").update(buf).digest("hex");
+    if (actual !== sha256)
+        throw new Error(`sha256 mismatch for ${url}\n  expected ${sha256}\n  actual   ${actual}`);
+    return buf;
+}
+export async function extractBundle(buf, destDir) {
+    const tmp = await mkdtemp(join(tmpdir(), "aisa-agent-"));
+    const tarPath = join(tmp, "bundle.tar.gz");
+    await writeFile(tarPath, buf);
+    await mkdir(destDir, { recursive: true });
+    await tar.x({ file: tarPath, cwd: destDir });
+    // promote profile/ contents to the root (hermes profile layout)
+    const profileSub = join(destDir, "profile");
+    if (existsSync(profileSub)) {
+        for (const name of await readdir(profileSub)) {
+            await rm(join(destDir, name), { recursive: true, force: true });
+            await rename(join(profileSub, name), join(destDir, name));
+        }
+        await rm(profileSub, { recursive: true, force: true });
+    }
+}
+export async function readBundleManifest(destDir) {
+    const raw = JSON.parse(await readFile(join(destDir, "agent.json"), "utf8"));
+    return parseManifest(yamlStringify(raw)); // 复用 schema 校验(YAML 是 JSON 超集)
+}
+export async function writeMarker(destDir, m) {
+    await writeFile(join(destDir, MARKER), JSON.stringify(m, null, 2) + "\n");
+}
+export async function readMarker(dir) {
+    try {
+        return JSON.parse(await readFile(join(dir, MARKER), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function listInstalled() {
+    const root = join(hermesRoot(), "profiles");
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    for (const name of await readdir(root)) {
+        const dir = join(root, name);
+        const marker = await readMarker(dir);
+        if (marker)
+            out.push({ dir, marker });
+    }
+    return out.sort((a, b) => a.marker.id.localeCompare(b.marker.id));
+}

package/dist/agent/setup-python.d.ts

@@ -0,0 +1,15 @@
+import type { AgentManifest } from "@aisa-one/agent-spec";
+export type Exec = (cmd: string, args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export declare const SKIP_OPTIONAL_ENV = "AGENT_SKIP_OPTIONAL_SETUP";
+export declare const SETUP_PYTHON_ENV = "AGENT_SETUP_PYTHON";
+export interface SetupResult {
+    name: string;
+    status: "ok" | "skipped" | "failed";
+}
+/** Build the venvs declared in manifest.setup.python and point their env vars
+ *  at the venv interpreters (written into <profileDir>/.env). */
+export declare function runPythonSetup(manifest: AgentManifest, profileDir: string, exec: Exec): Promise<SetupResult[]>;

package/dist/agent/setup-python.js

@@ -0,0 +1,51 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export const SKIP_OPTIONAL_ENV = "AGENT_SKIP_OPTIONAL_SETUP";
+// venv 基础解释器覆盖(如系统 python3 过旧时指向 python3.12)
+export const SETUP_PYTHON_ENV = "AGENT_SETUP_PYTHON";
+async function upsertEnvLine(dir, key, value) {
+    const envPath = join(dir, ".env");
+    const text = existsSync(envPath) ? await readFile(envPath, "utf8") : "";
+    const lines = text.split("\n").filter((l) => !l.startsWith(`${key}=`));
+    while (lines.length && lines[lines.length - 1] === "")
+        lines.pop();
+    lines.push(`${key}=${value}`);
+    await writeFile(envPath, lines.join("\n") + "\n");
+}
+/** Build the venvs declared in manifest.setup.python and point their env vars
+ *  at the venv interpreters (written into <profileDir>/.env). */
+export async function runPythonSetup(manifest, profileDir, exec) {
+    const skipOptional = process.env[SKIP_OPTIONAL_ENV] === "1";
+    const results = [];
+    for (const s of manifest.setup.python) {
+        if (s.optional && skipOptional) {
+            console.log(`setup ${s.name}: optional, skipped (${SKIP_OPTIONAL_ENV}=1)`);
+            results.push({ name: s.name, status: "skipped" });
+            continue;
+        }
+        const venvDir = join(profileDir, ".venvs", s.name);
+        const venvPython = join(venvDir, "bin", "python");
+        const reqPath = join(profileDir, s.requirements);
+        const basePython = process.env[SETUP_PYTHON_ENV] || "python3";
+        console.log(`setup ${s.name}: building venv (${s.requirements})…`);
+        const created = await exec(basePython, ["-m", "venv", venvDir]);
+        const installed = created.code === 0
+            ? await exec(venvPython, ["-m", "pip", "install", "-r", reqPath])
+            : created;
+        if (installed.code !== 0) {
+            const detail = installed.stderr.slice(-500);
+            if (!s.optional)
+                throw new Error(`setup ${s.name} failed (required):\n${detail}`);
+            console.log(`setup ${s.name}: failed, degrading (optional). ${s.description ?? ""}`);
+            if (detail.trim())
+                console.log(`  reason: ${detail.trim().split("\n").slice(-3).join(" | ")}`);
+            results.push({ name: s.name, status: "failed" });
+            continue;
+        }
+        await upsertEnvLine(profileDir, s.env, venvPython);
+        console.log(`setup ${s.name}: ok -> ${s.env}=${venvPython}`);
+        results.push({ name: s.name, status: "ok" });
+    }
+    return results;
+}

package/dist/api.d.ts

@@ -1,4 +1,3 @@
-import { type Response } from "node-fetch";
 import type { ApiResponse } from "./types.js";
 export interface RequestOptions {
     method?: "GET" | "POST" | "PUT" | "DELETE";

package/dist/api.js

@@ -1,4 +1,3 @@
-import fetch from "node-fetch";
 import { CLI_BASE_URL, APIS_BASE_URL } from "./constants.js";
 import { getConfig } from "./config.js";
 function getBaseUrl() {

package/dist/commands/agent.d.ts

@@ -0,0 +1,37 @@
+import { type FetchLike } from "../agent/index-client.js";
+import { type Prompt } from "../agent/env-setup.js";
+import type { AgentIndex } from "@aisa-one/agent-spec";
+export type Exec = (cmd: string, args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export declare function agentListAction(_opts: Record<string, never>, deps?: {
+    fetchImpl?: FetchLike;
+}): Promise<AgentIndex>;
+export declare function agentInfoAction(id: string, deps?: {
+    fetchImpl?: FetchLike;
+}): Promise<AgentIndex["agents"][string]>;
+export declare function agentInstallAction(id: string, opts: {
+    version?: string;
+    runtime?: string;
+}, deps?: {
+    fetchImpl?: FetchLike;
+    prompt?: Prompt;
+    exec?: Exec;
+}): Promise<void>;
+export declare function agentUpdateAction(id: string | undefined, _opts: Record<string, never>, deps?: {
+    fetchImpl?: FetchLike;
+    prompt?: Prompt;
+    exec?: Exec;
+}): Promise<{
+    id: string;
+    from: string;
+    to: string;
+    status: "updated" | "up-to-date" | "pinned";
+}[]>;
+export declare function agentGuideAction(id: string, opts: {
+    md?: boolean;
+}, deps?: {
+    fetchImpl?: FetchLike;
+}): Promise<string>;

package/dist/commands/agent.js

@@ -0,0 +1,129 @@
+import chalk from "chalk";
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { execFile } from "node:child_process";
+import { table, success, hint, truncate } from "../utils/display.js";
+import { fetchIndex, requireAgent, siblingAssetUrl } from "../agent/index-client.js";
+import { hermesRoot, profileDir, downloadArtifact, extractBundle, readBundleManifest, writeMarker, listInstalled, } from "../agent/installer.js";
+import { collectEnv } from "../agent/env-setup.js";
+import { runPythonSetup } from "../agent/setup-python.js";
+const realExec = (cmd, args) => new Promise((resolve) => {
+    execFile(cmd, args, (err, stdout, stderr) => resolve({ code: err ? 1 : 0, stdout: String(stdout), stderr: String(stderr) }));
+});
+export async function agentListAction(_opts, deps = {}) {
+    const index = await fetchIndex(deps.fetchImpl);
+    const rows = Object.entries(index.agents).sort(([a], [b]) => a.localeCompare(b))
+        .map(([id, e]) => [id, e.name, e.latest, truncate(e.description, 60)]);
+    console.log(table(["ID", "NAME", "LATEST", "DESCRIPTION"], rows));
+    hint(`install one with: aisa agent install <id>`);
+    return index;
+}
+export async function agentInfoAction(id, deps = {}) {
+    const index = await fetchIndex(deps.fetchImpl);
+    const e = requireAgent(index, id);
+    console.log(`${chalk.bold(e.name)} (${id})`);
+    console.log(`  ${e.description}`);
+    console.log(`  repo:   https://github.com/${e.repo}`);
+    console.log(`  latest: ${e.latest}`);
+    for (const [v, spec] of Object.entries(e.versions))
+        console.log(`  ${v}: targets ${Object.keys(spec.targets).join(", ")}`);
+    hint(`install with: aisa agent install ${id}`);
+    return e;
+}
+export async function agentInstallAction(id, opts, deps = {}) {
+    const runtime = opts.runtime ?? "hermes";
+    if (runtime !== "hermes")
+        throw new Error(`runtime "${runtime}" not supported yet — v1 supports: hermes`);
+    if (!existsSync(hermesRoot()))
+        throw new Error(`hermes not found at ${hermesRoot()} — install it first:\n` +
+            `  curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash`);
+    const index = await fetchIndex(deps.fetchImpl);
+    const entry = requireAgent(index, id);
+    const version = opts.version ?? entry.latest;
+    const versionSpec = entry.versions[version];
+    if (!versionSpec)
+        throw new Error(`version ${version} not found for ${id} — available: ${Object.keys(entry.versions).join(", ")}`);
+    const artifact = versionSpec.targets[runtime];
+    if (!artifact)
+        throw new Error(`no ${runtime} artifact for ${id}@${version}`);
+    const dir = profileDir(id);
+    const existingEnv = existsSync(join(dir, ".env"))
+        ? await readFile(join(dir, ".env"), "utf8") : null;
+    const buf = await downloadArtifact(artifact.url, artifact.sha256, deps.fetchImpl);
+    await extractBundle(buf, dir);
+    const manifest = await readBundleManifest(dir);
+    const envText = await collectEnv(manifest, existingEnv, { prompt: deps.prompt });
+    await writeFile(join(dir, ".env"), envText);
+    const exec = deps.exec ?? realExec;
+    // system vars go to render as process env, never into .env — new render.sh
+    // reads them from the bundled agent.json itself, old artifacts (≤1.0.4)
+    // still require them in the environment
+    const r = await exec("env", [
+        `PROFILE_ID=${manifest.id}`,
+        `MODEL_DEFAULT=${manifest.models.default}`,
+        `MODEL_PROVIDER=${manifest.models.provider}`,
+        "bash", join(dir, "scripts", "render.sh"), dir,
+    ]);
+    if (r.code !== 0)
+        throw new Error(`render failed: ${r.stderr}`);
+    await runPythonSetup(manifest, dir, exec);
+    await writeMarker(dir, {
+        id, version, target: "hermes",
+        pinned: !!opts.version || manifest.update.channel === "pinned",
+    });
+    success(`installed ${entry.name} ${version} -> ${dir}`);
+    hint(`start it with: hermes --profile ${id}`);
+}
+export async function agentUpdateAction(id, _opts, deps = {}) {
+    const installed = await listInstalled();
+    const targets = id ? installed.filter((i) => i.marker.id === id) : installed;
+    if (id && targets.length === 0)
+        throw new Error(`agent "${id}" is not installed (no .agentspec.json marker found)`);
+    if (targets.length === 0) {
+        hint("no installed agents found");
+        return [];
+    }
+    const index = await fetchIndex(deps.fetchImpl);
+    const results = [];
+    for (const { marker } of targets) {
+        if (marker.pinned) {
+            console.log(`${marker.id}: pinned at ${marker.version} — skipping`);
+            results.push({ id: marker.id, from: marker.version, to: marker.version, status: "pinned" });
+            continue;
+        }
+        const entry = index.agents[marker.id];
+        if (!entry || entry.latest === marker.version) {
+            results.push({ id: marker.id, from: marker.version, to: marker.version, status: "up-to-date" });
+            continue;
+        }
+        await agentInstallAction(marker.id, {}, deps); // install 已保留 .env、更新 marker
+        results.push({ id: marker.id, from: marker.version, to: entry.latest, status: "updated" });
+    }
+    for (const r of results)
+        if (r.status === "updated")
+            success(`${r.id}: ${r.from} -> ${r.to}`);
+    return results;
+}
+export async function agentGuideAction(id, opts, deps = {}) {
+    const fetchImpl = deps.fetchImpl ?? fetch;
+    const index = await fetchIndex(deps.fetchImpl);
+    const entry = requireAgent(index, id);
+    const artifact = entry.versions[entry.latest]?.targets["hermes"];
+    if (!artifact)
+        throw new Error(`no hermes artifact for ${id}@${entry.latest}`);
+    // 优先读索引携带的资产 URL(2026-07-15 起 publish 写入);老条目回落到
+    // legacy 裸文件名拼接,保证旧版本 Release 仍可用
+    const url = opts.md
+        ? (artifact.installMd ?? siblingAssetUrl(artifact.url, "INSTALL.md"))
+        : (artifact.guidePrompt ?? siblingAssetUrl(artifact.url, "guide-prompt.txt"));
+    const filename = url.split("/").pop();
+    const res = await fetchImpl(url);
+    if (!res.ok)
+        throw new Error(`failed to fetch ${filename} (${res.status}): ${url}`);
+    const text = await res.text();
+    console.log(text);
+    if (!opts.md)
+        hint("paste the text above into your local AI agent (Claude Code, hermes, …)");
+    return text;
+}

package/dist/commands/chat.js

@@ -23,7 +23,7 @@ export async function chatAction(message, options) {
         error("Empty message");
         process.exit(1);
     }
-    const model = options.model || getConfig("defaultModel") || "gpt-4.1";
+    const model = options.model || getConfig("defaultModel") || "gpt-4.1-mini";
     const stream = options.stream !== false; // default true
     const messages = [];
     if (options.system) {

package/dist/commands/run.js

@@ -31,7 +31,7 @@ export async function runAction(slug, path, options) {
     }
     // Detect method
     const method = (options.method || (body ? "POST" : "GET")).toUpperCase();
-    const endpoint = `${slug}${path}`;
+    const endpoint = path.startsWith("/") ? `${slug}${path}` : `${slug}/${path}`;
     // Auto-detect domain API vs LLM API based on slug
     const domainSlugs = ["financial", "search", "youtube", "scholar", "tavily", "querit", "twitter", "services", "crypto"];
     const isDomain = domainSlugs.some((s) => slug.startsWith(s));

package/dist/commands/skills.js

@@ -2,12 +2,11 @@ import ora from "ora";
 import chalk from "chalk";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
-import fetch from "node-fetch";
 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";
 // --- GitHub-backed skill registry ---
-const SKILLS_REPO = "AIsa-team/OpenClaw-Skills";
+const SKILLS_REPO = "AIsa-team/agent-skills";
 const GH_API = `https://api.github.com/repos/${SKILLS_REPO}`;
 const GH_RAW = `https://raw.githubusercontent.com/${SKILLS_REPO}/main`;
 /** Fetch the repo tree and extract top-level skill folder names. */
@@ -48,7 +47,8 @@ function parseSkillFrontmatter(slug, content) {
     if (metaMatch) {
         try {
             const meta = JSON.parse(metaMatch[1]);
-            info.emoji = meta?.openclaw?.emoji || "";
+            // agent-skills repo uses metadata.aisa; legacy skills used metadata.openclaw.
+            info.emoji = meta?.aisa?.emoji || meta?.openclaw?.emoji || "";
         }
         catch {
             // ignore malformed metadata
@@ -80,8 +80,8 @@ const TEMPLATES = {
     default: `---
 name: my-skill
 description: "Describe what this skill does."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # My Skill
@@ -103,8 +103,8 @@ aisa run <slug> <path> -q "param=value"
     llm: `---
 name: llm-assistant
 description: "Use AISA's unified LLM gateway to chat with 70+ AI models."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"🤖","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # LLM Assistant Skill
@@ -120,7 +120,7 @@ export AISA_API_KEY=sk-your-key
 ## Chat Completion
 
 \`\`\`bash
-aisa chat "Your question here" --model gpt-4.1
+aisa chat "Your question here" --model gpt-4.1-mini
 \`\`\`
 
 ## Streaming
@@ -139,8 +139,8 @@ aisa models --provider anthropic
     search: `---
 name: web-search
 description: "Search the web, YouTube, and academic papers via AISA APIs."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"🔍","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"🔍","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # Web Search Skill
@@ -174,8 +174,8 @@ aisa scholar "transformer architecture"
     finance: `---
 name: finance-analyst
 description: "Access stock prices, earnings, SEC filings, and financial data via AISA."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"📊","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"📊","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # Finance Analyst Skill
@@ -206,8 +206,8 @@ aisa crypto ETH --period 30d
     twitter: `---
 name: twitter-manager
 description: "Search Twitter, get user profiles and trends via AISA."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"🐦","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"🐦","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # Twitter Manager Skill
@@ -241,8 +241,8 @@ aisa twitter trends
     video: `---
 name: video-generator
 description: "Generate videos from text prompts using AISA's video synthesis API."
-homepage: https://openclaw.ai
-metadata: {"openclaw":{"emoji":"🎬","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}
+homepage: https://aisa.one
+metadata: {"aisa":{"emoji":"🎬","requires":{"bins":["curl"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]}}
 ---
 
 # Video Generator Skill

package/dist/commands/twitter.js

@@ -1,6 +1,5 @@
 import ora from "ora";
 import chalk from "chalk";
-import fetch from "node-fetch";
 import { requireApiKey, getConfig, setConfig } from "../config.js";
 import { apiRequest } from "../api.js";
 import { APIS_BASE_URL } from "../constants.js";
@@ -333,9 +332,10 @@ export async function twitterUploadMediaAction(filePath, options) {
     const spinner = ora("Uploading media...").start();
     let formData;
     try {
-        const { FormData: NFFormData, fileFromSync } = await import("node-fetch");
-        formData = new NFFormData();
-        formData.append("file", fileFromSync(filePath));
+        const { readFileSync } = await import("node:fs");
+        const { basename } = await import("node:path");
+        formData = new FormData();
+        formData.append("file", new Blob([readFileSync(filePath)]), basename(filePath));
     }
     catch {
         spinner.fail("Failed to read file");

package/dist/config.js

@@ -4,7 +4,7 @@ const config = new Conf({
     projectName: "aisa-cli",
     schema: {
         apiKey: { type: "string", default: "" },
-        defaultModel: { type: "string", default: "gpt-4.1" },
+        defaultModel: { type: "string", default: "gpt-4.1-mini" },
         baseUrl: { type: "string", default: "https://api.aisa.one/v1" },
         outputFormat: { type: "string", default: "text" },
         twitterCookies: { type: "string", default: "" },

package/dist/index.js

@@ -107,7 +107,7 @@ program
 program
     .command("chat [message]")
     .description("Chat with AI models via the AISA gateway")
-    .option("--model <model>", "Model ID (default: gpt-4.1)")
+    .option("--model <model>", "Model ID (default: gpt-4.1-mini)")
     .option("--system <prompt>", "System prompt")
     .option("--no-stream", "Disable streaming")
     .option("--json", "Output raw JSON response")

package/dist/utils/streaming.d.ts

@@ -1,4 +1,3 @@
-import type { Response } from "node-fetch";
 export declare function handleSSEStream(res: Response, onToken: (token: string) => void, onDone?: (usage?: {
     prompt_tokens: number;
     completion_tokens: number;

package/dist/utils/streaming.js

@@ -2,10 +2,11 @@ export async function handleSSEStream(res, onToken, onDone) {
     const body = res.body;
     if (!body)
         throw new Error("No response body");
+    const decoder = new TextDecoder();
     let buffer = "";
     let usage;
     for await (const chunk of body) {
-        buffer += chunk.toString();
+        buffer += decoder.decode(chunk, { stream: true });
         const lines = buffer.split("\n");
         buffer = lines.pop() || "";
         for (const line of lines) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisa-one/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",
@@ -26,7 +26,6 @@
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "^12.0.0",
-    "node-fetch": "^3.3.2",
     "ora": "^8.0.1"
   },
   "devDependencies": {

package/tests/streaming.test.ts

@@ -0,0 +1,73 @@
+import { describe, it, expect } from "vitest";
+import { handleSSEStream } from "../src/utils/streaming.js";
+
+function sseResponse(chunks: string[]): Response {
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream<Uint8Array>({
+    start(controller) {
+      for (const chunk of chunks) {
+        controller.enqueue(encoder.encode(chunk));
+      }
+      controller.close();
+    },
+  });
+  return new Response(stream);
+}
+
+describe("handleSSEStream", () => {
+  it("emits tokens from a native fetch Response body", async () => {
+    const res = sseResponse([
+      'data: {"choices":[{"delta":{"content":"Hello"}}]}\n\n',
+      'data: {"choices":[{"delta":{"content":" world"}}]}\n\n',
+      "data: [DONE]\n\n",
+    ]);
+
+    const tokens: string[] = [];
+    let done = false;
+    await handleSSEStream(
+      res,
+      (t) => tokens.push(t),
+      () => {
+        done = true;
+      }
+    );
+
+    expect(tokens.join("")).toBe("Hello world");
+    expect(done).toBe(true);
+  });
+
+  it("handles multi-byte characters split across chunks", async () => {
+    const encoder = new TextEncoder();
+    const line = encoder.encode(
+      'data: {"choices":[{"delta":{"content":"你好"}}]}\n\ndata: [DONE]\n\n'
+    );
+    // split in the middle of a multi-byte character
+    const stream = new ReadableStream<Uint8Array>({
+      start(controller) {
+        controller.enqueue(line.slice(0, 40));
+        controller.enqueue(line.slice(40));
+        controller.close();
+      },
+    });
+    const res = new Response(stream);
+
+    const tokens: string[] = [];
+    await handleSSEStream(res, (t) => tokens.push(t));
+
+    expect(tokens.join("")).toBe("你好");
+  });
+
+  it("reports usage to onDone", async () => {
+    const res = sseResponse([
+      'data: {"choices":[{"delta":{"content":"hi"}}],"usage":{"prompt_tokens":3,"completion_tokens":1}}\n\n',
+      "data: [DONE]\n\n",
+    ]);
+
+    let usage: { prompt_tokens: number; completion_tokens: number } | undefined;
+    await handleSSEStream(res, () => {}, (u) => {
+      usage = u;
+    });
+
+    expect(usage).toEqual({ prompt_tokens: 3, completion_tokens: 1 });
+  });
+});