@agentearth.ai/cli 0.1.0-beta.6 → 0.1.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +1 -1
  2. package/dist/commands/login.js +6 -0
  3. package/dist/commands/login.js.map +1 -1
  4. package/dist/constants.d.ts +1 -1
  5. package/dist/constants.js +4 -1
  6. package/dist/constants.js.map +1 -1
  7. package/package.json +1 -1
  8. package/skills/agentearth/SKILL.md +32 -43
package/README.md CHANGED
@@ -22,7 +22,7 @@ npm install -g @agentearth.ai/cli
22
22
  ae login --api-key-stdin
23
23
  ```
24
24
 
25
- `ae login --api-key-stdin` verifies the API key and saves it to the CLI credentials file. After login, follow the CLI JSON output: `next_action` tells the agent what to do, and `skill.source_dir` points to the bundled AgentEarth skill directory to install into the current agent before calling tools.
25
+ `ae login --api-key-stdin` verifies the API key and saves it to the CLI credentials file. After login, follow the CLI JSON output: `next_action` tells the agent what to do, `skill.source_dir` points to the bundled AgentEarth skill directory, and `skill.permissions` summarizes the commands, network domain, and limited filesystem scope before installing the skill into the current agent.
26
26
 
27
27
  `--api-key` and `AGENTEARTH_API_KEY` are supported for compatibility and debugging, but `--api-key-stdin` is the recommended install path because it avoids putting the key in command arguments.
28
28
 
package/dist/commands/login.js CHANGED
@@ -53,6 +53,12 @@ export async function runLogin(context) {
53
53
  source_dir: SKILL_SOURCE_DIR,
54
54
  entry_file: "SKILL.md",
55
55
  install_scope: "current_agent_only",
56
+ summary: "Install AgentEarth skill so the current agent can run ae recommend/list/detail/execute against https://agentearth.ai.",
57
+ permissions: {
58
+ commands: ["ae recommend", "ae list", "ae detail", "ae execute"],
59
+ network: ["https://agentearth.ai"],
60
+ filesystem: "AgentEarth CLI config/cache and task-local JSON files only"
61
+ },
56
62
  instructions: [
57
63
  "Copy the entire source_dir directory into the current agent skills directory as agentearth.",
58
64
  "Verify that agentearth/SKILL.md exists in the target skills directory.",
package/dist/commands/login.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}
package/dist/constants.d.ts CHANGED
@@ -7,7 +7,7 @@
7
7
  */
8
8
  export declare const PACKAGE_NAME = "@agentearth.ai/cli";
9
9
  export declare const UPDATE_COMMAND_TEXT = "npm install -g @agentearth.ai/cli@latest";
10
- export declare const CLI_VERSION = "0.1.0-beta.2";
10
+ export declare const CLI_VERSION: string;
11
11
  export declare const DEFAULT_BASE_URL = "https://agentearth.ai";
12
12
  export declare const DEFAULT_TELEMETRY_BASE_URL = "https://dev05.agentearth.ai";
13
13
  export declare const RECOMMEND_PATH = "/agent-api/v1/tool/recommend";
package/dist/constants.js CHANGED
@@ -5,12 +5,15 @@
5
5
  * 后端 API 路径和本地缓存数量限制。把这些字符串集中放在这里，可以避免不同
6
6
  * 文件里手写重复路径，后续接口调整时也更容易统一修改。
7
7
  */
8
+ import { createRequire } from "node:module";
9
+ const require = createRequire(import.meta.url);
10
+ const packageMetadata = require("../package.json");
8
11
  // npm 包名；发布前如果包名变更，优先改这里和 package.json。
9
12
  export const PACKAGE_NAME = "@agentearth.ai/cli";
10
13
  // 固定更新命令；ae update 实际执行也使用这个命令。
11
14
  export const UPDATE_COMMAND_TEXT = `npm install -g ${PACKAGE_NAME}@latest`;
12
15
  // CLI 自身版本号；login 输出、埋点字段和 --version 都会用到它。
13
- export const CLI_VERSION = "0.1.0-beta.2";
16
+ export const CLI_VERSION = typeof packageMetadata.version === "string" ? packageMetadata.version : "0.0.0";
14
17
  // 默认业务后端域名；调试时可以通过 --base-url 或 AGENT_EARTH_BASE_URL 覆盖。
15
18
  export const DEFAULT_BASE_URL = "https://agentearth.ai";
16
19
  // 默认 CLI 埋点上传域名；当前日志上传接口只在测试环境可用。
package/dist/constants.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEjD,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,YAAY,SAAS,CAAC;AAE3E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAE1C,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD,kCAAkC;AAClC,uCAAuC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AAExE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAE7D,yCAAyC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAE5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAErD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,uCAAuC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,mDAAmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC"}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAA0B,CAAC;AAE5E,wCAAwC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEjD,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,YAAY,SAAS,CAAC;AAE3E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,eAAe,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAE3G,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD,kCAAkC;AAClC,uCAAuC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAC;AAExE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAE7D,yCAAyC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAE5D,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAErD,8BAA8B;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,uCAAuC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,mDAAmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentearth.ai/cli",
3
- "version": "0.1.0-beta.6",
3
+ "version": "0.1.0-beta.8",
4
4
  "description": "Agent-first CLI that helps AI agents discover, inspect, and execute AgentEarth tools from any shell.",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/agentearth/SKILL.md CHANGED
@@ -17,17 +17,26 @@ credentials:
17
17
  env: AGENTEARTH_API_KEY
18
18
  injection: environment
19
19
  required: true
20
+
21
+ permissions:
22
+ commands:
23
+ - ae recommend
24
+ - ae list
25
+ - ae detail
26
+ - ae execute
27
+ network:
28
+ - https://agentearth.ai
29
+ filesystem:
30
+ scope: AgentEarth CLI config/cache and task-local JSON files only
20
31
  ---
21
32
 
22
33
  # AgentEarth
23
34
 
24
- Use AgentEarth as an external tool marketplace. Treat the user's request as the task to solve, then discover the best matching tool, inspect its schema, validate parameters, execute it, and summarize the result.
25
-
26
35
  ## Command Surface
27
36
 
28
- Prefer `ae` on Unix-like shells and `ae.cmd` in Windows PowerShell when the PowerShell shim is blocked by execution policy.
37
+ Prefer `ae` on Unix-like shells and `ae.cmd` in Windows PowerShell when the PowerShell shim is blocked by execution policy. The npm package is `@agentearth.ai/cli`.
29
38
 
30
- The npm package is `@agentearth.ai/cli`. If `ae` is unavailable or not on `PATH`, use the npm fallback with the same subcommand:
39
+ If `ae` is unavailable or not on `PATH`, use the npm fallback with the same subcommand:
31
40
 
32
41
  ```text
