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

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.
@@ -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,CAkQ3C"}
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,CA0Q3C"}
@@ -63,41 +63,49 @@ npm prefix -g # global prefix; bin is <prefix>/bin
63
63
  # FIX: add the missing directory to your shell's startup file
64
64
  # (e.g. ~/.bashrc, ~/.zshrc, ~/.profile, or fish config):
65
65
  # export PATH="<global-bin-dir>:$PATH"
66
-
67
- # 4. (uwf-hermes only) hermes CLI
68
- which hermes
69
- # FIX: if hermes is in a virtualenv, add it to PATH:
70
- # export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
71
- # or create a symlink: ln -s ~/.hermes/hermes-agent/.venv/bin/hermes ~/.local/bin/hermes
72
66
  \`\`\`
73
67
 
74
68
  **All checks must pass before continuing.** If you had to modify PATH, verify the change persists by opening a new shell or sourcing your shell config.
75
69
 
76
- ### Step 1 — Install CLI and agent adapter
70
+ ### Step 1 — Discover agents and install adapter
77
71
 
78
- Install the CLI using **either** pnpm or npm:
72
+ **First, detect which supported agents are already installed on the user's machine:**
79
73
 
80
74
  \`\`\`bash
81
- # Using pnpm (recommended)
82
- pnpm add -g @united-workforce/cli
75
+ # Check for Hermes Agent
76
+ which hermes 2>/dev/null && hermes --version
83
77
 
84
- # Using npm
85
- npm install -g @united-workforce/cli
78
+ # Check for Claude Code
79
+ which claude 2>/dev/null && claude --version # should show "X.Y.Z (Claude Code)"
86
80
  \`\`\`
87
81
 
88
- Next, install an agent adapter (**must be installed before running \`uwf setup --agent\`**):
82
+ **Based on the results:**
83
+
84
+ - **Only hermes found** → install \`uwf-hermes\` adapter
85
+ - **Only claude found** → install \`uwf-claude-code\` adapter
86
+ - **Both found** → ask the user which agent they want uwf to use as default
87
+ - **Neither found** → the user must install at least one agent first:
88
+ - Hermes Agent: https://hermes-agent.nousresearch.com/docs
89
+ - Claude Code: \`npm install -g @anthropic-ai/claude-code\`
90
+
91
+ **Install the uwf CLI and the chosen adapter** using pnpm or npm:
92
+
93
+ \`\`\`bash
94
+ # CLI (required)
95
+ pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
96
+
97
+ # Adapter — install the one matching the detected agent:
98
+ pnpm add -g @united-workforce/agent-hermes # or: npm i -g @united-workforce/agent-hermes
99
+ pnpm add -g @united-workforce/agent-claude-code # or: npm i -g @united-workforce/agent-claude-code
100
+ \`\`\`
89
101
 
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) |
102
+ **⚠ Adapter versions are independent from CLI versions.** Do NOT try to match adapter version to CLI version. Just install \`@latest\` (the default).
95
103
 
96
- **After installing, verify that \`uwf\` and the adapter command (e.g. \`uwf-hermes\`) are available in PATH.** Run:
104
+ **After installing, verify that \`uwf\` and the adapter are available in PATH:**
97
105
 
98
106
  \`\`\`bash
99
107
  uwf --version # should print ${CLI_VERSION}
100
- uwf-hermes --version # (or uwf-claude-code / uwf-builtin)
108
+ uwf-hermes --version # or: uwf-claude-code --version
101
109
  \`\`\`
102
110
 
103
111
  If either command is not found, the global bin directory is not in the current shell's PATH. **You must fix this before continuing:**
@@ -113,7 +121,7 @@ If either command is not found, the global bin directory is not in the current s
113
121
  \`\`\`
114
122
  3. Source the updated config or open a new shell, then re-verify the commands work.
115
123
 
116
- **uwf-hermes** also requires the Hermes ACP plugin:
124
+ **uwf-hermes** also requires the Hermes ACP plugin. Verify with \`hermes acp --help\`. If not available, install it:
117
125
  \`\`\`bash
118
126
  # Option A: install into hermes venv (recommended)
119
127
  source ~/.hermes/hermes-agent/.venv/bin/activate && pip install hermes-agent[acp]
@@ -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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAgE+B,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAuIlB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD3C,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAwE+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.6",
3
+ "version": "0.2.1-rc.7",
4
4
  "files": [
5
5
  "src",
6
6
  "dist",
@@ -78,41 +78,49 @@ npm prefix -g # global prefix; bin is <prefix>/bin
78
78
  # FIX: add the missing directory to your shell's startup file
79
79
  # (e.g. ~/.bashrc, ~/.zshrc, ~/.profile, or fish config):
80
80
  # export PATH="<global-bin-dir>:$PATH"
81
-
82
- # 4. (uwf-hermes only) hermes CLI
83
- which hermes
84
- # FIX: if hermes is in a virtualenv, add it to PATH:
85
- # export PATH="$HOME/.hermes/hermes-agent/.venv/bin:$PATH"
86
- # or create a symlink: ln -s ~/.hermes/hermes-agent/.venv/bin/hermes ~/.local/bin/hermes
87
81
  \`\`\`
88
82
 
89
83
  **All checks must pass before continuing.** If you had to modify PATH, verify the change persists by opening a new shell or sourcing your shell config.
90
84
 
91
- ### Step 1 — Install CLI and agent adapter
85
+ ### Step 1 — Discover agents and install adapter
92
86
 
93
- Install the CLI using **either** pnpm or npm:
87
+ **First, detect which supported agents are already installed on the user's machine:**
94
88
 
95
89
  \`\`\`bash
96
- # Using pnpm (recommended)
97
- pnpm add -g @united-workforce/cli
90
+ # Check for Hermes Agent
91
+ which hermes 2>/dev/null && hermes --version
98
92
 
99
- # Using npm
100
- npm install -g @united-workforce/cli
93
+ # Check for Claude Code
94
+ which claude 2>/dev/null && claude --version # should show "X.Y.Z (Claude Code)"
101
95
  \`\`\`
102
96
 
103
- Next, install an agent adapter (**must be installed before running \`uwf setup --agent\`**):
97
+ **Based on the results:**
98
+
99
+ - **Only hermes found** → install \`uwf-hermes\` adapter
100
+ - **Only claude found** → install \`uwf-claude-code\` adapter
101
+ - **Both found** → ask the user which agent they want uwf to use as default
102
+ - **Neither found** → the user must install at least one agent first:
103
+ - Hermes Agent: https://hermes-agent.nousresearch.com/docs
104
+ - Claude Code: \`npm install -g @anthropic-ai/claude-code\`
105
+
106
+ **Install the uwf CLI and the chosen adapter** using pnpm or npm:
107
+
108
+ \`\`\`bash
109
+ # CLI (required)
110
+ pnpm add -g @united-workforce/cli # or: npm install -g @united-workforce/cli
111
+
112
+ # Adapter — install the one matching the detected agent:
113
+ pnpm add -g @united-workforce/agent-hermes # or: npm i -g @united-workforce/agent-hermes
114
+ pnpm add -g @united-workforce/agent-claude-code # or: npm i -g @united-workforce/agent-claude-code
115
+ \`\`\`
104
116
 
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) |
117
+ **⚠ Adapter versions are independent from CLI versions.** Do NOT try to match adapter version to CLI version. Just install \`@latest\` (the default).
110
118
 
111
- **After installing, verify that \`uwf\` and the adapter command (e.g. \`uwf-hermes\`) are available in PATH.** Run:
119
+ **After installing, verify that \`uwf\` and the adapter are available in PATH:**
112
120
 
113
121
  \`\`\`bash
114
122
  uwf --version # should print ${CLI_VERSION}
115
- uwf-hermes --version # (or uwf-claude-code / uwf-builtin)
123
+ uwf-hermes --version # or: uwf-claude-code --version
116
124
  \`\`\`
117
125
 
118
126
  If either command is not found, the global bin directory is not in the current shell's PATH. **You must fix this before continuing:**
@@ -128,7 +136,7 @@ If either command is not found, the global bin directory is not in the current s
128
136
  \`\`\`
129
137
  3. Source the updated config or open a new shell, then re-verify the commands work.
130
138
 
131
- **uwf-hermes** also requires the Hermes ACP plugin:
139
+ **uwf-hermes** also requires the Hermes ACP plugin. Verify with \`hermes acp --help\`. If not available, install it:
132
140
  \`\`\`bash
133
141
  # Option A: install into hermes venv (recommended)
134
142
  source ~/.hermes/hermes-agent/.venv/bin/activate && pip install hermes-agent[acp]