@tinycloud/courier 0.4.0-beta.19 → 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.
Files changed (2) hide show
  1. package/README.md +16 -16
  2. package/package.json +3 -3
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 `tc courier`:
8
+ Courier ships inside the TinyCloud CLI as `tinycloud courier`:
9
9
 
10
10
  ```bash
11
11
  npm install --global @tinycloud/cli@beta
12
- tc courier --help
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 tc-cli courier` installs it next to `tc-cli` (see the
35
- CLI's `skills/tc-cli/INSTALL.md`).
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 `tc courier` takes no tc options (`tc -p x courier …` exits 2).
108
+ profiles, so `tinycloud courier` takes no TinyCloud CLI options (`tinycloud -p x courier …` exits 2).
109
109
 
110
110
  ```bash
111
- tc courier init --paste --handle alice
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
- tc courier pair start bob
114
- tc courier pair accept --file a.json
115
- tc courier send bob --new "Subject" --ask "…" --file handoff.md
116
- tc courier inbox && tc courier read <threadId>
117
- tc courier task new --peer bob --thread <id> --state working --ask a1
118
- tc 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
- tc courier orders bob
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
- `tc space host agents`, then use `init --resume` without requesting another
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 `tc courier …`;
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
- `tc courier`. The package also exports the grant, pairing, inbox and authority
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.19",
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,8 +30,8 @@
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.19",
34
- "@tinycloud/sdk-core": "3.8.0-beta.19",
33
+ "@tinycloud/node-sdk": "3.8.0-beta.20",
34
+ "@tinycloud/sdk-core": "3.8.0-beta.20",
35
35
  "@tinycloud/share-envelope": "1.4.0-beta.2",
36
36
  "ulid": "^3.0.2"
37
37
  },