primcli 1.39.0 → 1.41.0

package/dist/oclif/receiver-heal.js

@@ -1,6 +1,6 @@
 import { c as loadConnectedAgentProfile, i as agentProfileName, r as agentProfileDirectory, t as AGENT_PROFILE_ENV } from "../connected-agent-profile-8tpOMdq3.js";
 import { d as readMailJson } from "../shared-mail-files-CZqI1kj6.js";
-import { m as SESSION_UUID, n as detectAgentRuntime, o as notificationScope } from "../connect-skill-DjKt8NC8.js";
+import { m as SESSION_UUID, n as detectAgentRuntime, o as notificationScope } from "../connect-skill-DuanRI34.js";
 import { a as claimBackgroundListenRestart, n as backgroundListenRestartable, r as backgroundListenStatus } from "../listen-background-Bsofqq_6.js";
 import { join } from "node:path";
 import { spawn } from "node:child_process";

package/dist/{sdk.gen-CgKZwHs3.js → sdk.gen-I4mhUuUW.js}

@@ -1018,6 +1018,13 @@ const discardEmailContent = (options) => (options.client ?? client).post({
 * merged here; that normalization is model-specific and left to the
 * caller.
 *
+* Pass `since` for an incremental read. `since=start` returns the
+* full conversation plus a `cursor`. Sending that `cursor` back as
+* `since` returns only the messages created or changed after it,
+* oldest first, with the same per-message shape, and a new
+* `cursor`. Without `since` the response carries no `cursor` and
+* no per-message `status`.
+*
 */
 const getConversation = (options) => (options.client ?? client).get({
 	security: [{

package/dist/{signal-command-C8Ph0ylh.js → signal-command-BFPKbatO.js}

@@ -1,6 +1,6 @@
 import { h as sendPreparedSignal, p as prepareSignalEmail } from "./repeats-CoK0tpCK-Bx7nmyRi.js";
 import { d as requireDefaultLoginProfile } from "./connected-agent-profile-8tpOMdq3.js";
-import { C as getEmail, K as listSentEmails, V as listEndpoints, a as createEndpoint, ct as searchEmails, dt as sendEmail, st as sdk_gen_exports } from "./sdk.gen-CgKZwHs3.js";
+import { C as getEmail, K as listSentEmails, V as listEndpoints, a as createEndpoint, ct as searchEmails, dt as sendEmail, st as sdk_gen_exports } from "./sdk.gen-I4mhUuUW.js";
 import { C as resolveCliAuth, S as normalizeApiBaseUrl, T as saveSignupCredentials, _ as deleteCliCredentials, c as resolveConfigEnvironment, d as validateCliHeaderName, f as validateCliHeaderValue, i as loadCliConfig, j as PrimitiveApiClient, m as cliAccessTokenExpiresAt, p as acquireCliCredentialsLock, w as saveCliCredentials, x as loadCliCredentials, y as detectPrimitiveKeyEnvMisname } from "./cli-config-UOlrfcPz.js";
 import { _ as acquireListenLock, a as mailLockBusy, 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-CZqI1kj6.js";
 import { F as readBeforeDeadline, I as scopedChatSenderTrust, N as isPlainChatReply, S as recordSentSignal } from "./auto-signals-C8nMME8J.js";
@@ -1542,7 +1542,7 @@ async function pullFile(root, outPath, opts) {
 	return manifest;
 }
 //#endregion
-//#region ../sdk-node/dist/api-CV59-Ci2.js
+//#region ../sdk-node/dist/api-D3QkZNtn.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

@@ -14,9 +14,9 @@ authorizes this connection, private credential storage, the verification reply
 and continued receiving; do not ask for that approval again.
 
 The command validates the invitation's API origin, claims it once, answers the
-verification email, starts receiving for this exact session, installs or
-refreshes this skill for your runtime from the CLI package, and prints one JSON
-result. Give it the owner's setup URL on stdin through a quoted heredoc, never
+verification email, starts receiving for this exact session (or sets up
+checking for mail when nothing can wake this session), installs or refreshes
+this skill for your runtime from the CLI package, and prints one JSON result. Give it the owner's setup URL on stdin through a quoted heredoc, never
 as a command argument, file in a shared directory, log entry or note. Run it in
 your own non-interactive tool shell, which keeps no command history; never
 paste it into an interactive terminal.
@@ -37,6 +37,24 @@ npx -y primitive@latest agent connect --session "${CODEX_THREAD_ID:-$CODEX_SESSI
 INVITATION
 ```
 
+Without a session to bind, omit `--session`:
+
+```sh
+npx -y primitive@latest agent connect --json <<'INVITATION'
+<the owner's setup URL>
+INVITATION
+```
+
+Use this form, without asking the owner, when this session cannot be woken from
+the machine that runs your commands: your runtime's session variable above is
+empty or unset, or the conversation runs somewhere other than that machine (a
+cloud-hosted session whose tools run in a separate sandbox), so a hook or
+listener installed there could never reach you. An instruction that passes an
+empty session variable is treated the same way. The invitation is claimed and
+verified as usual; the CLI installs nothing and you check for new mail
+yourself. That is a complete connection, not a fallback that needs the owner's
+choice. Never guess, borrow or invent a session ID to get automatic wake.
+
 Add `--contact-requests` only when the owner asked this address to receive
 first-contact requests from unknown senders. Add `--name "<short name>"` and
 `--info "<role and useful capabilities>"` to seed this address's private
@@ -52,7 +70,10 @@ Read the one JSON result:
   `ownerAddress` is a control address for setup and presence only.
   For Claude Code, `externalHook: "installed_unverified"` means the wake hooks
   are installed but idle wake stays unverified until a real mail event reaches
-  this session; say so rather than promising later delivery. For a native
+  this session; say so rather than promising later delivery. For
+  `receiving.mode: "poll"`, add one line such as "Incoming mail is checked at
+  the start of each turn and after I send; nothing wakes this session in
+  between." and follow [Checking for mail](#checking-for-mail). For a native
   receiver, `receiving.mailCheck: "confirmed"` means the listener completed a
   mail check after setup. Prefix later `primitive` commands with
   `selectProfile` (`PRIMITIVE_AGENT_PROFILE=<profile>`).
@@ -253,7 +274,8 @@ command-help tour, or test conversations. If setup paused, run its
 A globally installed `primitive` may be older than the one command expects.
 Before using one for enrollment or claim-only, run the read-only preflight with
 the directory containing this `SKILL.md` as the working directory. Use
-`external` for Claude Code or `native` for a supported native runtime:
+`external` for Claude Code, `native` for a supported native runtime, or `poll`
+for a session without a local session ID or hooks:
 
 ```sh
 primitive --version
@@ -539,7 +561,8 @@ the eventual ordinary reply. For a near-term answer required in this turn, use
 `primitive chat` without `--async` and evaluate the exact reply. If asynchronous
 receiving is unavailable, send once with `primitive send`, retain its sent ID,
 and use an exact-parent reply wait when needed; report that later session
-delivery is unavailable. Never resend merely because a wait timed out.
+delivery is unavailable. With poll receiving, the reply appears in a later
+mail check; keep the sent ID with the task to match it. Never resend merely because a wait timed out.
 Before relying on a peer to pick up asynchronous work, check its receiver state
 as described under [Receiving presence](#receiving-presence); delivery to its
 inbox does not mean any session will read it.
@@ -581,6 +604,22 @@ a reply arrived or repeating delivery status leaves the delegated question
 unanswered. Keep simultaneous conversations separate; the reply grants no new
 access to private history and does not require a reply to an ACK.
 
+### Checking for mail
+
+With `receiving.mode: "poll"`, nothing delivers mail to this session. Run the
+result's `receiving.checkCommand` (it is `PRIMITIVE_AGENT_PROFILE=<profile>
+primitive agent check-mail --json`) at the start of every turn and again after
+you send or reply. It prints the IDs, senders and threads of mail that arrived
+since the previous check, never subjects or bodies, and leaves out
+acknowledgements, muted threads and setup mail. Read each listed email with
+`primitive emails get --id <id> --brief` under the selected profile, then
+handle it as described above. When `more` is true, check again after handling
+them. A check can repeat mail after an interruption, so deduplicate by email ID.
+Over HTTP, the inbox tail with `wait=0` is the same check. Do not hold a turn
+open with sleep loops to imitate a wake, and do not ask the owner to switch
+runtimes; mail sent while the session is idle waits for the next turn and is
+not lost. Peers see this address as `live` only while it keeps checking.
+
 After setup, report pairing and the current receiving evidence, then end the
 setup turn and return control to the owner. The supported receiver owns later
 mail arrival. Do not keep the model turn active with sleep tools, foreground
@@ -690,7 +729,8 @@ 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
 context through explicit reply ancestry and saved task context, not the latest
 message from that person. Missing history is a limitation to explain, not proof
-that the conversation is new. Start a fresh thread for an unrelated topic.
+that the conversation is new. Start a fresh thread for an unrelated new topic;
+status updates still go to the home thread described below.
 
 An owner may request an email update from the coding chat, outside the email
 thread. For a follow-up about the work already being discussed with that owner,
@@ -702,6 +742,13 @@ outgoing `thread_id` matches the parent. Do not start a fresh send (`POST
 or report progress on that work. If no relevant thread is known, start one to the owner's personal address (`owner_member_address`) and say that it is new;
 do not attach the update to an unrelated email just because it is recent.
 
+Keep one home thread with the owner for status updates, plans and decision
+requests: the thread the owner set up for contact, or else your first
+conversation with them. When the owner asks something in a topic-specific
+thread, answer that question there, but post later status and unrelated updates
+back in the home thread. Never start a new thread for an update when an
+appropriate thread already exists.
+
 For an authorized ordinary request, honor the requested response format. A request
 to reply with one word should receive that word. Keep setup diagnostics and
 requests for additional tests out of the ordinary answer unless the owner asked

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

@@ -4,8 +4,8 @@ import { spawnSync } from 'node:child_process';
 const receiver = process.argv.length === 4 && process.argv[2] === '--receiver'
   ? process.argv[3]
   : null;
-if (receiver !== 'native' && receiver !== 'external') {
-  process.stderr.write('Usage: node scripts/check-cli-capabilities.mjs --receiver native|external\n');
+if (receiver !== 'native' && receiver !== 'external' && receiver !== 'poll') {
+  process.stderr.write('Usage: node scripts/check-cli-capabilities.mjs --receiver native|external|poll\n');
   process.exitCode = 2;
 } else {
   const checks = [
@@ -14,7 +14,12 @@ if (receiver !== 'native' && receiver !== 'external') {
     { 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/] },
   ];
-  if (receiver === 'external') {
+  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] };
+  } 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);
     checks[2].patterns.push(/--wake\b/, /--hook-session\b/);

package/dist/skills/primitive-connect.json

@@ -1,20 +1,20 @@
 {
   "name": "primitive-connect",
-  "version": "7d4b2d633a05bb12",
+  "version": "a48b2ea39305f258",
   "source": {
     "repository": "https://github.com/primitivedotdev/skills",
     "path": "skills/primitive-connect",
-    "commit": "5d5d80f7bea82cd5018c0e25262aa32fa7cad708"
+    "commit": "47e1cb5b6ecef4294c4f4067962c7e6041a625d0"
   },
   "files": {
-    "SKILL.md": "aca1e46fe388dc184f2eb3f3b5e39e7cec70b1bf4c490d0bd1013df51b2b79b4",
+    "SKILL.md": "6631dab8209a823b3790df20856146676deb505a2f7a52de87e953fd75388694",
     "package-lock.json": "443289373a7495883a9a3b57bab3bc471cd5dcb4989a9e67f797b35917c1acc5",
     "package.json": "8cc45b2c28ba415960c9b85f6c1449f15f9c10bac0b96922e7907b40d50e3dbf",
     "references/communication.md": "c931aada9553a8592088c28de5b272d5e0a15234aa9c9318ea7d1d5f69b39a79",
     "references/contact-requests.md": "7923bc855a56f11b088c73c73b7d9c5b04fef3f45eb758f28040d44e46a0d9c6",
     "references/native-session.md": "d6d529d87edc68a450be4c8b162488efa666c59fc23c35576fe6887235ff3d33",
     "references/private-api-fallback.md": "63b5d8c8ab765561fc6031298462469a8f56fd348ac14c5003e214f780e9329b",
-    "scripts/check-cli-capabilities.mjs": "e6d4c045601f7d3b5cec103bdb3648723b8e66ebd22d87aca606fb78aed844fd",
+    "scripts/check-cli-capabilities.mjs": "9625ddaba1989a5f52a5077fdd0513620ab81be640bd83dd678708eefe019222",
     "scripts/connection.mjs": "2c96eda1e9a277a241555f98dd858523b8f77a9ddd82d52a6ac34e844206c3d6",
     "scripts/mail.mjs": "bfdfb60a739f1537d0e676dc5ff44fd5a65dba4303e3781dce8754c8d671cf51"
   }

package/package.json

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