primcli 1.73.0 → 1.74.0

package/dist/oclif/index.js

@@ -49109,7 +49109,7 @@ const PRIMITIVE_TEAM_AUTHOR = {
 	url: "https://primitive.dev"
 };
 const SDK_VERSION_RANGE = "^2.0.0";
-const CLI_VERSION_RANGE = "^1.73.0";
+const CLI_VERSION_RANGE = "^1.74.0";
 const ESBUILD_VERSION_RANGE = "^0.27.0";
 function renderHandler() {
 	return `// env.PRIMITIVE_API_KEY, env.PRIMITIVE_WEBHOOK_SECRET, and
@@ -52286,6 +52286,15 @@ function openContactRequestNotices(configDir, identity) {
 }
 //#endregion
 //#region src/oclif/conversation-status.ts
+/**
+* An acknowledgement (an `ack` signal, which `primitive reply --fyi` sends)
+* exists so its receiver does not have to act. It never wakes or notifies a
+* session: the event is completed and the message stays readable in its
+* thread. Read, working and typing still reach the session as status.
+*/
+function isQuietConversationStatus(status) {
+	return status.kind === "ack";
+}
 /** A References-derived parent ID cannot prove which Message-ID a signal names. */
 async function readBoundSentMessageId(apiClient, wait, signal) {
 	if (!wait.sentEmailId) return null;
@@ -53019,12 +53028,12 @@ async function runSharedNotificationListen(options) {
 				await store.skipNotification(row.emailId, sessionKey);
 				return true;
 			}
-			if (status && !await conversationStatusDue({
+			if (status && (isQuietConversationStatus(status) || !await conversationStatusDue({
 				configDir: options.configDir,
 				scope,
 				recipient,
 				sessionKey
-			}, status)) {
+			}, status))) {
 				await store.skipNotification(row.emailId, sessionKey);
 				return true;
 			}
@@ -53705,6 +53714,7 @@ async function createWakeMail(options) {
 			const sentMessageId = requested && statusContent ? await readBoundSentMessageId(apiClient, requested, signal) : null;
 			if (statusContent && !sentMessageId) return outcome(false);
 			const status = requested ? boundConversationStatus(detail, statusContent, requested, sentMessageId, options.sessionKey) : null;
+			if (status && isQuietConversationStatus(status)) return outcome(true);
 			let admission;
 			let admissionRetry;
 			try {

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.73.0",
+  "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,