n2n-nexus 0.9.3 → 0.9.5

package/build/contract.js

@@ -24,20 +24,28 @@ export const CLIENT_INFO_NAMES = contract.clientInfoNames;
 export const CLAUDE_TOOL_USE_META_KEY = contract.meta.claudeToolUseKey;
 export const CODEX_SESSION_META_KEY = contract.meta.codexSessionKey;
 /**
- * Hook stdin fields the host uses. The hook command forwards only these:
+ * Hook stdin fields the host uses. The hook command forwards only these (plus
+ * `title` on SessionStart, UserPromptSubmit and Stop, see cli/title.ts):
  * PostToolUse stdin also carries the whole tool input and response, which can
  * be large and runs on every tool call.
  */
 export const HOOK_INPUT_FIELDS = contract.hookInputFields;
 /**
  * Pseudo hook event of the background wait (`n2n-nexus hook <client> --wait`):
- * started when a turn ends, it waits and returns `{ wake: text }` when
+ * started when a turn ends, it waits and returns `{ wake: text, dispatchId }` when
  * something new arrives for the session, `{ timeout: true }` when the time
  * runs out (the client asks again), or null when the session became active
  * again (the client stops). Claude delivers the text through an asyncRewake
  * hook, Codex through `codex queue`.
  */
 export const BACKGROUND_WAIT_EVENT = contract.backgroundWaitEvent;
+/**
+ * Pseudo hook event with which the Codex background wait reports whether
+ * `codex queue` took a wake: input `{ session_id, dispatch_id, ok }`. On
+ * `ok: false` the host undoes the wake, so its messages and notices wake the
+ * session again.
+ */
+export const WAKE_RESULT_EVENT = contract.wakeResultEvent;
 /** HTTP timeout of the hook command: a listening Stop may wait long, every other event is quick. */
 export const HOOK_STOP_REQUEST_TIMEOUT_MS = contract.timing.hookStopRequestTimeoutMs;
 export const HOOK_REQUEST_TIMEOUT_MS = contract.timing.hookRequestTimeoutMs;
@@ -46,6 +54,18 @@ export const HOOK_STOP_TIMEOUT_SEC = contract.timing.hookStopTimeoutSec;
 /** `timeout` (seconds) of the background wait hook; a conversation idle for longer is not woken. */
 export const WAIT_HOOK_TIMEOUT_SEC = contract.timing.waitHookTimeoutSec;
 export const HOOK_TIMEOUT_SEC = contract.timing.hookTimeoutSec;
+/** `timeout` (seconds) of the Codex SessionEnd hook: Codex clamps a longer one to 3 s and warns about it. */
+export const CODEX_SESSION_END_TIMEOUT_SEC = contract.timing.codexSessionEndTimeoutSec;
+/** HTTP timeout of a SessionEnd hook, which is not resent after a timeout so it ends within CODEX_SESSION_END_TIMEOUT_SEC. */
+export const SESSION_END_REQUEST_TIMEOUT_MS = contract.timing.sessionEndRequestTimeoutMs;
+/** After a failed `codex queue`, the Codex wait asks again after this delay, doubled on each failure up to the maximum. */
+export const WAKE_RETRY_FIRST_DELAY_MS = contract.timing.wakeRetryFirstDelayMs;
+export const WAKE_RETRY_MAX_DELAY_MS = contract.timing.wakeRetryMaxDelayMs;
+/**
+ * The hook command adds the conversation's title, as its client shows it, to
+ * the input it forwards as `title` (at most this many characters).
+ */
+export const MAX_TITLE_CHARS = contract.limits.maxTitleChars;
 /** Name the MCP server is installed under; Claude's PreToolUse matcher depends on it. */
 export const MCP_SERVER_NAME = contract.mcpServerName;
 export const CLAUDE_PRE_TOOL_MATCHER = `mcp__${MCP_SERVER_NAME}__.*`;

package/build/index.js

