ethos-cli 0.1.4 → 0.1.5

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ethos-cli",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "Commander-based CLI for Ethos table operations",
5
5
  "homepage": "https://github.com/cluster-software/ethos#readme",
6
6
  "repository": {
@@ -11,11 +11,11 @@ pass `--api-url` for local development or an explicitly requested environment.
11
11
 
12
12
  ## Flow
13
13
 
14
- Always keep CSV upload browser-first:
14
+ Always keep CSV upload in the Codex in-app Browser:
15
15
 
16
- 1. Open Ethos in the browser with the CSV upload deep link.
16
+ 1. Open Ethos in the in-app Browser with the CSV upload deep link.
17
17
  2. Immediately ask the user for ICP, buying signals, person targets, and max contacts while they upload.
18
- 3. Poll the browser URL until the upload-complete URL appears.
18
+ 3. Poll that same in-app Browser tab until the upload-complete URL appears.
19
19
  4. Save the uploaded table id from that URL.
20
20
  5. Create the `people_sourcing` agent and Codex-created column with the CLI.
21
21
  6. Run the column for the FIRST 3 ROWS ONLY. Tell the user you're running for 3 rows to see if the results are good. If yes, the next step is to run on the whole table. If not, refine the agent based on their feedback so it finds the right people.
@@ -43,7 +43,7 @@ the user explicitly wants a non-browser setup.
43
43
 
44
44
  ## Open Browser Upload
45
45
 
46
- Open this URL in the browser:
46
+ Open this URL in the Codex in-app Browser:
47
47
 
48
48
  ```sh
49
49
  APP_BASE_URL="https://ethos.hello-cluster.com"
@@ -53,7 +53,9 @@ if [ -n "${CODEX_THREAD_ID:-}" ]; then
53
53
  fi
54
54
  ```
55
55
 
56
- Run `open "$UPLOAD_URL"` and tell the user to upload the CSV there.
56
+ Use the Browser plugin/in-app Browser to navigate to `$UPLOAD_URL` and tell
57
+ the user to upload the CSV there. Do not use `open`, Chrome, Safari, or any
58
+ external/default browser for this flow.
57
59
 
58
60
  After opening the upload modal, immediately ask:
59
61
 
@@ -61,7 +63,7 @@ After opening the upload modal, immediately ask:
61
63
  Please describe your ICP, any signals that would make them a good fit for your product or service, and where that data may live. You can keep typing while the CSV uploads.
62
64
  ```
63
65
 
64
- Then poll the browser URL every 2 seconds while the user uploads and answers.
66
+ Then poll the in-app Browser URL every 2 seconds while the user uploads and answers.
65
67
  The ONLY upload-completion indicator is this URL shape:
66
68
 
67
69
  ```text
@@ -171,16 +173,15 @@ After the `source-people` command succeeds, bring the browser back to the table:
171
173
  "$APP_BASE_URL/tables/$TABLE_ID"
172
174
  ```
173
175
 
174
- The table UI should hide the upload return modal once the Codex-created column
175
- appears, then auto-scroll to that column.
176
-
177
- Then report the table URL, run id, and agent id. Keep the response concise and
178
- mention that the Codex-created column should appear and auto-scroll into view in
179
- Ethos.
176
+ Then tell the user the agent is running on the first 3 rows. Do not surface
177
+ agent ids, run ids, table ids, or similar internal ids unless the user asks for
178
+ them or you are actively debugging.
180
179
 
181
180
  ## How to communicate with the user
182
181
 
183
- While you execute the flow, keep communication with the user simple and approachable at all times. Do not mention internal ethos concepts unless explicitly necessary.
182
+ While you execute the flow, keep communication simple and approachable. Avoid
183
+ explaining UI behavior that should happen automatically when everything is
184
+ working. Do not mention internal Ethos concepts unless explicitly necessary.
184
185
 
185
186
  For example, instead of
186
187
 
@@ -195,4 +196,3 @@ If you need input from the user, make it very clear by bolding it and maybe ment
195
196
  E.g.:
196
197
 
197
198
  "**Next, please give me the following information** ..."
198
-