@sjawhar/pi-envoy 13.11.1 → 13.13.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/dispatch.js CHANGED
@@ -15519,7 +15519,7 @@ var dispatchToolSpecs = [
15519
15519
  {
15520
15520
  name: "dispatch_whoami",
15521
15521
  example: {},
15522
- description: "Who Dispatch takes this session for: {session, owner}. owner is the lowercase email of the person whose personal token you run under (the first choice of assignee for issues you create), or null under the shared token, in which case a create with no assignee falls back to the parent's assignee and then to the project's default assignee.",
15522
+ description: "Who Dispatch takes this session for: {session, owner, service, project}. session is the session Dispatch records your writes as. It is the session your credential proved, and the tool says so when that is not the session you run in. owner is the lowercase email of the person you act for, and is the first choice of assignee for issues you create. owner is null under the shared token. With a null owner, a create with no assignee falls back to the parent's assignee and then to the project's default assignee. service is the subject of the verified service-account token that authenticated you, or null. project is the one project key your credential may write, or null when it names none.",
15523
15523
  arguments: () => ({}),
15524
15524
  strict: true
15525
15525
  }
@@ -19704,10 +19704,16 @@ async function executeDispatchTool(input) {
19704
19704
  const identity = await client.whoami();
19705
19705
  const owner = identity.kind === "agent" ? identity.owner : identity.login.toLowerCase();
19706
19706
  const service = identity.kind === "agent" ? identity.service ?? null : null;
19707
+ const proved = identity.kind === "agent" ? identity.session ?? null : null;
19708
+ const project = identity.kind === "agent" ? identity.project ?? null : null;
19709
+ const session = proved ?? sessionId;
19707
19710
  const unowned = "no owner, so an issue you create without an assignee takes its parent's assignee, else the project's default assignee, else nobody.";
19711
+ const acting = owner !== null ? `Session ${session} acts for ${owner}: issues you create without an assignee are assigned to ${owner}.` : service !== null ? `Session ${session} runs as service ${serviceSubjectLabel(service)}: ${unowned}` : `Session ${session} runs under the shared token: ${unowned}`;
19712
+ const elsewhere = proved !== null && proved !== sessionId ? ` Your credential names session ${proved}, which is not this host session (${sessionId}): Dispatch records every write you make as ${proved}.` : "";
19713
+ const writable = project !== null ? ` It may write project ${project} and no other.` : "";
19708
19714
  return {
19709
- text: owner !== null ? `Session ${sessionId} acts for ${owner}: issues you create without an assignee are assigned to ${owner}.` : service !== null ? `Session ${sessionId} runs as service ${serviceSubjectLabel(service)}: ${unowned}` : `Session ${sessionId} runs under the shared token: ${unowned}`,
19710
- details: { session: sessionId, owner, service }
19715
+ text: acting + elsewhere + writable,
19716
+ details: { session, owner, service, project }
19711
19717
  };
19712
19718
  }
19713
19719
  const args = checked.args;
package/dist/envoy.js CHANGED
@@ -30589,7 +30589,7 @@ var dispatchToolSpecs = [
30589
30589
  {
30590
30590
  name: "dispatch_whoami",
30591
30591
  example: {},
30592
- description: "Who Dispatch takes this session for: {session, owner}. owner is the lowercase email of the person whose personal token you run under (the first choice of assignee for issues you create), or null under the shared token, in which case a create with no assignee falls back to the parent's assignee and then to the project's default assignee.",
30592
+ description: "Who Dispatch takes this session for: {session, owner, service, project}. session is the session Dispatch records your writes as. It is the session your credential proved, and the tool says so when that is not the session you run in. owner is the lowercase email of the person you act for, and is the first choice of assignee for issues you create. owner is null under the shared token. With a null owner, a create with no assignee falls back to the parent's assignee and then to the project's default assignee. service is the subject of the verified service-account token that authenticated you, or null. project is the one project key your credential may write, or null when it names none.",
30593
30593
  arguments: () => ({}),
30594
30594
  strict: true
30595
30595
  }
@@ -37276,7 +37276,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
37276
37276
 
37277
37277
  // package.json
37278
37278
  var name = "@sjawhar/pi-envoy";
37279
- var version2 = "13.11.1";
37279
+ var version2 = "13.13.0";
37280
37280
  var package_default = {
37281
37281
  name,
37282
37282
  version: version2,
@@ -24,7 +24,6 @@ Which machines, files or people, the numbers, then "A happens to X, or B to Y?"
24
24
  :::
25
25
  ```
26
26
 
27
- - A to-do or permission only a person can give, or a decision with no document, is a `dispatch ask`.
28
27
  - In Legion, fix a clear defect in code your tree uses, hand others to the controller, and ask about decisions (`skill://legion-worker/references/findings.md`).
29
28
  - An open ask is the request. Do not repeat it in each message.
30
29
  - Change an open ask's block with `dispatch edit-ask`, or `doc-edit`'s `replace` or `move`. An answered ask is fixed: ask anew.
@@ -79,7 +78,7 @@ dispatch://PROJECT/artifact/<slug>/ask/<id>
79
78
  dispatch://PROJECT/artifact/<slug>/comment/<id>#b-<block>[@vN]
80
79
  ```
81
80
 
82
- A bare id or filename is not a reference. Write each id whole, from `dispatch read`'s `Ask id:` or the page URL: the command takes a prefix, a person's link does not.
81
+ A bare id, filename or local path is not a reference, and outside Dispatch neither is `dispatch://`: give the `https://` link `dispatch` printed. Write each id whole, from `dispatch read`'s `Ask id:` or the page URL: the command takes a prefix, a person's link does not.
83
82
 
84
83
  ## Setup and the HTTP API
85
84
 
@@ -51,7 +51,7 @@ For each spec, ask, comment and message:
51
51
 
52
52
  1. After a person's answer, comment or edit, rewrite what it touches; delete what it contradicts. Never narrate an edit or what used to be here; versions and comments hold the history. Reply in a comment's thread.
53
53
  2. Before each spec write, paste the whole spec, never a path, into a fresh subagent's assignment. It lists gaps, conflicts, uncheckable requirements, unclear text, and missing or needless questions. Fix or record each.
54
- 3. Before each approval request, a read-only agent checks its facts: `task(agent="scout")`.
54
+ 3. Before each approval request, `wait` for a read-only fact check: `task(agent="scout")`.
55
55
  4. Name each version with `dispatch doc-edit --summary`.
56
56
 
57
57
  ## Decisions
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sjawhar/pi-envoy",
3
- "version": "13.11.1",
3
+ "version": "13.13.0",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "omp": {