echopai 2.2.0 → 2.4.0

package/dist/runtime/tty.js

@@ -1,51 +0,0 @@
-/**
- * TTY 检测 + 极小 ANSI 着色（无依赖，避免 chalk/ora 拖慢 CLI 启动）。
- *
- * 启用规则：
- *   - process.stdout.isTTY === true
- *   - !process.env.CI
- *   - !process.env.NO_COLOR
- *   - process.env.TERM !== 'dumb'
- *
- * 任一失败 → color() / dim() / errSym() 返回原文（脚本/AI 场景纯洁）。
- */
-const enable = (() => {
-    if (!process.stderr.isTTY)
-        return false;
-    if (process.env.CI)
-        return false;
-    if (process.env.NO_COLOR)
-        return false;
-    if (process.env.TERM === "dumb")
-        return false;
-    return true;
-})();
-export const isTtyHuman = enable;
-const ESC = "[";
-function ansi(code, s) {
-    if (!enable)
-        return s;
-    return `${ESC}${code}m${s}${ESC}0m`;
-}
-export const red = (s) => ansi("31", s);
-export const green = (s) => ansi("32", s);
-export const yellow = (s) => ansi("33", s);
-export const cyan = (s) => ansi("36", s);
-export const dim = (s) => ansi("2", s);
-export const bold = (s) => ansi("1", s);
-/**
- * 把 error envelope 渲染成多行人性化文字（仅 TTY）。
- * 非 TTY 直接 JSON.stringify。
- */
-export function renderError(env) {
-    if (!enable)
-        return JSON.stringify(env);
-    const e = env.error;
-    const label = `${red(bold("✗ " + e.code))}${e.retryable ? " " + dim("(retryable)") : ""}`;
-    const lines = [`${label} ${dim("—")} ${e.message}`];
-    if (e.recovery_hint)
-        lines.push(`  ${cyan("hint:")} ${e.recovery_hint}`);
-    if (e.request_id)
-        lines.push(`  ${dim("request_id: " + e.request_id)}`);
-    return lines.join("\n");
-}

package/dist/runtime/verb_cmd.js

@@ -1,70 +0,0 @@
-/**
- * Shared scaffolding for curated agent verbs.
- *
- * 每个 verb 都做同样三件事：解析 credential → 调一次或多次 callOp → emit
- * envelope + exit。本模块把样板抽出，让 verb 实现只关心"参数 → 派生 args → 映射
- * 输出"。
- *
- * 与 verb_runner.ts 的区别：
- * - verb_runner: 纯 HTTP/Ajv 层，不知道 commander / exit / stderr renderer
- * - verb_cmd:    process / commander 层 ergonomics，把 runner 包成"一行起 verb"
- */
-import { resolveCredentials, AuthMissingError } from "./auth.js";
-import { CallApiError } from "./errors.js";
-import { isTtyHuman, renderError } from "./tty.js";
-import { CLI_VERSION } from "../version.js";
-/**
- * Run a verb handler end-to-end:
- *   1. Resolve credentials (auth_missing → exit 1)
- *   2. Invoke handler with ctx
- *   3. Print stdout envelope + exit 0 on success
- *   4. Map CallApiError → structured stderr + exit 1/2 by HTTP class
- */
-export async function executeVerb(handler) {
-    let creds;
-    try {
-        creds = resolveCredentials({});
-    }
-    catch (e) {
-        if (e instanceof AuthMissingError) {
-            emitVerbError("auth_missing", e.message, e.recovery_hint, 1);
-        }
-        throw e;
-    }
-    try {
-        const env = await handler({
-            baseUrl: creds.baseUrl,
-            bearer: creds.key,
-            cliVersion: CLI_VERSION,
-        });
-        process.stdout.write(JSON.stringify(env) + "\n");
-        process.exit(0);
-    }
-    catch (e) {
-        if (e instanceof CallApiError) {
-            emitVerbError(e.code, e.message, e.recovery_hint, e.httpStatus && e.httpStatus < 500 ? 1 : 2, e.requestId);
-        }
-        // unexpected error: structured emit, exit 2
-        emitVerbError("internal_error", e instanceof Error ? e.message : String(e), undefined, 2);
-    }
-}
-export function emitVerbError(code, message, recoveryHint, exitCode, requestId) {
-    const env = {
-        error: {
-            code,
-            message,
-            retryable: false,
-            ...(recoveryHint ? { recovery_hint: recoveryHint } : {}),
-            ...(requestId ? { request_id: requestId } : {}),
-        },
-    };
-    if (isTtyHuman) {
-        process.stderr.write(renderError(env) + "\n");
-    }
-    else {
-        process.stderr.write(JSON.stringify(env) + "\n");
-    }
-    process.exit(exitCode);
-}
-/** Re-export for verb-local convenience. */
-export { CLI_VERSION };

