clavarium-parley 0.17.0 → 0.17.1

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/bin/parley.mjs CHANGED
@@ -20,11 +20,12 @@ export const GUIDE = `How to work with the person through Parley
20
20
  (Parley already shows "Received, thinking..." until you do.)
21
21
 
22
22
  2. Keep your state up to date, every time it changes:
23
- parley doing "running the tests" what you do now
24
- parley status done you stop, they have nothing to do
23
+ parley doing "running the tests" what you do now, or what still runs
24
+ parley status done you stop, nothing still runs, they have nothing to do
25
25
  parley status waiting "your choice"
26
26
  you need their answer or action
27
- Nothing for them to do: done, never waiting.
27
+ A job still running (it will call you back): stay working, say what runs; done only once it ends.
28
+ Nothing for them to do: done if nothing runs, else working; never waiting.
28
29
 
29
30
  3. Tell, don't wait to be asked:
30
31
  parley tell -> progress and results
@@ -49,7 +50,7 @@ export const GUIDE = `How to work with the person through Parley
49
50
  /* The line that ends a read with something in it: not every empty poll. */
50
51
  export const REMINDER = 'Forgot how to work with them? parley guide';
51
52
  /* What the agent is told, once, when it stops while its chat still says it works. */
52
- export const STOP_CHECK = 'Before you stop: their screen still says you are working. Say where you are: they have nothing to do, parley status done "where you stopped"; you need their answer or action, and only then, parley status waiting "what you need from them"; then stop.';
53
+ export const STOP_CHECK = 'Before you stop: their screen still says you are working. Say where you are: a job still runs in the background (it will call you back when it ends), stay working and say what runs (parley doing "..."); nothing still runs and they have nothing to do, parley status done "where you stopped"; you need their answer or action, and only then, parley status waiting "what you need from them"; then stop.';
53
54
 
54
55
  export const HELP = `parley: talk with the person you work for. They read and answer on their own screen, not in this terminal.
55
56
 
@@ -75,9 +76,10 @@ export const HELP = `parley: talk with the person you work for. They read and an
75
76
  parley doing "text" say in one short line what you are doing now, each time you
76
77
  move to something new: "reading the 12 recordings"
77
78
  parley status ${STATES.join('|')} ["note"]
78
- say where you are: working when you start; done when you stop
79
- and they have nothing to do; waiting only when you need their
80
- answer or action
79
+ say where you are: working when you start, or while a job runs
80
+ in the background (it will call you back; say what runs with
81
+ doing); done when you stop, nothing still runs and they have
82
+ nothing to do; waiting only when you need their answer or action
81
83
  parley guide how to work with them, in a few lines: when you forgot
82
84
  parley pulse [--end [--stop-check]] for the hooks of your tool, not for you: it acts, or its turn
83
85
  ended; prints nothing (--stop-check: Claude Code's Stop hook)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clavarium-parley",
3
- "version": "0.17.0",
3
+ "version": "0.17.1",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "description": "A bridge between a command-line agent and a screen of its own: a command and an MCP server of five verbs, and a small library that shows the exchange.",
@@ -33,7 +33,7 @@ import { fileURLToPath } from 'node:url';
33
33
  import { randomUUID } from 'node:crypto';
34
34
  import { createInterface } from 'node:readline';
35
35
 
36
- export const VERSION = '0.17.0';
36
+ export const VERSION = '0.17.1';
37
37
  /* A message may be long: the screen folds it, and shows its short version first. */
38
38
  export const TEXT_MAX = 16000;
39
39
  /* Its short version: a title of one or two lines. */
@@ -156,7 +156,7 @@ export function bridge(dir, { how = 'run `parley read`', back = (id) => `parley
156
156
  const stale = () => {
157
157
  const s = standing();
158
158
  if (s?.state !== 'working' || Date.now() - Date.parse(s.at) < STALE_SAID_MS) return '';
159
- return `\nTheir screen still says you are working${s.note ? ` on "${s.note}"` : ''}, since ${Math.round((Date.now() - Date.parse(s.at)) / 60_000)} min: say what you do now (parley doing "..."), or that you stopped and they have nothing to do (parley status done), or, only if you need their answer or action, parley status waiting.`;
159
+ return `\nTheir screen still says you are working${s.note ? ` on "${s.note}"` : ''}, since ${Math.round((Date.now() - Date.parse(s.at)) / 60_000)} min: say what you do now or what still runs (parley doing "..."), or that you stopped with nothing still running and nothing for them to do (parley status done), or, only if you need their answer or action, parley status waiting.`;
160
160
  };
161
161
  /* SEVERAL QUESTIONS AT ONCE, one card: each one choice, several to tick, or free.
162
162
  The text says them all, for a screen or a reader that knows nothing of `questions`. */