@sjawhar/pi-envoy 16.25.1 → 16.26.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
|
@@ -15406,7 +15406,7 @@ var dispatchToolSpecs = [
|
|
|
15406
15406
|
{
|
|
15407
15407
|
name: "dispatch_message",
|
|
15408
15408
|
example: { issue: "DSP-1", body: "Implementation started." },
|
|
15409
|
-
description: "Post a note humans must read now: a reply to a human's message or a deliverable that landed. A to-do only a human can " + "complete is an ask (dispatch ask), so it reaches their inbox. Never progress or status updates - Dispatch is a high-signal " + "record, not a log. Not a design decision (write it as a decision block in the document) or document feedback (dispatch comment). " + "To answer a human's direct message to this session - one sent from the Agents page, which names no issue - pass that message's bare id as " + "in_reply_to and no issue; the reply lands in that conversation. Another call with the same in_reply_to and new text posts a follow-up, " + "threaded under this session's first reply; the same text again posts nothing. dispatch read --message <id> reads " + "that conversation back. " + "Every other message names its issue; keep --issue whenever the frame you answer gave one. A
|
|
15409
|
+
description: "Post a note humans must read now: a reply to a human's message or a deliverable that landed. A to-do only a human can " + "complete is an ask (dispatch ask), so it reaches their inbox. Never progress or status updates - Dispatch is a high-signal " + "record, not a log. Not a design decision (write it as a decision block in the document) or document feedback (dispatch comment). " + "To answer a human's direct message to this session - one sent from the Agents page, which names no issue - pass that message's bare id as " + "in_reply_to and no issue; the reply lands in that conversation. Another call with the same in_reply_to and new text posts a follow-up, " + "threaded under this session's first reply; the same text again posts nothing. dispatch read --message <id> reads " + "that conversation back. " + "Every other message names its issue; keep --issue whenever the frame you answer gave one. A frame reading expects_reply: optional or " + "required carries a reply_with command: answer with it, on that issue. One reading false carries none and asks for no answer; where " + "you answer one anyway, its card names what to answer. On Oh My Pi an Agents-page Send or Aside " + "arrives as a user message: answer in the conversation, with no dispatch message. " + `${BODY_BLOCK_RULE} The lines images appends count toward it. ${ISSUE_REFERENCE}`,
|
|
15410
15410
|
arguments: (z) => ({
|
|
15411
15411
|
issue: z.string().describe(`${ISSUE_REFERENCE} Omit it only when in_reply_to answers a human's direct message to this session.`).optional(),
|
|
15412
15412
|
body: z.string().describe(`Update text. ${BODY_BLOCK_RULE}`),
|
|
@@ -16733,6 +16733,7 @@ var DISPATCH_TEXT_REFERENCES = [
|
|
|
16733
16733
|
];
|
|
16734
16734
|
// ../contracts/src/envelope.ts
|
|
16735
16735
|
var isSubject = (value) => typeof value === "string" && value.length > 0;
|
|
16736
|
+
var EXPECTS_REPLY_VALUES = [false, "optional", "required"];
|
|
16736
16737
|
var EnvelopeSchema = object({
|
|
16737
16738
|
event_id: string2().min(1),
|
|
16738
16739
|
source: _enum2([
|
|
@@ -16766,7 +16767,7 @@ var EnvelopeSchema = object({
|
|
|
16766
16767
|
in_reply_to: string2().min(1).optional(),
|
|
16767
16768
|
supersedes: string2().min(1).optional(),
|
|
16768
16769
|
urgency: _enum2(["low", "med", "high", "blocking"]).optional(),
|
|
16769
|
-
expects_reply:
|
|
16770
|
+
expects_reply: literal(EXPECTS_REPLY_VALUES).optional()
|
|
16770
16771
|
});
|
|
16771
16772
|
var MINTED_DEDUPE_KEY_PATTERN = "^(?:envoy\\.role\\.forward\\.)?(?:publish|agent\\.[^.]+)\\.(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$";
|
|
16772
16773
|
var mintedDedupeKey = new RegExp(MINTED_DEDUPE_KEY_PATTERN);
|
|
@@ -16832,6 +16833,12 @@ function canonicalRepo(owner, repo) {
|
|
|
16832
16833
|
function overCapMessage(length, max) {
|
|
16833
16834
|
return `is ${length - max} characters over the ${max}-character limit (${length}/${max})`;
|
|
16834
16835
|
}
|
|
16836
|
+
function literalOfSet(api, values) {
|
|
16837
|
+
const node = api.literal?.(values);
|
|
16838
|
+
if (node === undefined || typeof node.safeParse !== "function")
|
|
16839
|
+
return;
|
|
16840
|
+
return values.every((value) => node.safeParse(value).success) ? node : undefined;
|
|
16841
|
+
}
|
|
16835
16842
|
function zodSchemaApi(zod) {
|
|
16836
16843
|
const api = zod;
|
|
16837
16844
|
return {
|
|
@@ -16860,6 +16867,7 @@ function zodSchemaApi(zod) {
|
|
|
16860
16867
|
},
|
|
16861
16868
|
boolean: () => api.boolean(),
|
|
16862
16869
|
enum: (values) => api.enum(values),
|
|
16870
|
+
literal: (values) => literalOfSet(api, values) ?? api.unknown(),
|
|
16863
16871
|
unknown: () => api.unknown(),
|
|
16864
16872
|
array: (item, opts = {}) => {
|
|
16865
16873
|
let schema = api.array(item);
|
|
@@ -18666,6 +18674,7 @@ var InboundSenderSchema = object({
|
|
|
18666
18674
|
title: string2().optional(),
|
|
18667
18675
|
roles: array(string2()).optional()
|
|
18668
18676
|
});
|
|
18677
|
+
var InboundExpectsReplySchema = literal([...EXPECTS_REPLY_VALUES, "none"]).transform((value) => value === "none" ? false : value);
|
|
18669
18678
|
var InboundEnvelopeSchema = object({
|
|
18670
18679
|
event_id: string2().optional(),
|
|
18671
18680
|
source: string2(),
|
|
@@ -18682,7 +18691,7 @@ var InboundEnvelopeSchema = object({
|
|
|
18682
18691
|
in_reply_to: string2().optional(),
|
|
18683
18692
|
supersedes: string2().optional(),
|
|
18684
18693
|
urgency: string2().optional(),
|
|
18685
|
-
expects_reply:
|
|
18694
|
+
expects_reply: InboundExpectsReplySchema.optional()
|
|
18686
18695
|
}).passthrough();
|
|
18687
18696
|
function tolerantShape(shape) {
|
|
18688
18697
|
return Object.fromEntries(Object.entries(shape).map(([key, schema]) => [key, _catch2(schema, undefined)]));
|
package/dist/envoy.js
CHANGED
|
@@ -30451,7 +30451,7 @@ var dispatchToolSpecs = [
|
|
|
30451
30451
|
{
|
|
30452
30452
|
name: "dispatch_message",
|
|
30453
30453
|
example: { issue: "DSP-1", body: "Implementation started." },
|
|
30454
|
-
description: "Post a note humans must read now: a reply to a human's message or a deliverable that landed. A to-do only a human can " + "complete is an ask (dispatch ask), so it reaches their inbox. Never progress or status updates - Dispatch is a high-signal " + "record, not a log. Not a design decision (write it as a decision block in the document) or document feedback (dispatch comment). " + "To answer a human's direct message to this session - one sent from the Agents page, which names no issue - pass that message's bare id as " + "in_reply_to and no issue; the reply lands in that conversation. Another call with the same in_reply_to and new text posts a follow-up, " + "threaded under this session's first reply; the same text again posts nothing. dispatch read --message <id> reads " + "that conversation back. " + "Every other message names its issue; keep --issue whenever the frame you answer gave one. A
|
|
30454
|
+
description: "Post a note humans must read now: a reply to a human's message or a deliverable that landed. A to-do only a human can " + "complete is an ask (dispatch ask), so it reaches their inbox. Never progress or status updates - Dispatch is a high-signal " + "record, not a log. Not a design decision (write it as a decision block in the document) or document feedback (dispatch comment). " + "To answer a human's direct message to this session - one sent from the Agents page, which names no issue - pass that message's bare id as " + "in_reply_to and no issue; the reply lands in that conversation. Another call with the same in_reply_to and new text posts a follow-up, " + "threaded under this session's first reply; the same text again posts nothing. dispatch read --message <id> reads " + "that conversation back. " + "Every other message names its issue; keep --issue whenever the frame you answer gave one. A frame reading expects_reply: optional or " + "required carries a reply_with command: answer with it, on that issue. One reading false carries none and asks for no answer; where " + "you answer one anyway, its card names what to answer. On Oh My Pi an Agents-page Send or Aside " + "arrives as a user message: answer in the conversation, with no dispatch message. " + `${BODY_BLOCK_RULE} The lines images appends count toward it. ${ISSUE_REFERENCE}`,
|
|
30455
30455
|
arguments: (z) => ({
|
|
30456
30456
|
issue: z.string().describe(`${ISSUE_REFERENCE} Omit it only when in_reply_to answers a human's direct message to this session.`).optional(),
|
|
30457
30457
|
body: z.string().describe(`Update text. ${BODY_BLOCK_RULE}`),
|
|
@@ -31718,6 +31718,7 @@ var DISPATCH_TEXT_REFERENCES = [
|
|
|
31718
31718
|
];
|
|
31719
31719
|
// ../contracts/src/envelope.ts
|
|
31720
31720
|
var isSubject = (value) => typeof value === "string" && value.length > 0;
|
|
31721
|
+
var EXPECTS_REPLY_VALUES = [false, "optional", "required"];
|
|
31721
31722
|
var EnvelopeSchema = object({
|
|
31722
31723
|
event_id: string2().min(1),
|
|
31723
31724
|
source: _enum2([
|
|
@@ -31751,7 +31752,7 @@ var EnvelopeSchema = object({
|
|
|
31751
31752
|
in_reply_to: string2().min(1).optional(),
|
|
31752
31753
|
supersedes: string2().min(1).optional(),
|
|
31753
31754
|
urgency: _enum2(["low", "med", "high", "blocking"]).optional(),
|
|
31754
|
-
expects_reply:
|
|
31755
|
+
expects_reply: literal(EXPECTS_REPLY_VALUES).optional()
|
|
31755
31756
|
});
|
|
31756
31757
|
var MINTED_DEDUPE_KEY_PATTERN = "^(?:envoy\\.role\\.forward\\.)?(?:publish|agent\\.[^.]+)\\.(?:[0-9a-f]{32}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$";
|
|
31757
31758
|
var mintedDedupeKey = new RegExp(MINTED_DEDUPE_KEY_PATTERN);
|
|
@@ -31800,6 +31801,12 @@ function slackTopicChannel(topic) {
|
|
|
31800
31801
|
function overCapMessage(length, max) {
|
|
31801
31802
|
return `is ${length - max} characters over the ${max}-character limit (${length}/${max})`;
|
|
31802
31803
|
}
|
|
31804
|
+
function literalOfSet(api, values) {
|
|
31805
|
+
const node = api.literal?.(values);
|
|
31806
|
+
if (node === undefined || typeof node.safeParse !== "function")
|
|
31807
|
+
return;
|
|
31808
|
+
return values.every((value) => node.safeParse(value).success) ? node : undefined;
|
|
31809
|
+
}
|
|
31803
31810
|
function zodSchemaApi(zod) {
|
|
31804
31811
|
const api = zod;
|
|
31805
31812
|
return {
|
|
@@ -31828,6 +31835,7 @@ function zodSchemaApi(zod) {
|
|
|
31828
31835
|
},
|
|
31829
31836
|
boolean: () => api.boolean(),
|
|
31830
31837
|
enum: (values) => api.enum(values),
|
|
31838
|
+
literal: (values) => literalOfSet(api, values) ?? api.unknown(),
|
|
31831
31839
|
unknown: () => api.unknown(),
|
|
31832
31840
|
array: (item, opts = {}) => {
|
|
31833
31841
|
let schema = api.array(item);
|
|
@@ -36476,6 +36484,7 @@ var InboundSenderSchema = object({
|
|
|
36476
36484
|
title: string2().optional(),
|
|
36477
36485
|
roles: array(string2()).optional()
|
|
36478
36486
|
});
|
|
36487
|
+
var InboundExpectsReplySchema = literal([...EXPECTS_REPLY_VALUES, "none"]).transform((value) => value === "none" ? false : value);
|
|
36479
36488
|
var InboundEnvelopeSchema = object({
|
|
36480
36489
|
event_id: string2().optional(),
|
|
36481
36490
|
source: string2(),
|
|
@@ -36492,7 +36501,7 @@ var InboundEnvelopeSchema = object({
|
|
|
36492
36501
|
in_reply_to: string2().optional(),
|
|
36493
36502
|
supersedes: string2().optional(),
|
|
36494
36503
|
urgency: string2().optional(),
|
|
36495
|
-
expects_reply:
|
|
36504
|
+
expects_reply: InboundExpectsReplySchema.optional()
|
|
36496
36505
|
}).passthrough();
|
|
36497
36506
|
function tolerantShape(shape) {
|
|
36498
36507
|
return Object.fromEntries(Object.entries(shape).map(([key, schema]) => [key, _catch2(schema, undefined)]));
|
|
@@ -37199,7 +37208,8 @@ function renderInbound(raw, sessionID, subject, wholeBody) {
|
|
|
37199
37208
|
break;
|
|
37200
37209
|
}
|
|
37201
37210
|
const role = envelope.sender?.roles?.[0];
|
|
37202
|
-
const
|
|
37211
|
+
const wantsNoReply = envelope.expects_reply === false;
|
|
37212
|
+
const reply = wantsNoReply ? undefined : dispatchReply ?? replyWith(envelope);
|
|
37203
37213
|
const sourceIssue = parseIssues.includes("source") || KNOWN_SOURCES[envelope.source] !== undefined ? undefined : `source=${envelope.source}`;
|
|
37204
37214
|
const unrecognised = [
|
|
37205
37215
|
...parseIssues,
|
|
@@ -37218,7 +37228,7 @@ function renderInbound(raw, sessionID, subject, wholeBody) {
|
|
|
37218
37228
|
...inReplyTo === undefined ? {} : { re: inReplyTo },
|
|
37219
37229
|
...envelope.supersedes === undefined ? {} : { supersedes: envelope.supersedes },
|
|
37220
37230
|
...reply === undefined ? {} : { reply_with: reply },
|
|
37221
|
-
...role === undefined ? {} : {
|
|
37231
|
+
...role === undefined || wantsNoReply ? {} : {
|
|
37222
37232
|
reply_role: {
|
|
37223
37233
|
tool: "envoy_publish",
|
|
37224
37234
|
args: { topic: `notifications.role.${role}`, message: "..." }
|
|
@@ -39140,6 +39150,9 @@ function replayLedgerIdentity(frame) {
|
|
|
39140
39150
|
...frame.dedupe_key === undefined || !dedupeKeyNamesItsEvent(frame) ? {} : { dedupe_key: frame.dedupe_key }
|
|
39141
39151
|
};
|
|
39142
39152
|
}
|
|
39153
|
+
var StoredEnvelopeSchema = EnvelopeSchema.extend({
|
|
39154
|
+
expects_reply: InboundExpectsReplySchema.optional()
|
|
39155
|
+
});
|
|
39143
39156
|
function parseEnvelope(data) {
|
|
39144
39157
|
let parsed;
|
|
39145
39158
|
try {
|
|
@@ -39147,7 +39160,7 @@ function parseEnvelope(data) {
|
|
|
39147
39160
|
} catch {
|
|
39148
39161
|
return;
|
|
39149
39162
|
}
|
|
39150
|
-
const result =
|
|
39163
|
+
const result = StoredEnvelopeSchema.safeParse(parsed);
|
|
39151
39164
|
return result.success ? result.data : undefined;
|
|
39152
39165
|
}
|
|
39153
39166
|
function createLedger(now) {
|
|
@@ -41660,13 +41673,12 @@ var DELIVERY_CONTRACT = "Delivery is at-least-once, possibly out of order across
|
|
|
41660
41673
|
var STORED_DELIVERY = "Stored topics (agent, dispatch, github, slack, legion, ghostwispr, whatsapp; a role message " + "reaches its holder as a stored copy on the holder's agent topic) reach each subscribed session " + "once from the durable consumer its listener relays to it, also one that was away or restarted. " + "Team and other ad-hoc topics are live only.";
|
|
41661
41674
|
var TOPIC_GUIDE = "Topic guide (all are under notifications.): agent.<session_id> (subscribe: own inbox); role.<role> " + "(publish-to; holders claim via envoy_role_set). > matches one or more trailing tokens and does not " + "match the base subject. Envoy registers the concrete base when you subscribe to <subject>.>, so " + "the recommended default remains github.<owner>.<repo>.pr.<n>.>. <owner> and <repo> are one token " + "each, with every dot in the name written _ (sjawhar/.github is github.sjawhar._github; " + "acme/site.io is github.acme.site_io), and a topic spelled with the dot receives nothing. " + "Default PR subscription: " + "github.<owner>.<repo>.pr.<n>.> (it receives the quiet PR family): pr.<n> (lifecycle: " + "opened/synchronize/closed; closed carries merged, merge_commit_sha, merged_by, head_sha), " + "pr.<n>.comment, pr.<n>.review, pr.<n>.mention, pr.<n>.checks (one settlement event per commit whose checks settle, the head or not, naming its sha: " + 'passed/failed/cancelled/skipped with failing names and URLs; re-fires with superseded_settlement: "true" ' + "when new runs appear for the same commit). Other GitHub: issue.<n>, issue.<n>.comment, " + "issue.<n>.mention, mention, push.branch.<name>, push.tag.<name>, workflow.<file>.<action> (only " + "runs without an associated PR); slack.<team>.<channel>.message|mention and " + "slack.<team>.<channel>.thread.<ts>.message|mention; ghostwispr.<session>.<kind>; " + "whatsapp.<phone>.<jid>.<kind>; envoy.exceptions.<original-topic>.";
|
|
41662
41675
|
var URGENCY_VALUES = EnvelopeSchema.shape.urgency.unwrap().options;
|
|
41663
|
-
var EXPECTS_REPLY_VALUES = EnvelopeSchema.shape.expects_reply.unwrap().options;
|
|
41664
41676
|
function messageMetadataShape(schema) {
|
|
41665
41677
|
return {
|
|
41666
41678
|
in_reply_to: schema.string().optional(),
|
|
41667
41679
|
supersedes: schema.string().optional(),
|
|
41668
41680
|
urgency: schema.enum(URGENCY_VALUES).describe("low | med | high | blocking: how soon the recipient should act, shown on its card. It does not deliver the message sooner or ahead of others.").optional(),
|
|
41669
|
-
expects_reply: schema.
|
|
41681
|
+
expects_reply: schema.literal(EXPECTS_REPLY_VALUES).describe("false | optional | required").optional(),
|
|
41670
41682
|
expires_at: schema.number({ int: true }).optional()
|
|
41671
41683
|
};
|
|
41672
41684
|
}
|
|
@@ -42124,7 +42136,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
|
|
|
42124
42136
|
|
|
42125
42137
|
// package.json
|
|
42126
42138
|
var name = "@sjawhar/pi-envoy";
|
|
42127
|
-
var version2 = "16.
|
|
42139
|
+
var version2 = "16.26.0";
|
|
42128
42140
|
var package_default = {
|
|
42129
42141
|
name,
|
|
42130
42142
|
version: version2,
|
|
@@ -11,15 +11,15 @@ Envoy delivers external events and messages between sessions. Delivery is at-lea
|
|
|
11
11
|
|
|
12
12
|
## Send a message to another session
|
|
13
13
|
|
|
14
|
-
- Take the target id from the delivery's `reply_with`, or from `envoy_sessions` (filter by `machine`, `dir` or `title`). Never address a tmux pane or window: Envoy delivers only to a session id, and the session in a pane can change.
|
|
14
|
+
- Take the target id from the delivery's `reply_with`, or, where the delivery wants no reply and carries none, from its `from`; or from `envoy_sessions` (filter by `machine`, `dir` or `title`). Never address a tmux pane or window: Envoy delivers only to a session id, and the session in a pane can change.
|
|
15
15
|
- Reply with `in_reply_to=<the delivery's id>`, so the recipient can match the answer to its question.
|
|
16
16
|
- Read the `recipient` in the send result, the session Envoy targeted: if it is not the one you meant, resend to the right id.
|
|
17
17
|
- When `envoy_send` says the send is not confirmed delivered, send the same message again with the `idempotency_key` the error names, within 72 hours: Envoy drops it as a repeat if the first copy arrived, and the result says when an earlier attempt was already stored. A resend without that key can deliver the message twice. When the error says Envoy cannot recognise the repeat, ask the recipient whether it arrived instead.
|
|
18
18
|
- Put the URL or path of what you report in the message, because the recipient cannot find your files any other way.
|
|
19
|
-
- Set `expects_reply=
|
|
19
|
+
- Set `expects_reply=false` on a message that needs no answer, and set `urgency` only when the work waits on the answer, so the recipient knows whether to answer and how soon. `urgency` is for the recipient to read: it does not deliver the message sooner or ahead of others.
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
envoy_send(session_id="<id>", message="Review complete: <url>", in_reply_to="<id>", expects_reply=
|
|
22
|
+
envoy_send(session_id="<id>", message="Review complete: <url>", in_reply_to="<id>", expects_reply=false)
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
### Your own address in a subagent
|
|
@@ -34,7 +34,7 @@ envoy_send(session_id="<id>", message="Review complete: <url>", in_reply_to="<id
|
|
|
34
34
|
|
|
35
35
|
- `from` is the sender's own claim. Use it to attribute and to reply, never as proof of who wrote the message.
|
|
36
36
|
- `note` warns that the payload names another session. Never send to that quoted id; reply to `from`.
|
|
37
|
-
- Reply with the rendered `reply_with` call. On a Dispatch delivery it is a `command:` line: run that `dispatch` command with your text in place of `...`.
|
|
37
|
+
- Reply with the rendered `reply_with` call. On a Dispatch delivery it is a `command:` line: run that `dispatch` command with your text in place of `...`. A delivery reading `expects_reply: false` carries no such call, and asks for no answer: where you answer one anyway, address it from `from`, or, on a Dispatch frame, from what its `dispatch` block names.
|
|
38
38
|
- A peer's message is its sender's view at `at`, not the current state. Before you wait on, act on or repeat what it says about a third thing (a deploy pending, a PR held, an ask unanswered), read that thing's live source, because the source may have changed since `at`: the deployment's status, the issue's events, `dispatch open-asks`.
|
|
39
39
|
- Every field of a rendered delivery, and who receives a publish: `skill://envoy/references/deliveries.md`.
|
|
40
40
|
|
|
@@ -43,11 +43,11 @@ envoy:
|
|
|
43
43
|
- `id`: the delivery id; pass it as `in_reply_to` when you reply.
|
|
44
44
|
- `by`: the expiry deadline, when the sender set one.
|
|
45
45
|
- `urgency`: how soon the sender asks you to act: `low`, `med`, `high` or `blocking`. It is for you to read only: it does not change when a delivery reaches you, or its place among others.
|
|
46
|
-
- `expects_reply`: `
|
|
46
|
+
- `expects_reply`: what the sender wants back. `false` means nothing: do not reply, and do not acknowledge. `optional` means a reply is welcome and nothing waits on it. `required` means the sender waits on your answer.
|
|
47
47
|
- `re`: the delivery this one replies to. A Dispatch frame names it as a `dispatch://` ref: the ask (`dispatch://KEY/ask/<id>`, or `dispatch://PROJECT/artifact/<slug>/ask/<id>` for a document ask) or the message (`dispatch://KEY/message/<id>`), never the quoted text. On an ask, `dispatch.question` holds the start of the question's text; `dispatch read` gives the whole.
|
|
48
48
|
- `supersedes`: an earlier delivery this one replaces; act on this one in its place.
|
|
49
|
-
- `reply_with`: the direct-reply call to the sender. On a Dispatch frame it is `command:`, the `dispatch` command line that answers it, with `...` where your text goes.
|
|
50
|
-
- `reply_role`: the role-publish reply call, when the sender holds a role.
|
|
49
|
+
- `reply_with`: the direct-reply call to the sender. On a Dispatch frame it is `command:`, the `dispatch` command line that answers it, with `...` where your text goes. It is absent when `expects_reply` is `false`: a delivery that wants nothing back offers no way to send something. Where you answer one anyway, the card still names what you need — a Dispatch frame names its comment, message or ask, and an agent's delivery names its `id` and its sender.
|
|
50
|
+
- `reply_role`: the role-publish reply call, when the sender holds a role. It is absent under `false` for the same reason.
|
|
51
51
|
- `summary`: the one-line source summary.
|
|
52
52
|
- `message`: the complete payload; it can hold several paragraphs.
|
|
53
53
|
- `note`: the payload names another session; never use that quoted id as the recipient.
|