@united-workforce/cli 0.2.1-rc.5 → 0.2.1-rc.6

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 (5) hide show
  1. package/dist/commands/prompt.d.ts.map +1 -1
  2. package/dist/commands/prompt.js +71 -15
  3. package/dist/commands/prompt.js.map +1 -1
  4. package/package.json +1 -1
  5. package/src/commands/prompt.ts +71 -15
package/dist/commands/prompt.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CA0M3C"}
1
+ {"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,EACnC,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAQF,wBAAgB,aAAa,IAAI,aAAa,CAAC,MAAM,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAkQ3C"}
package/dist/commands/prompt.js CHANGED
@@ -75,18 +75,43 @@ which hermes
75
75
 
76
76
  ### Step 1 — Install CLI and agent adapter
77
77
 
78
+ Install the CLI using **either** pnpm or npm:
79
+
78
80
  \`\`\`bash
79
- pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
80
- uwf --version # should print ${CLI_VERSION}
81
+ # Using pnpm (recommended)
82
+ pnpm add -g @united-workforce/cli
83
+
84
+ # Using npm
85
+ npm install -g @united-workforce/cli
81
86
  \`\`\`
82
87
 
83
- Install an agent adapter (at least one is required):
88
+ Next, install an agent adapter (**must be installed before running \`uwf setup --agent\`**):
84
89
 
85
- | Adapter | Install | When to use |
86
- |---------|---------|-------------|
87
- | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
88
- | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
89
- | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
90
+ | Adapter | Install (pnpm / npm) | When to use |
91
+ |---------|----------------------|-------------|
92
+ | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` / \`npm i -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
93
+ | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` / \`npm i -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
94
+ | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` / \`npm i -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
95
+
96
+ **After installing, verify that \`uwf\` and the adapter command (e.g. \`uwf-hermes\`) are available in PATH.** Run:
97
+
98
+ \`\`\`bash
99
+ uwf --version # should print ${CLI_VERSION}
100
+ uwf-hermes --version # (or uwf-claude-code / uwf-builtin)
101
+ \`\`\`
102
+
103
+ If either command is not found, the global bin directory is not in the current shell's PATH. **You must fix this before continuing:**
104
+
105
+ 1. Find where the binary was installed:
106
+ \`\`\`bash
107
+ find ~/.local ~/.hermes /usr/local -name uwf -type f 2>/dev/null
108
+ npm prefix -g # global prefix — bin is <prefix>/bin
109
+ \`\`\`
110
+ 2. Add the directory to PATH permanently by appending to the user's shell config (e.g. \`~/.bashrc\`, \`~/.zshrc\`, \`~/.profile\`, or fish config):
111
+ \`\`\`bash
112
+ export PATH="<global-bin-dir>:$PATH"
113
+ \`\`\`
114
+ 3. Source the updated config or open a new shell, then re-verify the commands work.
90
115
 
91
116
  **uwf-hermes** also requires the Hermes ACP plugin:
92
117
  \`\`\`bash
@@ -100,18 +125,35 @@ pipx install 'hermes-agent[acp]'
100
125
  pip install -e '.[acp]'
101
126
  \`\`\`
102
127
 
103
- Verify the adapter is installed: \`uwf-hermes --version\` (or whichever you chose).
104
-
105
128
  ### Step 2 — Configure provider and model
106
129
 
107
130
  uwf needs an LLM provider to run agents. **Ask the user** for their provider, API key, and model, then run:
108
131
 
109
132
  \`\`\`bash
110
- uwf setup --provider <name> --base-url <url> --api-key <key> --model <model> [--agent <adapter>]
133
+ uwf setup --provider <name> --api-key <key> --model <model> --agent <adapter-command>
111
134
  \`\`\`
112
135
 
113
- Preset providers (base-url is auto-filled when using a preset name):
114
- openai, xai, openrouter, venice, dashscope, deepseek, siliconflow, volcengine, kimi, glm, stepfun, minimax, ollama
136
+ **Note:** \`--agent\` takes the adapter **command name** (e.g. \`uwf-hermes\`), not the npm package name.
137
+
138
+ **Preset providers** — when using a preset name, \`--base-url\` is auto-filled and can be omitted:
139
+
140
+ | Provider | Name | Default base URL |
141
+ |----------|------|-----------------|
142
+ | OpenAI | \`openai\` | https://api.openai.com/v1 |
143
+ | xAI | \`xai\` | https://api.x.ai/v1 |
144
+ | OpenRouter | \`openrouter\` | https://openrouter.ai/api/v1 |
145
+ | Venice | \`venice\` | https://api.venice.ai/api/v1 |
146
+ | Dashscope | \`dashscope\` | https://dashscope.aliyuncs.com/compatible-mode/v1 |
147
+ | DeepSeek | \`deepseek\` | https://api.deepseek.com/v1 |
148
+ | SiliconFlow | \`siliconflow\` | https://api.siliconflow.cn/v1 |
149
+ | VolcEngine | \`volcengine\` | https://ark.cn-beijing.volces.com/api/v3 |
150
+ | Kimi (Moonshot) | \`kimi\` | https://api.moonshot.cn/v1 |
151
+ | GLM (Zhipu AI) | \`glm\` | https://open.bigmodel.cn/api/paas/v4 |
152
+ | StepFun | \`stepfun\` | https://api.stepfun.com/v1 |
153
+ | MiniMax | \`minimax\` | https://api.minimax.io/v1 |
154
+ | Ollama (local) | \`ollama\` | http://localhost:11434/v1 |
155
+
156
+ For **non-preset providers**, you must specify \`--base-url\` manually.
115
157
 
116
158
  Example:
117
159
  \`\`\`bash
@@ -181,11 +223,25 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
181
223
  ### Step 1 — Update packages
182
224
 
183
225
  \`\`\`bash
184
- pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
226
+ # Using pnpm
227
+ pnpm add -g @united-workforce/cli@latest
228
+
229
+ # Using npm
230
+ npm install -g @united-workforce/cli@latest
231
+ \`\`\`
232
+
233
+ \`\`\`bash
185
234
  uwf --version # should print ${CLI_VERSION}
235
+ \`\`\`
236
+
237
+ Also update your adapter(s):
186
238
 
187
- # Also update your adapter(s)
239
+ \`\`\`bash
240
+ # pnpm
188
241
  pnpm add -g @united-workforce/agent-hermes@latest
242
+
243
+ # npm
244
+ npm install -g @united-workforce/agent-hermes@latest
189
245
  \`\`\`
190
246
 
191
247
  ### Step 2 — Regenerate skills
package/dist/commands/prompt.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAEhC,yEAAyE;AACzE,2FAA2F;AAC3F,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzC,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;AAEtC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA6CwB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAyGX,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD3C,CAAC;AACF,CAAC"}
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,kCAAkC,EAClC,sBAAsB,EACtB,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAEhC,yEAAyE;AACzE,2FAA2F;AAC3F,SAAS,eAAe;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAGtD,CAAC;YACF,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzC,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;AAEtC,OAAO,EACL,kCAAkC,IAAI,0BAA0B,EAChE,sBAAsB,IAAI,cAAc,EACxC,kCAAkC,IAAI,0BAA0B,GACjE,CAAC;AAEF,MAAM,cAAc,GAA4D;IAC9E,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnD,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;IAC5E,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,kCAAkC,EAAE;CAC7E,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAgE+B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAuIlB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD3C,CAAC;AACF,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@united-workforce/cli",
3
- "version": "0.2.1-rc.5",
3
+ "version": "0.2.1-rc.6",
4
4
  "files": [
5
5
  "src",
6
6
  "dist",
package/src/commands/prompt.ts CHANGED
@@ -90,18 +90,43 @@ which hermes
90
90
 
91
91
  ### Step 1 — Install CLI and agent adapter
92
92
 
93
+ Install the CLI using **either** pnpm or npm:
94
+
93
95
  \`\`\`bash
94
- pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
95
- uwf --version # should print ${CLI_VERSION}
96
+ # Using pnpm (recommended)
97
+ pnpm add -g @united-workforce/cli
98
+
99
+ # Using npm
100
+ npm install -g @united-workforce/cli
96
101
  \`\`\`
97
102
 
98
- Install an agent adapter (at least one is required):
103
+ Next, install an agent adapter (**must be installed before running \`uwf setup --agent\`**):
99
104
 
100
- | Adapter | Install | When to use |
101
- |---------|---------|-------------|
102
- | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
103
- | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
104
- | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
105
+ | Adapter | Install (pnpm / npm) | When to use |
106
+ |---------|----------------------|-------------|
107
+ | uwf-hermes | \`pnpm add -g @united-workforce/agent-hermes\` / \`npm i -g @united-workforce/agent-hermes\` | When your agent framework is Hermes Agent |
108
+ | uwf-claude-code | \`pnpm add -g @united-workforce/agent-claude-code\` / \`npm i -g @united-workforce/agent-claude-code\` | When using Claude Code CLI directly |
109
+ | uwf-builtin | \`pnpm add -g @united-workforce/agent-builtin\` / \`npm i -g @united-workforce/agent-builtin\` | Lightweight built-in agent (no external dependency) |
110
+
111
+ **After installing, verify that \`uwf\` and the adapter command (e.g. \`uwf-hermes\`) are available in PATH.** Run:
112
+
113
+ \`\`\`bash
114
+ uwf --version # should print ${CLI_VERSION}
115
+ uwf-hermes --version # (or uwf-claude-code / uwf-builtin)
116
+ \`\`\`
117
+
118
+ If either command is not found, the global bin directory is not in the current shell's PATH. **You must fix this before continuing:**
119
+
120
+ 1. Find where the binary was installed:
121
+ \`\`\`bash
122
+ find ~/.local ~/.hermes /usr/local -name uwf -type f 2>/dev/null
123
+ npm prefix -g # global prefix — bin is <prefix>/bin
124
+ \`\`\`
125
+ 2. Add the directory to PATH permanently by appending to the user's shell config (e.g. \`~/.bashrc\`, \`~/.zshrc\`, \`~/.profile\`, or fish config):
126
+ \`\`\`bash
127
+ export PATH="<global-bin-dir>:$PATH"
128
+ \`\`\`
129
+ 3. Source the updated config or open a new shell, then re-verify the commands work.
105
130
 
106
131
  **uwf-hermes** also requires the Hermes ACP plugin:
107
132
  \`\`\`bash
@@ -115,18 +140,35 @@ pipx install 'hermes-agent[acp]'
115
140
  pip install -e '.[acp]'
116
141
  \`\`\`
117
142
 
118
- Verify the adapter is installed: \`uwf-hermes --version\` (or whichever you chose).
119
-
120
143
  ### Step 2 — Configure provider and model
121
144
 
122
145
  uwf needs an LLM provider to run agents. **Ask the user** for their provider, API key, and model, then run:
123
146
 
124
147
  \`\`\`bash
125
- uwf setup --provider <name> --base-url <url> --api-key <key> --model <model> [--agent <adapter>]
148
+ uwf setup --provider <name> --api-key <key> --model <model> --agent <adapter-command>
126
149
  \`\`\`
127
150
 
128
- Preset providers (base-url is auto-filled when using a preset name):
129
- openai, xai, openrouter, venice, dashscope, deepseek, siliconflow, volcengine, kimi, glm, stepfun, minimax, ollama
151
+ **Note:** \`--agent\` takes the adapter **command name** (e.g. \`uwf-hermes\`), not the npm package name.
152
+
153
+ **Preset providers** — when using a preset name, \`--base-url\` is auto-filled and can be omitted:
154
+
155
+ | Provider | Name | Default base URL |
156
+ |----------|------|-----------------|
157
+ | OpenAI | \`openai\` | https://api.openai.com/v1 |
158
+ | xAI | \`xai\` | https://api.x.ai/v1 |
159
+ | OpenRouter | \`openrouter\` | https://openrouter.ai/api/v1 |
160
+ | Venice | \`venice\` | https://api.venice.ai/api/v1 |
161
+ | Dashscope | \`dashscope\` | https://dashscope.aliyuncs.com/compatible-mode/v1 |
162
+ | DeepSeek | \`deepseek\` | https://api.deepseek.com/v1 |
163
+ | SiliconFlow | \`siliconflow\` | https://api.siliconflow.cn/v1 |
164
+ | VolcEngine | \`volcengine\` | https://ark.cn-beijing.volces.com/api/v3 |
165
+ | Kimi (Moonshot) | \`kimi\` | https://api.moonshot.cn/v1 |
166
+ | GLM (Zhipu AI) | \`glm\` | https://open.bigmodel.cn/api/paas/v4 |
167
+ | StepFun | \`stepfun\` | https://api.stepfun.com/v1 |
168
+ | MiniMax | \`minimax\` | https://api.minimax.io/v1 |
169
+ | Ollama (local) | \`ollama\` | http://localhost:11434/v1 |
170
+
171
+ For **non-preset providers**, you must specify \`--base-url\` manually.
130
172
 
131
173
  Example:
132
174
  \`\`\`bash
@@ -196,11 +238,25 @@ If the thread reaches \`$END\` with status \`completed\`, the setup is working.
196
238
  ### Step 1 — Update packages
197
239
 
198
240
  \`\`\`bash
199
- pnpm add -g @united-workforce/cli@latest # or: npm install -g @united-workforce/cli@latest
241
+ # Using pnpm
242
+ pnpm add -g @united-workforce/cli@latest
243
+
244
+ # Using npm
245
+ npm install -g @united-workforce/cli@latest
246
+ \`\`\`
247
+
248
+ \`\`\`bash
200
249
  uwf --version # should print ${CLI_VERSION}
250
+ \`\`\`
251
+
252
+ Also update your adapter(s):
201
253
 
202
- # Also update your adapter(s)
254
+ \`\`\`bash
255
+ # pnpm
203
256
  pnpm add -g @united-workforce/agent-hermes@latest
257
+
258
+ # npm
259
+ npm install -g @united-workforce/agent-hermes@latest
204
260
  \`\`\`
205
261
 
206
262
  ### Step 2 — Regenerate skills