primcli 1.72.2 → 1.74.0

package/dist/{scoped-chat-DTFkP360.js → scoped-chat-DAiOb622.js}

@@ -1,4 +1,4 @@
-import { c as classifySignalContent, y as isTrustedSender } from "./repeats-BL7ZC-_6-CKMKBlx7.js";
+import { b as retryTransient, c as classifySignalContent, q as isTrustedSender } from "./repeats-BL7ZC-_6-B_ESsWTH.js";
 //#region src/oclif/presence-provenance.ts
 function readPresenceProjection(detail) {
 	if (!detail || typeof detail !== "object") return null;
@@ -50,6 +50,14 @@ async function readBeforeDeadline(deadline, read) {
 		clearTimeout(timer);
 	}
 }
+/**
+* readBeforeDeadline for a generated-client read inside a wait: a rate
+* limit, gateway failure or network error is retried with backoff until the
+* deadline instead of being returned. Null when the deadline passes.
+*/
+function readApiBeforeDeadline(deadline, read) {
+	return retryTransient(() => readBeforeDeadline(deadline, read), { deadline });
+}
 function address(value) {
 	return value.trim().toLowerCase();
 }
@@ -89,4 +97,4 @@ function isPlainChatReply(detail) {
 	}).classification === "plain";
 }
 //#endregion
-export { scopedChatSenderTrust as a, readBeforeDeadline as i, isPlainChatReply as n, presenceDisposition as o, isScopedChatReply as r, readPresenceProjection as s, isConnectedChatCredential as t };
+export { readBeforeDeadline as a, readPresenceProjection as c, readApiBeforeDeadline as i, isPlainChatReply as n, scopedChatSenderTrust as o, isScopedChatReply as r, presenceDisposition as s, isConnectedChatCredential as t };

package/dist/{shared-mail-files-MwlVE90c.js → shared-mail-files-CZfm7E2k.js}

@@ -125,6 +125,26 @@ function removeOwner(path, owner) {
 		].includes(error.code ?? "")) throw error;
 	}
 }