package/dist/runtime/verb_runner.js

@@ -1,152 +0,0 @@
-/**
- * Programmatic operation runner — shared core for curated agent verbs.
- *
- * 与 invoker.ts 的关系：invoker.ts 是 commander 入口 (强耦合 process.exit / 错误
- * stderr 输出 / trace 记录)；本模块只做"调一次操作 → 返回 envelope"，便于 verb
- * 实现里组合多次调用 (e.g. digest fan-out) 或在调完后映射 output。
- *
- * 不做的事：
- * - --all 分页 (verb 自己决定要不要)
- * - WebSocket streaming (单帧场景不存在)
- * - Idempotency-Key 自动注入 (Phase 6 写 verb 显式控制)
- * - trace 写入 (调用方自己 trace)
- *
- * 错误：抛 CallApiError；调用方负责 catch + 决定 exit / 部分失败容错。
- */
-import AjvPkg from "ajv";
-import addFormatsPkg from "ajv-formats";
-import { fetch as undiciFetch } from "undici";
-import { buildResponseEnvelope } from "./envelope.js";
-import { CallApiError, tryParseErrorEnvelope } from "./errors.js";
-import { buildHttpHeaders, resolveRequestId } from "./http.js";
-const Ajv = (AjvPkg.default ??
-    AjvPkg);
-const addFormats = (addFormatsPkg.default ??
-    addFormatsPkg);
-const ajv = new Ajv({
-    allErrors: true,
-    useDefaults: true,
-    coerceTypes: "array",
-    strict: false,
-});
-addFormats(ajv);
-/**
- * Invoke a single OpenAPI operation programmatically. Returns the standard
- * response envelope; throws CallApiError on failure (network / HTTP 4xx-5xx /
- * malformed response).
- *
- * Validation:
- * - Pre-flight Ajv validates `args` against `op.inputSchema`. On validation
- *   failure, throws CallApiError(code="invalid_args").
- *
- * Path templating: occurrences of `{name}` in `op.path` are substituted from
- * `args[name]` and removed from query.
- */
-export async function callOp(op, args, ctx) {
-    const params = { ...args };
-    // Pre-flight schema validation
-    const validate = ajv.compile(op.inputSchema);
-    if (!validate(params)) {
-        const errs = (validate.errors || [])
-            .map((e) => `${e.instancePath || "(root)"}: ${e.message ?? "invalid"}`)
-            .join("; ");
-        throw new CallApiError({
-            code: "invalid_args",
-            message: `Input validation failed: ${errs}`,
-        });
-    }
-    // Path templating
-    let url = ctx.baseUrl.replace(/\/+$/, "") + op.path;
-    const pathParamRegex = /\{([^}]+)\}/g;
-    const missingPathParam = [];
-    url = url.replace(pathParamRegex, (_full, name) => {
-        const v = params[name];
-        if (v === undefined) {
-            missingPathParam.push(name);
-            return _full;
-        }
-        delete params[name];
-        return encodeURIComponent(String(v));
-    });
-    if (missingPathParam.length > 0) {
-        throw new CallApiError({
-            code: "invalid_args",
-            message: `Path parameter(s) required: ${missingPathParam.join(", ")}`,
-        });
-    }
-    // Query / body
-    const qs = buildQueryString(params, op.method);
-    if (op.method === "GET" && qs)
-        url += "?" + qs;
-    const { headers, requestId: clientRequestId } = buildHttpHeaders({
-        bearer: ctx.bearer,
-        cliVersion: ctx.cliVersion,
-        ...(ctx.channel ? { channel: ctx.channel } : {}),
-    });
-    const init = { method: op.method, headers };
-    if (op.method === "POST") {
-        headers.set("Content-Type", "application/json");
-        init.body = JSON.stringify(params);
-    }
-    const fetchFn = ctx.fetchImpl ?? undiciFetch;
-    const startedAt = Date.now();
-    let res;
-    try {
-        res = await fetchFn(url, init);
-    }
-    catch (e) {
-        throw new CallApiError({
-            code: "network_error",
-            message: e instanceof Error ? e.message : String(e),
-        });
-    }
-    const requestId = resolveRequestId(res.headers.get("x-request-id"), clientRequestId);
-    const apiVersion = res.headers.get("x-api-version") || undefined;
-    const ct = res.headers.get("content-type") || "";
-    const bodyText = await res.text();
-    let bodyJson = null;
-    if (ct.includes("application/json") && bodyText) {
-        try {
-            bodyJson = JSON.parse(bodyText);
-        }
-        catch {
-            // non-JSON body — let error path below handle
-        }
-    }
-    const durationMs = Date.now() - startedAt;
-    if (res.status >= 400) {
-        const apiErr = tryParseErrorEnvelope(bodyJson, res.status, requestId);
-        if (apiErr)
-            throw apiErr;
-        throw new CallApiError({
-            code: "http_error",
-            message: `HTTP ${res.status} ${res.statusText}: ${bodyText.slice(0, 200)}`,
-            httpStatus: res.status,
-            requestId,
-        });
-    }
-    return buildResponseEnvelope(bodyJson ?? bodyText, {
-        requestId,
-        endpoint: op.path,
-        method: op.method,
-        cliVersion: ctx.cliVersion,
-        durationMs,
-        ...(apiVersion ? { apiVersion } : {}),
-    });
-}
-function buildQueryString(params, method) {
-    if (method !== "GET")
-        return "";
-    const parts = [];
-    for (const [k, v] of Object.entries(params)) {
-        if (v === undefined || v === null || v === "")
-            continue;
-        if (Array.isArray(v)) {
-            parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(v.join(","))}`);
-        }
-        else {
-            parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
-        }
-    }
-    return parts.join("&");
-}

package/dist/runtime/whoami_cache.js

@@ -1,109 +0,0 @@
-/**
- * /v1/auth/whoami client + 5-minute in-process cache.
- *
- * 设计原则：
- * - **单飞 (single-flight)**: 并发调用时只发一次真请求；多调用者共享 in-flight
- *   Promise。MCP serve 长 session 多并发 list-tools 场景下避免请求风暴。
- * - **TTL 5 分钟**: cache hit 后跨命令复用 (process 退出即失效)。shell one-shot
- *   每次多一次 whoami 调用；MCP server 长进程几乎永远 cache hit。
- * - **bearer 切换不复用**: cache key 含 bearer prefix，换 token 自动 miss。
- * - **best-effort 失败传播**: 网络 / auth 错误抛 CallApiError 上去由 caller
- *   决定 (doctor 显示 fail，whoami exit 2)。
- *
- * 不在这里做 verb 派生 / unavailable 列表计算——那是 tools/whoami.ts 的职责。
- */
-import { fetch as undiciFetch } from "undici";
-import { CallApiError, tryParseErrorEnvelope } from "./errors.js";
-import { buildHttpHeaders, resolveRequestId } from "./http.js";
-const DEFAULT_TTL_MS = 5 * 60 * 1000;
-let cache = null;
-let inflight = null;
-function cacheKey(ctx) {
-    // bearer 前 8 char + baseUrl 足以区分；不存全 bearer 避免日志 / dump 泄露。
-    return `${ctx.baseUrl}|${ctx.bearer.slice(0, 8)}|${ctx.channel ?? "cli"}`;
-}
-/** Test-only hook: reset module state between specs. */
-export function clearWhoamiCache() {
-    cache = null;
-    inflight = null;
-}
-/** Public read of cache without triggering fetch (returns null if miss/expired). */
-export function peekWhoamiCache(ctx) {
-    const k = cacheKey(ctx);
-    if (cache && cache.key === k && cache.expiresAt > Date.now())
-        return cache.resp;
-    return null;
-}
-export async function getWhoami(ctx, opts) {
-    const key = cacheKey(ctx);
-    const ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;
-    if (!opts?.force && cache && cache.key === key && cache.expiresAt > Date.now()) {
-        return cache.resp;
-    }
-    if (inflight && inflight.key === key) {
-        return inflight.promise;
-    }
-    const promise = doFetch(ctx, opts?.fetchImpl)
-        .then((resp) => {
-        cache = { key, resp, expiresAt: Date.now() + ttlMs };
-        return resp;
-    })
-        .finally(() => {
-        if (inflight && inflight.key === key)
-            inflight = null;
-    });
-    inflight = { key, promise };
-    return promise;
-}
-async function doFetch(ctx, fetchImpl) {
-    const fn = fetchImpl ?? undiciFetch;
-    const url = ctx.baseUrl.replace(/\/+$/, "") + "/v1/auth/whoami";
-    const { headers, requestId: clientRequestId } = buildHttpHeaders({
-        bearer: ctx.bearer,
-        cliVersion: ctx.cliVersion,
-        ...(ctx.channel ? { channel: ctx.channel } : {}),
-    });
-    let res;
-    try {
-        res = await fn(url, { method: "GET", headers });
-    }
-    catch (e) {
-        throw new CallApiError({
-            code: "network_error",
-            message: e instanceof Error ? e.message : String(e),
-        });
-    }
-    const requestId = resolveRequestId(res.headers.get("x-request-id"), clientRequestId);
-    const text = await res.text();
-    let json = null;
-    if (text) {
-        try {
-            json = JSON.parse(text);
-        }
-        catch {
-            // body not JSON — error path below will surface http_error
-        }
-    }
-    if (res.status >= 400) {
-        const env = tryParseErrorEnvelope(json, res.status, requestId);
-        if (env)
-            throw env;
-        throw new CallApiError({
-            code: "http_error",
-            message: `HTTP ${res.status} ${res.statusText}: ${text.slice(0, 200)}`,
-            httpStatus: res.status,
-            requestId,
-        });
-    }
-    if (typeof json !== "object" ||
-        json === null ||
-        !("data" in json)) {
-        throw new CallApiError({
-            code: "internal_error",
-            message: "whoami: response missing `data` envelope",
-            httpStatus: res.status,
-            requestId,
-        });
-    }
-    return json.data;
-}

package/dist/tools/api.js

@@ -1,81 +0,0 @@
-/**
- * `echopai api call <method> <path>` — DEPRECATED alias of `echopai raw call`.
- *
- * 保留一个 release 给老脚本，新代码请用 `echopai raw call`。
- * 行为同 raw call，但在调用时往 stderr 打 deprecation 提示一行。
- */
-import { Command } from "commander";
-import { fetch as undiciFetch, Headers } from "undici";
-import { resolveCredentials, AuthMissingError } from "../runtime/auth.js";
-import { CLI_VERSION } from "../version.js";
-export function buildApiCommand() {
-    const api = new Command("api").description("[DEPRECATED] Use `echopai raw call` instead — alias kept for one release");
-    api
-        .command("call <method> <path>")
-        .description("[DEPRECATED] Call <method> <path> — use `echopai raw call` instead")
-        .option("-d, --data <json>", "POST/PUT/PATCH body (JSON string)")
-        .option("-q, --query <kv...>", "Query string entries: k=v")
-        .option("--header <kv...>", "Extra headers: K=V")
-        .action(async (method, urlPath, opts) => {
-        process.stderr.write("[deprecated] `echopai api call` will be removed next major. Use `echopai raw call` instead.\n");
-        const m = method.toUpperCase();
-        if (!["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"].includes(m)) {
-            return die("invalid_args", `Unknown HTTP method: ${method}`, 1);
-        }
-        let creds;
-        try {
-            creds = resolveCredentials({});
-        }
-        catch (e) {
-            if (e instanceof AuthMissingError) {
-                return die("auth_missing", e.message, 1, e.recovery_hint);
-            }
-            throw e;
-        }
-        let url = creds.baseUrl + (urlPath.startsWith("/") ? urlPath : "/" + urlPath);
-        if (opts.query?.length) {
-            const qs = opts.query
-                .map((kv) => {
-                const idx = kv.indexOf("=");
-                if (idx === -1)
-                    return null;
-                return `${encodeURIComponent(kv.slice(0, idx))}=${encodeURIComponent(kv.slice(idx + 1))}`;
-            })
-                .filter((s) => s !== null)
-                .join("&");
-            if (qs)
-                url += (url.includes("?") ? "&" : "?") + qs;
-        }
-        const headers = new Headers({
-            Authorization: `Bearer ${creds.key}`,
-            "User-Agent": `echopai-cli/${CLI_VERSION}`,
-            Accept: "application/json",
-        });
-        if (opts.header) {
-            for (const kv of opts.header) {
-                const idx = kv.indexOf("=");
-                if (idx === -1)
-                    continue;
-                headers.set(kv.slice(0, idx), kv.slice(idx + 1));
-            }
-        }
-        const init = { method: m, headers };
-        if (opts.data) {
-            if (!headers.has("content-type"))
-                headers.set("content-type", "application/json");
-            init.body = opts.data;
-        }
-        const res = await undiciFetch(url, init);
-        const body = await res.text();
-        process.stdout.write(body + (body.endsWith("\n") ? "" : "\n"));
-        process.exit(res.status >= 400 && res.status < 500 ? 1 : res.status >= 500 ? 2 : 0);
-    });
-    return api;
-}
-function die(code, message, exitCode, recovery_hint) {
-    const env = { error: { code, message } };
-    if (recovery_hint)
-        env.error.recovery_hint = recovery_hint;
-    process.stderr.write(JSON.stringify(env) + "\n");
-    process.exit(exitCode);
-}

package/dist/tools/completion.js

@@ -1,116 +0,0 @@
-/**
- * `echopai completion <bash|zsh|fish>` 输出 shell completion 脚本。
- *
- * 不依赖 tabtab，自己生成（30 行 bash / 20 行 zsh / 15 行 fish）。
- * 用 `echopai schema list` 实时拿命令列表。
- *
- *   bash:  echopai completion bash > ~/.local/share/bash-completion/completions/echopai
- *   zsh:   echopai completion zsh  > ~/.zsh/completions/_echopai  (需要 fpath 含此目录)
- *   fish:  echopai completion fish > ~/.config/fish/completions/echopai.fish
- */
-import { Command } from "commander";
-import { listOperations } from "../_generated/operations.js";
-export function buildCompletionCommand() {
-    return new Command("completion")
-        .argument("<shell>", "bash | zsh | fish")
-        .description("Print shell completion script for echopai")
-        .action((shell) => {
-        const ops = listOperations();
-        // groups: map noun → set of verbs
-        const tree = new Map();
-        for (const op of ops) {
-            const parts = op.cliName.split(" ");
-            const noun = parts[0];
-            const verb = parts[1] || "";
-            if (!tree.has(noun))
-                tree.set(noun, new Set());
-            if (verb)
-                tree.get(noun).add(verb);
-        }
-        const nouns = [...tree.keys()].sort();
-        // hand-curated tools
-        const tools = ["login", "logout", "status", "config", "api", "schema", "completion"];
-        const allCmds = [...nouns, ...tools].sort();
-        let out = "";
-        if (shell === "bash") {
-            out = bashCompletion(allCmds, tree);
-        }
-        else if (shell === "zsh") {
-            out = zshCompletion(allCmds, tree);
-        }
-        else if (shell === "fish") {
-            out = fishCompletion(allCmds, tree);
-        }
-        else {
-            process.stderr.write(JSON.stringify({ error: { code: "invalid_args", message: `Unsupported shell '${shell}'`, recovery_hint: "Use bash | zsh | fish." } }) + "\n");
-            process.exit(1);
-        }
-        process.stdout.write(out);
-        process.exit(0);
-    });
-}
-function bashCompletion(cmds, tree) {
-    const subcaseLines = [...tree.entries()]
-        .map(([noun, verbs]) => `        ${noun}) COMPREPLY=( $(compgen -W "${[...verbs].sort().join(" ")}" -- "$cur") );;`)
-        .join("\n");
-    return `# echopai bash completion
-_echopai() {
-    local cur prev
-    cur="\${COMP_WORDS[COMP_CWORD]}"
-    prev="\${COMP_WORDS[COMP_CWORD-1]}"
-    if [ "$COMP_CWORD" = "1" ]; then
-        COMPREPLY=( $(compgen -W "${cmds.join(" ")}" -- "$cur") )
-        return
-    fi
-    case "\${COMP_WORDS[1]}" in
-${subcaseLines}
-        config) COMPREPLY=( $(compgen -W "show set profile" -- "$cur") );;
-        schema) COMPREPLY=( $(compgen -W "list get export" -- "$cur") );;
-    esac
-}
-complete -F _echopai echopai
-`;
-}
-function zshCompletion(cmds, tree) {
-    const subcases = [...tree.entries()]
-        .map(([noun, verbs]) => `      "${noun}") _values "${noun} verb" ${[...verbs].sort().map((v) => `"${v}"`).join(" ")} ;;`)
-        .join("\n");
-    return `#compdef echopai
-_echopai() {
-  local -a cmds
-  cmds=(${cmds.map((c) => `"${c}"`).join(" ")})
-  if (( CURRENT == 2 )); then
-    _values "echopai command" $cmds
-    return
-  fi
-  case "$words[2]" in
-${subcases}
-    config) _values "config sub" "show" "set" "profile" ;;
-    schema) _values "schema sub" "list" "get" "export" ;;
-  esac
-}
-_echopai "$@"
-`;
-}
-function fishCompletion(cmds, tree) {
-    const lines = [`# echopai fish completion`];
-    lines.push(`complete -c echopai -f`);
-    for (const c of cmds) {
-        lines.push(`complete -c echopai -n '__fish_use_subcommand' -a "${c}"`);
-    }
-    for (const [noun, verbs] of tree.entries()) {
-        for (const verb of [...verbs].sort()) {
-            lines.push(`complete -c echopai -n "__fish_seen_subcommand_from ${noun}" -a "${verb}"`);
-        }
-    }
-    // hand-curated
-    for (const [parent, sub] of [
-        ["config", ["show", "set", "profile"]],
-        ["schema", ["list", "get", "export"]],
-    ]) {
-        for (const v of sub) {
-            lines.push(`complete -c echopai -n "__fish_seen_subcommand_from ${parent}" -a "${v}"`);
-        }
-    }
-    return lines.join("\n") + "\n";
-}