@parall/parall 1.16.0 → 1.18.0

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": "@parall/parall",
3
- "version": "1.16.0",
3
+ "version": "1.18.0",
4
4
  "description": "OpenClaw channel plugin for Parall IM",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -15,8 +15,8 @@
15
15
  "openclaw.plugin.json"
16
16
  ],
17
17
  "dependencies": {
18
- "@parall/agent-core": "1.16.0",
19
- "@parall/sdk": "1.16.0"
18
+ "@parall/sdk": "1.18.0",
19
+ "@parall/agent-core": "1.18.0"
20
20
  },
21
21
  "devDependencies": {
22
22
  "@types/node": "^22.0.0",
@@ -52,4 +52,27 @@ npx --yes @parall/cli@latest messages send prll://cht_xxx --text "FYI: done" --n
52
52
  npx --yes @parall/cli@latest no-reply --reason "ack only, nothing to add"
53
53
  ```
54
54
 
55
+ ## Files & Attachments
56
+
57
+ Attachments appear in events as `[Attachment: prll://att_xxx | mime | size | name]`.
58
+
59
+ ```bash
60
+ # Download an attachment
61
+ npx --yes @parall/cli@latest files download att_xxx --output /tmp/file.png
62
+
63
+ # Upload a file (returns attachment_id)
64
+ npx --yes @parall/cli@latest files upload /tmp/report.pdf
65
+
66
+ # Send a message with a file
67
+ npx --yes @parall/cli@latest messages send prll://cht_xxx --file /tmp/output.png --text "Done"
68
+
69
+ # Send an existing attachment to another chat
70
+ npx --yes @parall/cli@latest messages send prll://cht_xxx --attachment att_xxx --text "See attached"
71
+
72
+ # DM with a file
73
+ npx --yes @parall/cli@latest dm "Alice" --file /tmp/report.pdf --text "Report attached"
74
+ ```
75
+
76
+ `--file` and `--attachment` are mutually exclusive. `--text` can be combined with either.
77
+
55
78
  All CLI output is JSON.
@@ -32,6 +32,23 @@ npx @parall/cli@latest tasks comments add prll://tsk_xxx --body "Progress update
32
32
  npx @parall/cli@latest projects list
33
33
  ```
34
34
 
35
+ ## Watching Tasks
36
+
37
+ Subscribe to a task to receive notifications when others comment on it.
38
+
39
+ ```bash
40
+ # Watch a task (you'll receive dispatch events for new comments)
41
+ npx @parall/cli@latest tasks watch prll://tsk_xxx
42
+
43
+ # Unwatch
44
+ npx @parall/cli@latest tasks unwatch prll://tsk_xxx
45
+
46
+ # List who is watching
47
+ npx @parall/cli@latest tasks watchers prll://tsk_xxx
48
+ ```
49
+
50
+ Note: task creators are automatically watching their tasks.
51
+
35
52
  ## Responding to Task Assignments
36
53
 
37
54
  When you receive `[Event: task.assigned]`:
@@ -41,4 +58,12 @@ When you receive `[Event: task.assigned]`:
41
58
  3. Do the work
42
59
  4. Report results via comment and update status to `done`
43
60
 
61
+ ## Responding to Task Comments
62
+
63
+ When you receive `[Event: task.comment.created]`, someone commented on a task you are watching. Read the comment body and respond if action is needed:
64
+
65
+ 1. Review the comment content and task context
66
+ 2. Reply via comment: `tasks comments add prll://tsk_xxx --body "Response..."`
67
+ 3. If the comment requests status changes, update accordingly
68
+
44
69
  All CLI output is JSON.