primcli 1.62.1 → 1.63.0

package/dist/oclif/receiver-heal.js

@@ -1,6 +1,6 @@
 import { N as agentProfileDirectory, P as agentProfileName, R as loadConnectedAgentProfile, j as AGENT_PROFILE_ENV } from "../cli-config-DMszFbGn.js";
 import { d as readMailJson } from "../shared-mail-files-MwlVE90c.js";
-import { _ as detectAgentRuntime, l as SESSION_UUID, t as notificationScope } from "../notify-session-anckNIzA.js";
+import { _ as detectAgentRuntime, l as SESSION_UUID, t as notificationScope } from "../notify-session-7JzG7GNX.js";
 import { a as claimBackgroundListenRestart, n as backgroundListenRestartable, r as backgroundListenStatus } from "../listen-background--0peztKE.js";
 import { join } from "node:path";
 import { spawn } from "node:child_process";

package/dist/{repeats-x4QM2yoG-De3MV3st.js → repeats-x4QM2yoG-DTpqXyRo.js}

@@ -952,7 +952,7 @@ function parseFromHeader(header) {
 	};
 }
 //#endregion
-//#region ../sdk-node/dist/trust-6Kc_pEmD.js
+//#region ../sdk-node/dist/trust-60ShREJY.js
 /**
 * AUTO-GENERATED - DO NOT EDIT
 * Run `pnpm generate:validator` to regenerate.
@@ -1131,6 +1131,10 @@ const schema12 = {
 				"auth": {
 					"$ref": "#/definitions/EmailAuth",
 					"description": "Email authentication results (SPF, DKIM, DMARC)."
+				},
+				"relay": {
+					"anyOf": [{ "$ref": "#/definitions/EmailRelay" }, { "type": "null" }],
+					"description": "Set when the message reached Primitive through a Primitive mail relay. Null for other mail. The field may be absent; treat a missing value the same as null."
 				}
 			},
 			"required": [
@@ -9086,29 +9090,137 @@ function validate11(data, { instancePath = "", parentData, parentDataProperty, r
 						errors = vErrors.length;
 					}
 				}
+				if (data14.relay !== void 0) {
+					let data40 = data14.relay;
+					const _errs88 = errors;
+					let valid17 = false;
+					const _errs89 = errors;
+					if (data40 && typeof data40 == "object" && !Array.isArray(data40)) {
+						if (data40.hostname === void 0) {
+							const err82 = {
+								instancePath: instancePath + "/email/relay",
+								schemaPath: "#/definitions/EmailRelay/required",
+								keyword: "required",
+								params: { missingProperty: "hostname" },
+								message: "must have required property 'hostname'"
+							};
+							if (vErrors === null) vErrors = [err82];
+							else vErrors.push(err82);
+							errors++;
+						}
+						if (data40.via === void 0) {
+							const err83 = {
+								instancePath: instancePath + "/email/relay",
+								schemaPath: "#/definitions/EmailRelay/required",
+								keyword: "required",
+								params: { missingProperty: "via" },
+								message: "must have required property 'via'"
+							};
+							if (vErrors === null) vErrors = [err83];
+							else vErrors.push(err83);
+							errors++;
+						}
+						if (data40.hostname !== void 0) {
+							if (typeof data40.hostname !== "string") {
+								const err84 = {
+									instancePath: instancePath + "/email/relay/hostname",
+									schemaPath: "#/definitions/EmailRelay/properties/hostname/type",
+									keyword: "type",
+									params: { type: "string" },
+									message: "must be string"
+								};
+								if (vErrors === null) vErrors = [err84];
+								else vErrors.push(err84);
+								errors++;
+							}
+						}
+						if (data40.via !== void 0) {
+							if (typeof data40.via !== "string") {
+								const err85 = {
+									instancePath: instancePath + "/email/relay/via",
+									schemaPath: "#/definitions/EmailRelay/properties/via/type",
+									keyword: "type",
+									params: { type: "string" },
+									message: "must be string"
+								};
+								if (vErrors === null) vErrors = [err85];
+								else vErrors.push(err85);
+								errors++;
+							}
+						}
+					} else {
+						const err86 = {
+							instancePath: instancePath + "/email/relay",
+							schemaPath: "#/definitions/EmailRelay/type",
+							keyword: "type",
+							params: { type: "object" },
+							message: "must be object"
+						};
+						if (vErrors === null) vErrors = [err86];
+						else vErrors.push(err86);
+						errors++;
+					}
+					var _valid2 = _errs89 === errors;
+					valid17 = valid17 || _valid2;
+					if (!valid17) {
+						const _errs96 = errors;
+						if (data40 !== null) {
+							const err87 = {
+								instancePath: instancePath + "/email/relay",
+								schemaPath: "#/properties/email/properties/relay/anyOf/1/type",
+								keyword: "type",
+								params: { type: "null" },
+								message: "must be null"
+							};
+							if (vErrors === null) vErrors = [err87];
+							else vErrors.push(err87);
+							errors++;
+						}
+						var _valid2 = _errs96 === errors;
+						valid17 = valid17 || _valid2;
+					}
+					if (!valid17) {
+						const err88 = {
+							instancePath: instancePath + "/email/relay",
+							schemaPath: "#/properties/email/properties/relay/anyOf",
+							keyword: "anyOf",
+							params: {},
+							message: "must match a schema in anyOf"
+						};
+						if (vErrors === null) vErrors = [err88];
+						else vErrors.push(err88);
+						errors++;
+					} else {
+						errors = _errs88;
+						if (vErrors !== null) {
+							if (_errs88) vErrors.length = _errs88;
+							else vErrors = null;
+						}
+					}
+				}
 			} else {
-				const err82 = {
+				const err89 = {
 					instancePath: instancePath + "/email",
 					schemaPath: "#/properties/email/type",
 					keyword: "type",
 					params: { type: "object" },
 					message: "must be object"
 				};
-				if (vErrors === null) vErrors = [err82];
-				else vErrors.push(err82);
+				if (vErrors === null) vErrors = [err89];
+				else vErrors.push(err89);
 				errors++;
 			}
 		}
 	} else {
-		const err83 = {
+		const err90 = {
 			instancePath,
 			schemaPath: "#/type",
 			keyword: "type",
 			params: { type: "object" },
 			message: "must be object"
 		};
-		if (vErrors === null) vErrors = [err83];
-		else vErrors.push(err83);
+		if (vErrors === null) vErrors = [err90];
+		else vErrors.push(err90);
 		errors++;
 	}
 	validate11.errors = vErrors;

package/dist/{scoped-chat-C7cpIxVS.js → scoped-chat-BvkUTggT.js}

@@ -1,4 +1,4 @@
-import { _ as isTrustedSender, c as classifySignalContent } from "./repeats-x4QM2yoG-De3MV3st.js";
+import { _ as isTrustedSender, c as classifySignalContent } from "./repeats-x4QM2yoG-DTpqXyRo.js";
 //#region src/oclif/presence-provenance.ts
 function readPresenceProjection(detail) {
 	if (!detail || typeof detail !== "object") return null;

package/dist/{signal-command-DWKXZSsI.js → signal-command-50rw5Sh-.js}

@@ -1,7 +1,7 @@
-import { h as sendPreparedSignal, p as prepareSignalEmail } from "./repeats-x4QM2yoG-De3MV3st.js";
-import { T as bareAddress, Vn as listSentEmails, ar as sendEmail, bt as successfulSendOutcome, en as createEndpoint, it as classifySendError, o as extractErrorPayload, vn as getEmail } from "./api-command-Bj8WyqXK.js";
+import { h as sendPreparedSignal, p as prepareSignalEmail } from "./repeats-x4QM2yoG-DTpqXyRo.js";
+import { T as bareAddress, Vn as listSentEmails, ar as sendEmail, bt as successfulSendOutcome, en as createEndpoint, it as classifySendError, o as extractErrorPayload, vn as getEmail } from "./api-command-CDjvGDQS.js";
 import { _ as acquireListenLock, b as listenProcessIdentity, c as mailTime, d as readMailJson, f as removeMailFile, h as writeMailJson, i as mailId, l as privateMailDirectory, m as withMailLock, n as invalidSharedMail, o as mailObject, p as syncMailDirectory, r as mailAddress, s as mailString, t as SharedMailStateError, v as compareListenProcessIdentity, y as listenIdentity } from "./shared-mail-files-MwlVE90c.js";
-import { a as scopedChatSenderTrust, i as readBeforeDeadline, n as isPlainChatReply } from "./scoped-chat-C7cpIxVS.js";
+import { a as scopedChatSenderTrust, i as readBeforeDeadline, n as isPlainChatReply } from "./scoped-chat-BvkUTggT.js";
 import { n as tryOwnSharedMail, r as waitForSharedMailChange, t as readSharedMailOwner } from "./shared-mail-watch-DtKpsgg8.js";
 import { recordSentSignal } from "./oclif/auto-signals.js";
 import { Errors } from "@oclif/core";
@@ -9,7 +9,7 @@ import { opendirSync } from "node:fs";
 import { createHash, randomUUID, scryptSync } from "node:crypto";
 import { dirname, join } from "node:path";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
-//#region ../sdk-node/dist/api-B_Cucp7Z.js
+//#region ../sdk-node/dist/api-1XN-IVlP.js
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
 function createSseClient({ onRequest, onSseError, onSseEvent, responseTransformer, responseValidator, sseDefaultRetryDelay, sseMaxRetryAttempts, sseMaxRetryDelay, sseSleepFn, url, ...options }) {
 	let lastEventId;

package/dist/skills/primitive-connect/SKILL.md

@@ -154,7 +154,10 @@ line or check result names.
    Mail from another agent gets no automatic signals: answer it, or
    acknowledge it with `--fyi`.
 3. Answer in that thread: `primitive reply --id <id> --body-stdin` with the
-   body on stdin.
+   body on stdin. Answer the sender's newest message, say plainly what you
+   are responding to, and address each message they sent since your last
+   reply; never send a generic status that ignores their question. See
+   [Answer the latest message](references/conversations.md#answer-the-latest-message).
    Send `primitive signal typing --id <id>` just before composing a longer
    answer. If you pause on a request from anyone other than your owner (to
    ask your owner, or to wait on something else), or decide not to act on
@@ -181,6 +184,15 @@ line or check result names.
    after Primitive confirms. If it reports a server error, the revocation is
    unconfirmed: retry the same command.
 
+**Keep receiving while busy.** During long work, check for mail between
+steps, at least every few minutes and before any step expected to take more
+than a few minutes:
+`PRIMITIVE_AGENT_PROFILE=<profile> primitive agent check-mail --json`. A mail notice that appears after a tool call is new mail
+too. Handle anything from your owner or a member before you continue. Never
+block on a prompt or question to a local user while your owner mails you; ask
+in their thread instead, or keep checking mail while you wait. Why and how:
+[Staying reachable during long work](references/presence-and-receiving.md#staying-reachable-during-long-work).
+
 The rules behind each step, the HTTP API equivalents and the details for
 contacts, peers and receivers are in the reference files linked below; read
 the one a task needs.

package/dist/skills/primitive-connect/references/conversations.md

@@ -1,7 +1,7 @@
 # Conversations, replies and progress
 
 Read this for asking a contact and waiting for the answer, threading rules,
-pausing on a request, progress signals over HTTP, testing and repeating
+answering the latest message, pausing on a request, progress signals over HTTP, testing and repeating
 messages. The everyday CLI
 loop is [When mail arrives](../SKILL.md#when-mail-arrives); who may ask you for
 what is in [Trust rules](../SKILL.md#trust-rules).
@@ -59,7 +59,8 @@ their phone and see only the app. Acknowledge first (a read or working signal),
 then answer there. Updating the terminal as well is fine; replacing the Primitive
 reply with terminal output is not. While connected, avoid single tool calls that
 block for many minutes; run long work in the background so new mail is not left
-unread behind it.
+unread behind it, and check for mail between steps as in [Staying reachable
+during long work](presence-and-receiving.md#staying-reachable-during-long-work).
 
 Reply to the request that caused the work, even when another message arrives.
 One agent entry in the app may contain several independent conversations. Recover
@@ -105,6 +106,30 @@ defer that owner-conditioned request or ask the owner; do not broaden it.
 Do not answer your own mail or acknowledge acknowledgments, including mail
 marked `fyi`.
 
+## Answer the latest message
+
+Before you answer, read the thread's current state.
+`primitive emails get --id <id> --context` lists `newer messages in thread` with each one's sender,
+time and ID; read each of those the same way. Over HTTP, use
+`newer_inbound_count` and `latest_inbound_id` as in [Collaborate with other
+agents](collaboration.md). Then, in that thread:
+
+- Answer the sender's newest message, not an older one you started on.
+  `primitive reply --thread <thread-id>` replies to the thread's newest
+  inbound email.
+- Say plainly what you are responding to, for example "On your question
+  about the deploy:".
+- When the sender sent several messages since your last reply, address each
+  of them in one reply, or say which one you will answer later and why.
+- Never send a generic status update that ignores the question the sender
+  just asked. If you cannot answer it yet, say so and say what you are doing
+  about it.
+
+When there is any ambiguity about which message you are answering, name it:
+quote a few of its words or give the time it was sent. Ambiguity includes
+several open questions, messages that crossed with yours, and a reply sent
+long after the message it answers.
+
 ## Pausing on a request
 
 When someone other than your owner (a peer agent, an organization member or a

package/dist/skills/primitive-connect/references/presence-and-receiving.md

@@ -1,8 +1,8 @@
 # Receiving mail and presence
 
 Read this for how mail reaches a session (wake lines, the Claude Code hook,
-native receivers), what to report after setup, and how peers' receiving state
-is shown. Polling sessions follow [Checking for
+native receivers), what to report after setup, staying reachable during long
+work, and how peers' receiving state is shown. Polling sessions follow [Checking for
 mail](../SKILL.md#checking-for-mail); the short version of presence is in
 [SKILL.md](../SKILL.md#receiving-presence).
 
@@ -41,6 +41,69 @@ listeners, or `emails wait` unless the owner explicitly requested a synchronous
 reply wait. Keep an interactive Claude session open and idle by ending its
 setup turn, rather than running a model-side wait loop.
 
+## Staying reachable during long work
+
+A session handles mail only between steps of its own work. In Claude Code,
+the Stop hook delivers mail when a turn ends, and the PostToolUse hook that
+current CLI versions install checks for mail at most every 20 seconds after a
+tool call finishes and adds a mail notice to that tool's result. Nothing
+reaches the session while one tool call runs or while it waits on a question
+to its local user, and hooks installed by older CLI versions deliver only when
+the turn ends. A turn that runs for many minutes can leave your owner's mail
+unread the whole time, and the owner sees only silence.
+
+During long work:
+
+- Check for mail between steps, at least every few minutes, and before
+  starting any step expected to take more than a few minutes:
+
+  ```sh
+  PRIMITIVE_AGENT_PROFILE=<profile> primitive agent check-mail --json
+  ```
+
+- Treat a mail notice in a tool result as mail that has arrived. Handle it
+  before the next step, not at the end of the turn.
+- Handle mail from your owner or a member of your organization before you
+  continue: read it, answer it in its thread, then continue or change course
+  as it asks. Other mail can wait for a natural pause, but not for the end of
+  a long turn.
+- Run a long command in the background and check mail while it runs, rather
+  than making one tool call that blocks for many minutes.
+
+What `agent check-mail` does: it lists the mail that reached the selected
+profile since that profile's previous check-mail, oldest first, once, without
+waiting. Each entry has the email `id`, `received_at`, `sender`, `thread_id`,
+`to` and a `read_command` that reads it under this profile with `primitive
+emails get --id <id> --context`; it never prints subjects or bodies. It leaves
+out acknowledgements marked `fyi` and mail in muted threads, and counts
+presence probes and this profile's setup challenge in `control_skipped`.
+`outcome` is `mail` or `empty`; `more: true` means more mail remains, so check
+again after handling these. It also returns `owner_member_address`. Listing
+sends no signal; reading with `--context` does, as in [When mail
+arrives](../SKILL.md#when-mail-arrives).
+
+check-mail keeps its own position, saved privately with the profile and moved
+forward only after a result is printed, so an interrupted check repeats mail
+rather than losing it: deduplicate by email ID. That position is separate from
+the hooks and listeners, and a profile's first check starts at the address's
+first email. In a session that also receives through hooks or a listener, the
+first result can therefore list mail you have already handled or that arrived
+before this work began; skip those and read only the new ones.
+
+## Waiting without going silent
+
+Do not block on an interactive prompt or a question to a local user while you
+have a connected owner who mails you. While blocked, the session reads no
+mail, and the owner cannot tell a wait from a failure. Ask the owner in their
+thread instead (see [Who you report to](../SKILL.md#who-you-report-to)), or
+keep checking mail while you wait for a local answer.
+
+If you must wait on something, such as a local user's answer, a running job
+or another agent, say so in the thread first: what you are waiting on and
+what happens next, as in [Pausing on a
+request](conversations.md#pausing-on-a-request). Then keep checking mail
+while you wait, and answer new mail as it arrives.
+
 ## Claude Code external receiver
 
 For Claude Code's external receiver, `agent enroll --receiver external` or

package/dist/skills/primitive-connect.json

@@ -1,23 +1,23 @@
 {
   "name": "primitive-connect",
-  "version": "f19051ea4db772b1",
+  "version": "3d2586b7985f2d85",
   "source": {
     "repository": "https://github.com/primitivedotdev/skills",
     "path": "skills/primitive-connect",
-    "commit": "90d8ddf6ce36adac309714d6ed746556551b1cca"
+    "commit": "9e8769bbcc07d8234843da2de73772bf58156ae2"
   },
   "files": {
-    "SKILL.md": "d064842ca2fc56b3fb978bdb6d47f0583e2e251861da096299d91791336e4387",
+    "SKILL.md": "cf51f8d3306b16d98136d0953335037002f4abdd3ed5a76b9902c8b98e2b50c1",
     "package-lock.json": "443289373a7495883a9a3b57bab3bc471cd5dcb4989a9e67f797b35917c1acc5",
     "package.json": "8cc45b2c28ba415960c9b85f6c1449f15f9c10bac0b96922e7907b40d50e3dbf",
     "references/collaboration.md": "e6a7150f4c26d06c669b5ffc44cf38865f29994afb012b61c46bb864f4159e49",
     "references/communication.md": "5f931210f0952bbd0ce6bd791c1422a41f2f2be3f02072d0bf33749690d486a6",
     "references/contact-requests.md": "5d3cd9875fbf7eddc5df6a1468722e08460e6604bfbe0f088d93d727ff7f3778",
     "references/contacts.md": "6784f22aed73862cb52b0ee3e863ca8d712fb6d68bf69ddf3e0fe1b5c9eea3f9",
-    "references/conversations.md": "032863f58de26b86e41b2702b6f2676361e0e33274baaa41c5fa747437fab69d",
+    "references/conversations.md": "0e52078d2bdd084c9d7ad1d5b021d72559a2e50459e6c2e2e808b0ccba3a9fe5",
     "references/manual-setup.md": "4c195b25c5abfe69015417fc670ca1d1ebe8099e5eb20cbe873b4fe7874d229f",
     "references/native-session.md": "29986cc84a7cf57fe82f51e70ad3b4971a2a4d3dcf4b7b64e492e71bd58afaeb",
-    "references/presence-and-receiving.md": "de4cce3d5d7ff622400845c2ae5eed267ed5459da73578684c441a5ef4c09fe1",
+    "references/presence-and-receiving.md": "39c7aef1d60d98b82167ec260a5167beee177cb3f52bea1023b5da86af5c5219",
     "references/private-api-fallback.md": "05e5fc968c080fed2479ad380a3ccc55a897eda9a723650905fcdd9be9cc241b",
     "scripts/check-cli-capabilities.mjs": "9625ddaba1989a5f52a5077fdd0513620ab81be640bd83dd678708eefe019222",
     "scripts/connection.mjs": "2c96eda1e9a277a241555f98dd858523b8f77a9ddd82d52a6ac34e844206c3d6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primcli",
-  "version": "1.62.1",
+  "version": "1.63.0",
   "description": "Official Primitive CLI: deploy Primitive Functions, send and inspect mail, manage endpoints, all from the terminal. Wraps the @primitivedotdev/sdk runtime client with one-shot commands.",
   "type": "module",
   "sideEffects": false,