+/**
+* True while a live process holds the lock {@link acquireListenLock} takes
+* for this directory and scope. Read-only; a lock whose owner exited, or
+* whose owner record cannot be read, counts as free.
+*/
+function listenLockHeld(directory, scope) {
+	const key = createHash("sha256").update(scope).digest("hex");
+	const path = join(directory, `${key}.lock`);
+	try {
+		const entries = readdirSync(path);
+		const match = entries.length === 1 ? /^(\d+)-[a-f0-9-]{36}$/.exec(entries[0] ?? "") : null;
+		if (!match) return false;
+		const pid = Number(match[1]);
+		if (!processAlive(pid)) return false;
+		const saved = ownerIdentity(join(path, entries[0] ?? ""));
+		return compareListenProcessIdentity(saved, saved === null ? null : listenProcessIdentity(pid)) !== false;
+	} catch {
+		return false;
+	}
+}
 function acquireListenLock(directory, scope) {
 	privateDirectory(directory);
 	const key = createHash("sha256").update(scope).digest("hex");
@@ -352,4 +372,4 @@ function mailTime(value) {
 	return new Date(time).toISOString();
 }
 //#endregion
-export { resolveListenSubscription as S, acquireListenLock as _, mailLockBusy as a, listenProcessIdentity as b, mailTime as c, readMailJson as d, removeMailFile as f, ListenStateError as g, writeMailJson as h, mailId as i, privateMailDirectory as l, withMailLock as m, invalidSharedMail as n, mailObject as o, syncMailDirectory as p, mailAddress as r, mailString as s, SharedMailStateError as t, privateMailPermissions as u, compareListenProcessIdentity as v, normalizeListenOrigin as x, listenIdentity as y };
+export { resolveListenSubscription as C, normalizeListenOrigin as S, acquireListenLock as _, mailLockBusy as a, listenLockHeld as b, mailTime as c, readMailJson as d, removeMailFile as f, ListenStateError as g, writeMailJson as h, mailId as i, privateMailDirectory as l, withMailLock as m, invalidSharedMail as n, mailObject as o, syncMailDirectory as p, mailAddress as r, mailString as s, SharedMailStateError as t, privateMailPermissions as u, compareListenProcessIdentity as v, listenProcessIdentity as x, listenIdentity as y };

package/dist/{shared-mail-watch-DtKpsgg8.js → shared-mail-watch-DyQB0MK0.js}

@@ -1,4 +1,4 @@
-import { _ as acquireListenLock, a as mailLockBusy, b as listenProcessIdentity, c as mailTime, d as readMailJson, f as removeMailFile, h as writeMailJson, i as mailId, n as invalidSharedMail, o as mailObject, s as mailString, v as compareListenProcessIdentity } from "./shared-mail-files-MwlVE90c.js";
+import { _ as acquireListenLock, a as mailLockBusy, c as mailTime, d as readMailJson, f as removeMailFile, h as writeMailJson, i as mailId, n as invalidSharedMail, o as mailObject, s as mailString, v as compareListenProcessIdentity, x as listenProcessIdentity } from "./shared-mail-files-CZfm7E2k.js";
 import { watch } from "node:fs";
 import { randomUUID } from "node:crypto";
 import { join } from "node:path";

package/dist/{signal-command-DeEEZPbQ.js → signal-command-Cte4mAL3.js}

@@ -1,8 +1,8 @@
-import { h as sendPreparedSignal, p as prepareSignalEmail } from "./repeats-BL7ZC-_6-CKMKBlx7.js";
-import { D as bareAddress, St as successfulSendOutcome, er as listSentEmails, kn as getEmail, o as extractErrorPayload, ot as classifySendError, sn as createEndpoint, vr as sendEmail } from "./api-command-BrwPbyPP.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-DTFkP360.js";
-import { n as tryOwnSharedMail, r as waitForSharedMailChange, t as readSharedMailOwner } from "./shared-mail-watch-DtKpsgg8.js";
+import { Dn as sendEmail, Ft as getEmail, _ as describeApiFailure, cn as listSentEmails, h as sendPreparedSignal, p as prepareSignalEmail, pt as createEndpoint } from "./repeats-BL7ZC-_6-B_ESsWTH.js";
+import { _ as acquireListenLock, 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, x as listenProcessIdentity, y as listenIdentity } from "./shared-mail-files-CZfm7E2k.js";
+import { Y as classifySendError, dt as successfulSendOutcome, h as bareAddress, o as extractErrorPayload } from "./api-command-fKP3NYa7.js";
+import { i as readApiBeforeDeadline, n as isPlainChatReply, o as scopedChatSenderTrust } from "./scoped-chat-DAiOb622.js";
+import { n as tryOwnSharedMail, r as waitForSharedMailChange, t as readSharedMailOwner } from "./shared-mail-watch-DyQB0MK0.js";
 import { recordSentSignal } from "./oclif/auto-signals.js";
 import { Errors } from "@oclif/core";
 import { opendirSync } from "node:fs";
@@ -2087,7 +2087,7 @@ async function openSharedMailReceiver(options) {
 //#region src/oclif/reconcile-chat-send.ts
 /** Lookup only. An empty result never authorizes another send. */
 async function reconcileChatSend(params) {
-	const result = await readBeforeDeadline(params.deadline, (signal) => listSentEmails({
+	const result = await readApiBeforeDeadline(params.deadline, (signal) => listSentEmails({
 		client: params.apiClient.client,
 		query: {
 			idempotency_key: params.idempotencyKey,
@@ -2097,8 +2097,9 @@ async function reconcileChatSend(params) {
 		responseStyle: "fields"
 	}));
 	if (result === null) return null;
+	if (result.error) throw new Errors.CLIError(`Could not reconcile the saved send intent: ${describeApiFailure(result)}. Its outcome remains unknown; do not send again.`, { exit: 1 });
 	const page = result.data;
-	if (result.error || !page || !Array.isArray(page.data) || !page.meta || page.meta.cursor !== null || page.data.length > 1) throw new Errors.CLIError("Could not reconcile the saved send intent. Its outcome remains unknown; do not send again.", { exit: 1 });
+	if (!page || !Array.isArray(page.data) || !page.meta || page.meta.cursor !== null || page.data.length > 1) throw new Errors.CLIError("Could not reconcile the saved send intent. Its outcome remains unknown; do not send again.", { exit: 1 });
 	const sent = page.data[0];
 	if (!sent) return null;
 	if (sent.client_idempotency_key !== params.idempotencyKey || typeof sent.from_address !== "string" || sent.from_address.trim().toLowerCase() !== params.from.trim().toLowerCase() || typeof sent.to_address !== "string" || sent.to_address.trim().toLowerCase() !== params.recipient.trim().toLowerCase() || typeof sent.id !== "string" || !sent.id) throw new Errors.CLIError("The saved send lookup returned conflicting identity metadata. Inspect the existing send before retrying.", { exit: 1 });

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

@@ -214,8 +214,9 @@ and sends nothing; a read that started Working ends with that exact command.
 A reply stops Working for the email it answers and for the sender's other
 mail in that thread, not for the sender's mail in other threads. Do not send Read or Working
 yourself then; still send Typing just before composing. Only an older CLI,
-whose `primitive signal --help` does not mention automatic signals, needs the
-manual Working signal above. Either way the CLI
+whose full signal help does not mention automatic signals, needs the manual
+Working signal above. Read the full help with `primitive signal --help-full`,
+or `primitive signal --help` when the CLI rejects `--help-full`. Either way the CLI
 rejects signal/interaction parents to avoid loops. Do not hand-renew Working in
 a loop through long work; the work claim under
 [Collaborate with other agents](collaboration.md) covers that. Send Typing only while composing and stop on reply, failure or waiting.

package/dist/skills/primitive-connect/references/native-session.md

@@ -8,8 +8,10 @@ listener while that hook is installed or after it has delivered real mail. Do
 not use this native status to diagnose Claude's hook, start a competing listener,
 or repeat a claim. See the [Claude guidance](presence-and-receiving.md#claude-code-external-receiver).
 
-Use this reference only when installed `primitive listen --help` describes
+Use this reference only when the installed CLI's full listen help describes
 "external mail events at tool-output authority" and no synthetic user messages.
+Read it with `primitive listen --help-full`, or `primitive listen --help` when
+the CLI rejects `--help-full`; short `--help` leaves out these descriptions.
 The same `--notify-session` command supplies these events; no extra mode flag or
 plugin is required. Those events carry mail-arrival metadata with tool-output
 trust, like a background task completion.
@@ -86,7 +88,7 @@ does not prove Primitive attached; check the listener health below.
 Once that exact session is loaded, use the profile already verified as belonging
 to this connection and saved in this session's context. Replace the example name;
 do not adopt a generic existing profile based only on configured status. Use the
-already inspected `primitive listen --help` to choose the installed capability.
+already inspected full listen help to choose the installed capability.
 Only when it documents external-event delivery and `--background`, let the CLI
 supervise the receiver:
 

package/dist/skills/primitive-connect/scripts/check-cli-capabilities.mjs

@@ -9,16 +9,16 @@ if (receiver !== 'native' && receiver !== 'external' && receiver !== 'poll') {
   process.exitCode = 2;
 } else {
   const checks = [
-    { args: ['agent', 'connect', '--help'], label: 'agent connect', patterns: [/--session\b/, /--receiver\b/] },
-    { args: ['agent', 'enroll', '--help'], label: 'agent enroll', patterns: [/--session\b/, /--receiver\b/, /--name\b/] },
-    { args: ['listen', '--help'], label: 'listen', patterns: [/external mail events at tool-output authority/i, /never synthetic user messages/i] },
-    { args: ['network', 'peers', '--help'], label: 'network peers', patterns: [/discover listed peers/i, /--owner\b/] },
+    { command: ['agent', 'connect'], label: 'agent connect', patterns: [/--session\b/, /--receiver\b/] },
+    { command: ['agent', 'enroll'], label: 'agent enroll', patterns: [/--session\b/, /--receiver\b/, /--name\b/] },
+    { command: ['listen'], label: 'listen', patterns: [/external mail events at tool-output authority/i, /never synthetic user messages/i] },
+    { command: ['network', 'peers'], label: 'network peers', patterns: [/discover listed peers/i, /--owner\b/] },
   ];
   if (receiver === 'poll') {
     // Nothing is installed and no listener runs: the agent checks for mail.
     checks[0].patterns.push(/poll installs nothing/i);
     checks[1].patterns.push(/\bpoll\b/);
-    checks[2] = { args: ['agent', 'check-mail', '--help'], label: 'agent check-mail', patterns: [/since its previous check/i] };
+    checks[2] = { command: ['agent', 'check-mail'], label: 'agent check-mail', patterns: [/since its previous check/i] };
   } else if (receiver === 'external') {
     checks[0].patterns.push(/installs the exact Claude session's fail-open Stop hook/i, /resume SessionStart hook/i);
     checks[1].patterns.push(/exact Claude session, install a fail-open Stop hook/i, /resume SessionStart hook/i);
@@ -27,7 +27,7 @@ if (receiver !== 'native' && receiver !== 'external' && receiver !== 'poll') {
     checks[2].patterns.push(/--notify-session\b/, /--background\b/);
   }
 
-  const helpText = (args) => {
+  const run = (args) => {
     const result = spawnSync('primitive', args, {
       encoding: 'utf8',
       timeout: 10_000,
@@ -35,16 +35,19 @@ if (receiver !== 'native' && receiver !== 'external' && receiver !== 'poll') {
     });
     return result.error || result.status !== 0 ? null : result.stdout.replace(/\s+/g, ' ');
   };
+  // Newer CLIs keep --help short and print the full text, which these patterns
+  // match, on --help-full. Older CLIs reject --help-full and print it on --help.
+  const helpText = (command) => run([...command, '--help-full']) ?? run([...command, '--help']);
 
   const missing = [];
-  for (const { args, label, patterns } of checks) {
-    const help = helpText(args);
+  for (const { command, label, patterns } of checks) {
+    const help = helpText(command);
     if (help === null) {
-      missing.push(`${label} --help is unavailable`);
+      missing.push(`${label} help is unavailable`);
       continue;
     }
     if (patterns.some((pattern) => !pattern.test(help))) {
-      missing.push(`${label} --help lacks required setup, ${receiver} receiving, or peer-discovery support`);
+      missing.push(`${label} help lacks required setup, ${receiver} receiving, or peer-discovery support`);
     }
   }
 
@@ -54,7 +57,7 @@ if (receiver !== 'native' && receiver !== 'external' && receiver !== 'poll') {
   } else {
     process.stdout.write(`Primitive CLI preflight passed for ${receiver} receiving and peer discovery.\n`);
     // Advisory only: older CLIs without `primitive wait` still connect and work.
-    const wait = helpText(['wait', '--help']);
+    const wait = helpText(['wait']);
     process.stdout.write(wait !== null && /--code\b/.test(wait) && /--link\b/.test(wait)
       ? 'primitive wait: available (--code, --link).\n'
       : 'primitive wait: not in this CLI; run `primitive agent check-mail` every few seconds until the email is listed, then read it with `primitive emails get --id <id> --context`.\n');

package/dist/skills/primitive-connect.json

@@ -1,10 +1,10 @@
 {
   "name": "primitive-connect",
-  "version": "9b2fce59986cef45",
+  "version": "38229bc689e6b37b",
   "source": {
     "repository": "https://github.com/primitivedotdev/skills",
     "path": "skills/primitive-connect",
-    "commit": "3c62147a74119a9570aa8526c2c591c47830f6fc"
+    "commit": "a737d72b70ad813a5539a3f492546da52998ec0e"
   },
   "files": {
     "SKILL.md": "37d40b66010319c6a176bc8eb66affd93cab0968c609ad523dac087d3077d29d",
@@ -15,13 +15,13 @@
     "references/connect.md": "dc39fb8bbaffa69e30a3895f195beb12cfc95c991140ab5a7adb6e1e3293272a",
     "references/contact-requests.md": "a6afb51ec2cd0bf807095e034942c6e81c82c8b8489a3e2464cd8ce9f4c28d43",
     "references/contacts.md": "11af5638bd4799f10bfa6fdc1c1cebf90db7c8a43d4ed5498b96c14779f1a482",
-    "references/conversations.md": "2d4ffed35e4d2402f2becb567f76aa01834b24e873f1d6074a3159a276f96cf8",
+    "references/conversations.md": "c8a1125db76e40e8bf2e550223e4d4e1a86536ca43ccdd835024f6d6502098a7",
     "references/external-services.md": "211e03cec546d2f83c78bd38985cc64203272df47eb52cf1bdce885bceee3089",
     "references/manual-setup.md": "433f111c425cb976d153e22c851064e2e730f45229d8747ec91827f3a76b5d0e",
-    "references/native-session.md": "29986cc84a7cf57fe82f51e70ad3b4971a2a4d3dcf4b7b64e492e71bd58afaeb",
+    "references/native-session.md": "badc915ef658a8ef0ca1c6b0d5c4292f3668068754f26dc63eff99e63ac0d7f8",
     "references/presence-and-receiving.md": "449e1c3c2339c4ad0f08151f2323f3982962e1037c97b24531983567a255b702",
     "references/private-api-fallback.md": "05e5fc968c080fed2479ad380a3ccc55a897eda9a723650905fcdd9be9cc241b",
-    "scripts/check-cli-capabilities.mjs": "593b726fdb53d95a658b5740cfb000f25ed38509f7666d99c9e1e5652d34cb0a",
+    "scripts/check-cli-capabilities.mjs": "82a30f44a5af119d3f681257d58aa85bd4ed67fac97da508fd2d15ebc2ddb4d3",
     "scripts/connection.mjs": "2c96eda1e9a277a241555f98dd858523b8f77a9ddd82d52a6ac34e844206c3d6",
     "scripts/mail.mjs": "bfdfb60a739f1537d0e676dc5ff44fd5a65dba4303e3781dce8754c8d671cf51"
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "primcli",
-  "version": "1.72.2",
+  "version": "1.74.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,