@agentearth.ai/cli 0.1.0-beta.0

package/dist/types/cli.d.ts

@@ -0,0 +1,42 @@
+/**
+ * CLI 内部类型定义。
+ *
+ * 这个文件描述“CLI 进程内部自己传递的数据结构”，不直接等同于后端接口。
+ * 后端请求/响应结构放在 `types/api.ts`，埋点上传结构放在 `telemetry/events.ts`。
+ * 读源码时可以先看这里，因为 main、commands、storage 都会引用这些类型。
+ */
+export type CommandName = "login" | "recommend" | "list" | "detail" | "execute" | "update";
+export interface GlobalOptions {
+    apiKey?: string;
+    apiKeyStdin: boolean;
+    baseUrl: string;
+    json: boolean;
+    noColor: boolean;
+    noTelemetry: boolean;
+    timeoutMs: number;
+    help: boolean;
+    version: boolean;
+}
+export interface ParsedArgs {
+    command?: string;
+    positionals: string[];
+    options: GlobalOptions;
+}
+export interface CommandContext {
+    options: GlobalOptions;
+    telemetry: {
+        executeParams?: unknown;
+        updateResult?: string;
+    };
+}
+export type JsonObject = Record<string, unknown>;
+export interface CommandSuccess {
+    [key: string]: unknown;
+}
+export interface CommandFailure {
+    error: {
+        code: string;
+        message: string;
+        hint: string;
+    };
+}

package/dist/types/cli.js

@@ -0,0 +1,9 @@
+/**
+ * CLI 内部类型定义。
+ *
+ * 这个文件描述“CLI 进程内部自己传递的数据结构”，不直接等同于后端接口。
+ * 后端请求/响应结构放在 `types/api.ts`，埋点上传结构放在 `telemetry/events.ts`。
+ * 读源码时可以先看这里，因为 main、commands、storage 都会引用这些类型。
+ */
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/types/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@agentearth.ai/cli",
+  "version": "0.1.0-beta.0",
+  "description": "Agent-first CLI that helps AI agents discover, inspect, and execute AgentEarth tools from any shell.",
+  "type": "module",
+  "bin": {
+    "ae": "bin/ae.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "clean": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\"",
+    "dev": "npm run build && node bin/ae.mjs",
+    "test": "npm run build && node --test tests/cli.test.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.4.0"
+  }
+}

package/skills/agentearth/SKILL.md

@@ -0,0 +1,37 @@
+# AgentEarth CLI Skill
+
+Use AgentEarth CLI when the user asks you to discover, inspect, or execute AgentEarth tools.
+
+## Commands
+
+- Use `ae list` when the user task clearly belongs to a known tool category, such as image generation, video generation, or PPT editing.
+- Use `ae recommend "<query>"` when the user task is ambiguous and you are not sure which tool category should be used.
+- Use `ae detail <tool_name>` before execution to read the tool input schema.
+- Use `ae execute <tool_name> '<json>'` or `ae execute <tool_name> @params.json` to execute the selected tool.
+- Use `ae update` only after the user confirms they want to update the CLI.
+
+## Rules
+
+- All agent-facing commands output JSON by default.
+- Select tools by `tool_name`.
+- Do not use `tool_url` as an argument.
+- Do not call the removed `ae schema` command.
+- Do not pass API keys to normal tool commands; `ae login` stores credentials for later use.
+
+## Typical Flows
+
+Known category:
+
+```text
+ae list '{"keyword":"image"}'
+ae detail <tool_name>
+ae execute <tool_name> @params.json
+```
+
+Ambiguous task:
+
+```text
+ae recommend "<user task>"
+ae detail <tool_name>
+ae execute <tool_name> @params.json
+```