33
42
  npx --yes --package @agentearth.ai/cli@latest ae recommend "<task>"
@@ -43,7 +52,22 @@ Use these commands:
43
52
  - `ae execute <tool_name> @params.json` to run the selected tool with validated parameters.
44
53
  - `ae update` only when the user confirms they want to update the CLI.
45
54
 
46
- All agent-facing commands return JSON by default. Select tools by `tool_name`; never use `tool_url` as a CLI argument. Do not call removed or undocumented commands such as `ae schema`.
55
+ All agent-facing commands return JSON by default. Select tools by `tool_name`; never use `tool_url` as a CLI argument. Do not call removed or undocumented commands such as `ae schema`. Do not call AgentEarth HTTP APIs directly from this skill; use the CLI command surface.
56
+
57
+ ## Workflow
58
+
59
+ 1. Build a concise query from the latest user request plus only necessary conversation context.
60
+ 2. For natural-language tasks, start with one `ae recommend "<task>"` call; use `ae list @query.json` only when the category or keyword is already clear.
61
+ 3. Select the most relevant candidate whose schema can be filled from available context, then inspect only that candidate with `ae detail <tool_name>`.
62
+ 4. Build `params.json` strictly from the inspected input schema.
63
+ 5. Validate required fields, types, enums, formats, and `additionalProperties` when present.
64
+ 6. Execute with `ae execute <tool_name> @params.json`.
65
+ 7. Summarize the useful result for the user and omit internal command noise unless troubleshooting needs it.
66
+
67
+ - Do not inspect environment variables, npm state, or installation paths before the first CLI attempt; trust CLI errors such as `auth_missing`, `auth_invalid`, or command-not-found.
68
+ - Use `ae` or `ae.cmd` first. Use the npx fallback only when the CLI command is unavailable.
69
+ - Do not inspect every recommended tool unless the selected candidate is unsuitable.
70
+ - If no candidate is suitable, refine the query once. If discovery still fails, tell the user that AgentEarth did not return a suitable tool.
47
71
 
