@sjawhar/pi-envoy 16.31.1 → 16.32.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/dist/envoy.js CHANGED
@@ -42650,7 +42650,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
42650
42650
 
42651
42651
  // package.json
42652
42652
  var name = "@sjawhar/pi-envoy";
42653
- var version2 = "16.31.1";
42653
+ var version2 = "16.32.0";
42654
42654
  var package_default = {
42655
42655
  name,
42656
42656
  version: version2,
@@ -19,7 +19,10 @@ agent-secrets NAME... [--reason TEXT] [--wait DURATION] [--ttl DURATION] -- <com
19
19
  a secret behind the airlock, as a placeholder standing for it (below). Nothing runs unless
20
20
  every name is granted: a denial of one name denies the whole request, so the command never starts
21
21
  with some of its secrets missing (`cmdExec`, `packages/envoy/cmd/agent-secrets/main.go`).
22
- - `--reason` is what a person reads if the request waits for a decision. Write one.
22
+ - `--reason` is necessary wherever a person approves: a request that names a secret someone must
23
+ decide, and carries none, is denied whole. Say what the credential is for, in a sentence the
24
+ approver can decide on. A request every name of which is granted at once reaches nobody and
25
+ needs none.
23
26
  - `agent-secrets --help` holds the rest: the flags that narrow a GitHub App token
24
27
  (`--github-owner`, `--github-repo`, `--github-read-only`), and how long a grant lasts.
25
28
  - A narrowing and the airlock do not go together. Ask for a narrowing in a run whose grant holds
@@ -110,7 +113,7 @@ Your transcript keeps everything a command prints.
110
113
  reads the placeholder's shape and not the value's:
111
114
 
112
115
  ```sh
113
- agent-secrets NAME -- sh -c 'echo "${#NAME}"; case "$NAME" in ghp_*) echo prefix-ok;; *) echo prefix-no;; esac'
116
+ agent-secrets NAME --reason 'check the shape of this credential' -- sh -c 'echo "${#NAME}"; case "$NAME" in ghp_*) echo prefix-ok;; *) echo prefix-no;; esac'
114
117
  ```
115
118
 
116
119
  - Compare two values only as equal or not equal. Never print, slice or diff their characters.
@@ -138,7 +141,10 @@ Without the grant line the status is the client's own:
138
141
  `AGENT_SECRETS_URL`, no `--`, no `NAME`, or a flag value the client refuses.
139
142
  - **75** — the request still waits for a person. The message names who decides it, where, and the
140
143
  `agent-secrets status <request_id>` that reads it.
141
- - **77** — the request was denied.
144
+ - **77** — the request was denied. The approver denied it, the policy refused a name (a
145
+ service's secret, or one whose requesters list does not name this session), or the request
146
+ named a secret a person must approve and carried no reason, which the detail reads
147
+ `<NAME>: a reason is necessary; ask again with --reason`.
142
148
 
143
149
  The other statuses come from forms this skill does not use: 76 from `agent-secrets renew`, a
144
150
  refusal that is permanent; 126 and 127 from `agent-secrets register --exec`, whose command could not
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sjawhar/pi-envoy",
3
- "version": "16.31.1",
3
+ "version": "16.32.0",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "omp": {