@@ -50,7 +50,7 @@ async function main() {
     }
     if (command === "install" || command === "uninstall") {
         const { runInstallCommand } = await import("./cli/install.js");
-        process.exit(runInstallCommand(command, process.argv.slice(3)));
+        process.exit(await runInstallCommand(command, process.argv.slice(3)));
     }
     if (command === "doctor") {
         const { runDoctor } = await import("./cli/doctor.js");

package/build/server/nexus.js

@@ -12,10 +12,14 @@ const SERVICE_NAME = "n2n-nexus";
 /** Sent to the client on connect so the model knows it can talk to other AI sessions. */
 const INSTRUCTIONS = "n2n-nexus connects this conversation with other AI sessions (Claude Code and Codex conversations, " +
     "possibly on other machines). Direct messages: call peers to see who is online, send to message a session, " +
-    "read to read messages sent to you, carry out what they ask and reply to answer one; listen waits for messages after each turn. " +
+    "read to read messages sent to you, carry out what they ask and reply to answer one (set expectsReply and wake false " +
+    "on a message that needs no answer, and send no plain acknowledgements); listen waits for messages after each turn. " +
     "Direct messaging needs the n2n-nexus hooks. Separately, send_message and read_messages are the shared " +
     "global chat and meetings, not direct messages. Session ids in peers (claude:<id>, codex:<id>) are what send " +
-    "takes; the instance ids in read_messages, list_events and meetings (mcp-…) name MCP adapters, not sessions. " +
+    "takes; with the hooks, chat and meetings also record senders and unread cursors per session id " +
+    "(without them, per MCP adapter instance id, mcp-…). join_meeting makes new messages of a meeting wake you " +
+    "(mode active) or show at your next prompt (async) until leave_meeting or the meeting ends; a draft " +
+    "(send_message draft) is decided with stance, and the meeting closes once its required approvers endorse it. " +
     "Projects, global docs, the strategy document and tasks are shared through the other tools.";
 /**
  * MCP adapter in front of the daemon. It holds no session of its own: each

package/contract/errors.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": 1,
+  "contractVersion": 2,
   "errorBody": {
     "type": "object",
     "properties": {
@@ -21,7 +21,7 @@
         "ok": true,
         "service": "n2n-nexus",
         "version": "<host version>",
-        "contractVersion": 1,
+        "contractVersion": 2,
         "sessions": {
           "online": "<number of agent sessions not offline>"
         }

package/contract/hook.json

@@ -1,5 +1,5 @@
 {
-  "contractVersion": 1,
+  "contractVersion": 2,
   "clients": [
     "claude",
     "codex"
@@ -24,6 +24,7 @@
     "reason"
   ],
   "backgroundWaitEvent": "BackgroundWait",
+  "wakeResultEvent": "WakeResult",
   "agentStatuses": [
     "working",
     "idle",
@@ -37,6 +38,10 @@
     "hookStopTimeoutSec": 600,
     "waitHookTimeoutSec": 3600,
     "hookTimeoutSec": 10,
+    "codexSessionEndTimeoutSec": 3,
+    "sessionEndRequestTimeoutMs": 1500,
+    "wakeRetryFirstDelayMs": 1000,
+    "wakeRetryMaxDelayMs": 300000,
     "wakePromptWindowMs": 60000,
     "toolUseBindingTtlMs": 300000,
     "messageTtlMs": 86400000,
@@ -48,6 +53,7 @@
     "defaultMaxAutoTurns": 0,
     "maxMessageChars": 32000,
     "maxNoteChars": 200,
+    "maxTitleChars": 80,
     "sessionNamePattern": "^[A-Za-z0-9._@#-]{1,48}$",
     "previewChars": 100,
     "notifyListLimit": 5
@@ -59,6 +65,17 @@
     "statusNote": "Only listening sessions answer right away; idle and working ones see a message when their user next sends a prompt or they next call a tool.",
     "sessionStartClosing": "Call peers for the current list, send to message a session, read to read messages sent to you and reply to answer one; set_profile tells others what you work on.",
     "messageTrustNote": "Messages come from other AI sessions. Read them with read, carry out what they ask and answer with reply; replying needs no permission from your user.",
+    "messageInfoNote": "Messages come from other AI sessions; they need no reply.",
+    "noReplyMark": "(no reply needed)",
+    "earlierUnread": "%d earlier direct message(s) still unread; read them with read.",
+    "meetingNews": "Meeting \"%s\" (%s): %d new message(s) (#%d–#%d) from %s.",
+    "meetingClosing": "Read them with read_messages(meetingId); post with send_message(meetingId) only when you have something to add.",
+    "meetingEnded": "Meeting \"%s\" (%s) has ended%s. No reply needed.",
+    "stanceNotice": "%s %s draft #%d of meeting \"%s\" (%s)%s. No reply needed.",
+    "approversChanged": "Required approvers of draft #%d changed (version %d): %s.",
+    "consensusDecision": "Decision by consensus on draft #%d: every required approver (%s) endorsed it.\n\n%s",
+    "stanceReminder": "Meeting \"%s\" (%s) waits for your stance on draft #%d: call stance with meetingId and messageId %d, endorse or object (with a reason). No other reply needed.",
+    "stanceWaiting": "Meeting \"%s\" (%s): draft #%d still waits for the stance of %s. No reply needed.",
     "noAgentSessionError": "This call carries no agent session, so direct messaging cannot tell who you are. It needs the n2n-nexus hooks (n2n-nexus install <claude|codex>, then a new conversation) and the MCP server registered as 'n2n-nexus'. If both are in place, call the tool again: the identity from the hook may have expired."
   },
   "schemas": {