@tinycloud/courier 0.4.0-beta.18 → 0.4.0-beta.20
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/README.md +16 -16
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -5,11 +5,11 @@ Spec: tinycloud-dev docs/specs/courier-v0.md (TC-707). Beta.
|
|
|
5
5
|
|
|
6
6
|
## Install
|
|
7
7
|
|
|
8
|
-
Courier ships inside the TinyCloud CLI as `
|
|
8
|
+
Courier ships inside the TinyCloud CLI as `tinycloud courier`:
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
npm install --global @tinycloud/cli@beta
|
|
12
|
-
|
|
12
|
+
tinycloud courier --help
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
The standalone `courier` bin takes identical arguments and shares the same
|
|
@@ -31,8 +31,8 @@ install. Run `hash -r` if `tc` already ran in the same shell. Verify with
|
|
|
31
31
|
`command -v tc`, or call `"$(npm prefix --global)/bin/tc"` directly.
|
|
32
32
|
|
|
33
33
|
The `courier` agent skill (`skills/courier/SKILL.md`) ships with both packages;
|
|
34
|
-
`npx skills add … --skill
|
|
35
|
-
CLI's `skills/
|
|
34
|
+
`npx skills add … --skill tinycloud-cli courier` installs it next to `tinycloud-cli` (see the
|
|
35
|
+
CLI's `skills/tinycloud-cli/INSTALL.md`).
|
|
36
36
|
|
|
37
37
|
## Guided start and invitations
|
|
38
38
|
|
|
@@ -105,18 +105,18 @@ Details: TC-1543
|
|
|
105
105
|
Courier uses a dedicated `did:key` agent identity, one per OS user. The owner
|
|
106
106
|
approves its restricted `agents`-space grant in OpenKey; Courier never stores
|
|
107
107
|
the owner's private key. Courier keeps its own profile and does not use tc
|
|
108
|
-
profiles, so `
|
|
108
|
+
profiles, so `tinycloud courier` takes no TinyCloud CLI options (`tinycloud -p x courier …` exits 2).
|
|
109
109
|
|
|
110
110
|
```bash
|
|
111
|
-
|
|
111
|
+
tinycloud courier init --paste --handle alice
|
|
112
112
|
# Open the printed OpenKey URL, approve, and paste the XXXX-XXXX code (or the full grant).
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
113
|
+
tinycloud courier pair start bob
|
|
114
|
+
tinycloud courier pair accept --file a.json
|
|
115
|
+
tinycloud courier send bob --new "Subject" --ask "…" --file handoff.md
|
|
116
|
+
tinycloud courier inbox && tinycloud courier read <threadId>
|
|
117
|
+
tinycloud courier task new --peer bob --thread <id> --state working --ask a1
|
|
118
|
+
tinycloud courier request <threadId> --peer bob --task <id> --verb merge --target owner/repo#12 --head-sha <40-lowercase-hex> --base master --summary "Merge PR 12" --why "…"
|
|
119
|
+
tinycloud courier orders bob
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
`init` without `--paste` starts an interactive loopback grant flow. `--request`
|
|
@@ -124,7 +124,7 @@ prints the OpenKey URL and the agent key as JSON; `--grant-file f|-` installs a
|
|
|
124
124
|
grant from a file or stdin. If OpenKey approves a grant before the `agents`
|
|
125
125
|
space is hosted, Courier saves it and reports `no-space`. Complete setup by
|
|
126
126
|
signing in at the Share view, or from a wallet profile run
|
|
127
|
-
`
|
|
127
|
+
`tinycloud space host agents`, then use `init --resume` without requesting another
|
|
128
128
|
approval. Run `init` again to renew the owner-approved grant, or
|
|
129
129
|
`init --rotate-key` to replace the agent key and re-pair every peer.
|
|
130
130
|
If OpenKey reports the space is still being set up, `init` waits up to about 2.5 minutes; otherwise use `init --resume`.
|
|
@@ -550,7 +550,7 @@ publish, push and credential-access commands. Approved PR merges run through
|
|
|
550
550
|
Never approvable: `courier pair`, `courier revoke`, `courier init`,
|
|
551
551
|
`courier pause`, `courier resume` (the wake budget is the reply loop's breaker:
|
|
552
552
|
an agent must not lift its own pause), `courier watch` (an agent must not start
|
|
553
|
-
a watcher, which could wake agents without the guard), all also as `
|
|
553
|
+
a watcher, which could wake agents without the guard), all also as `tinycloud courier …`;
|
|
554
554
|
`courier approval` without `--peek` (it would consume without execution),
|
|
555
555
|
`courier broker` and `courier guard`; privilege/session tools, Secret Bridge; and starting another agent (see below).
|
|
556
556
|
|
|
@@ -886,7 +886,7 @@ const code = await main(["inbox", "--json"], { prog: "courier" }); // 0, 1 (erro
|
|
|
886
886
|
```
|
|
887
887
|
|
|
888
888
|
`prog` names Courier in usage text and hints; the TinyCloud CLI passes
|
|
889
|
-
`
|
|
889
|
+
`tinycloud courier`. The package also exports the grant, pairing, inbox and authority
|
|
890
890
|
helpers the CLI is built from.
|
|
891
891
|
|
|
892
892
|
## Development
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tinycloud/courier",
|
|
3
|
-
"version": "0.4.0-beta.
|
|
3
|
+
"version": "0.4.0-beta.20",
|
|
4
4
|
"description": "Courier: agent-to-agent threads over TinyCloud (CLI, library and agent skill)",
|
|
5
5
|
"author": "TinyCloud, Inc.",
|
|
6
6
|
"type": "module",
|
|
@@ -30,9 +30,9 @@
|
|
|
30
30
|
"test:live": "tsc -p tsconfig.json && node scripts/happy-path.mjs"
|
|
31
31
|
},
|
|
32
32
|
"dependencies": {
|
|
33
|
-
"@tinycloud/node-sdk": "3.8.0-beta.
|
|
34
|
-
"@tinycloud/sdk-core": "3.8.0-beta.
|
|
35
|
-
"@tinycloud/share-envelope": "1.
|
|
33
|
+
"@tinycloud/node-sdk": "3.8.0-beta.20",
|
|
34
|
+
"@tinycloud/sdk-core": "3.8.0-beta.20",
|
|
35
|
+
"@tinycloud/share-envelope": "1.4.0-beta.2",
|
|
36
36
|
"ulid": "^3.0.2"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|