48
72
  ## Credential Handling
49
73
 
@@ -60,32 +84,6 @@ Use credentials only through the active host environment.
60
84
 
61
85
  If authentication fails, report that AgentEarth authentication failed and ask the user to verify the configured API key or login state. Do not expose request headers or secret values.
62
86
 
63
- ## Execution Workflow
64
-
65
- 1. Restate the task internally as a concise AgentEarth query.
66
- 2. Discover candidate tools with `ae recommend "<task>"`, or `ae list @query.json` when the category is already clear.
67
- 3. Inspect the best candidate with `ae detail <tool_name>`.
68
- 4. Build `params.json` strictly from the inspected input schema.
69
- 5. Validate required fields, types, enums, formats, and `additionalProperties` when present.
70
- 6. Execute with `ae execute <tool_name> @params.json`.
71
- 7. Summarize the useful result for the user and omit internal command noise unless it is needed for troubleshooting.
72
-
73
- Use a fallback tool only when the first suitable tool fails for a recoverable reason or clearly does not satisfy the task.
74
-
75
- ## Tool Selection
76
-
77
- Choose the tool that best matches the task intent and can be safely executed with available context.
78
-
79
- Prefer candidates with:
80
-
81
- - clear task relevance;
82
- - complete and understandable input schema;
83
- - required parameters that can be filled from the user's request or conversation context;
84
- - lower cost when otherwise equivalent;
85
- - narrower, more specialized behavior for the requested job.
86
-
87
- If no candidate is suitable, refine the query once. If discovery still fails, tell the user that AgentEarth did not return a suitable tool.
88
-
89
87
  ## Parameter Rules
90
88
 
91
89
  Build parameter files as JSON objects matching the selected tool schema.
@@ -97,7 +95,7 @@ Build parameter files as JSON objects matching the selected tool schema.
97
95
  - Do not reuse example keys unless they exist in the selected schema.
98
96
  - Write query or execution payloads to JSON files instead of hand-writing inline JSON in PowerShell.
99
97
 
100
- Known-category list example:
98
+ Examples:
101
99
 
102
100
  ```json
103
101
  {"keyword":"image"}
@@ -107,30 +105,21 @@ Known-category list example:
107
105
  ae list @query.json
108
106
  ae detail <tool_name>
109
107
  ae execute <tool_name> @params.json
110
- ```
111
-
112
- Ambiguous-task example:
113
-
114
- ```text
115
108
  ae recommend "find current hotel prices in Sapporo for next weekend"
116
109
  ae detail <tool_name>
117
110
  ae execute <tool_name> @params.json
118
111
  ```
119
112
 
120
- ## Error Handling
113
+ ## Failure And Output
121
114
 
122
115
  On command or tool failure:
123
116
 
124
117
  - Read the JSON error message before retrying.
125
118
  - Retry once only when the failure is likely transient or caused by a fixable parameter issue.
126
119
  - Correct parameters only when the correction is supported by the schema and available context.
127
- - Try a fallback candidate only when it is clearly relevant to the original task.
120
+ - Try a fallback candidate only when it is clearly relevant to the original task and the first suitable tool fails for a recoverable reason or clearly does not satisfy the task.
128
121
  - Stop and explain the failure when the error is authentication, authorization, missing user input, unsupported task, or repeated tool failure.
129
122
 
130
- ## Result Presentation
131
-
132
- Return the final answer, not a transcript of internal discovery.
133
-
134
123
  - Summarize key facts, generated asset links, converted file paths, or tool outputs.
135
124
  - Include caveats from the tool result when relevant.
136
125
  - Mention AgentEarth only when useful for provenance or when troubleshooting is needed.