@platys/relay 0.8.0-alpha.13 → 0.8.0-alpha.14

package/README.md

@@ -29,7 +29,7 @@ npm install --global @platys/relay
 relay setup
 ```
 
-Version **0.8.0-alpha.13** connects ordinary Claude sessions using native hooks. Windows PowerShell users
+Version **0.8.0-alpha.14** fixes Claude delivery after extended idle time. Windows PowerShell users
 can use `npx.cmd`, `npm.cmd`, or `relay.cmd` if execution policy blocks the shims.
 
 ### Windows: no terminal needed
@@ -49,7 +49,7 @@ For the current integration without a special launcher, update using npm setup a
 
 1. **Claude Code:** open Claude normally and start or resume any conversation.
    Relay attaches through your user-level hooks. No special launcher or Relay
-   workspace selection is needed. This integration requires alpha.13 or newer.
+   workspace selection is needed. Use alpha.14 or newer for the idle-listener fix.
 2. **Codex:** reopen the app and review the Relay entries in `/hooks` once.
    Start or resume your task normally.
 3. Ask your agent:

package/next/EASY_SETUP.md

@@ -54,10 +54,11 @@ retains its own runtime, so clearing the npx cache does not break the connection
 
 ## Connect your first session
 
-**Claude Code:** open Claude normally. Relay alpha.13 installs its MCP connection
+**Claude Code:** open Claude normally. Relay alpha.14 installs its MCP connection
 and conversation hooks once in your user settings. Every new or resumed conversation
 can communicate across unrelated folders and repositories. No Relay launcher,
 channel flags, or folder selection is required. Use Claude Code 2.1.299 or newer.
+Upgrade from alpha.13 to fix delivery after more than 30 seconds idle.
 
 If Claude was already open during setup, reconnect Relay from `/mcp` and send your
 next normal prompt, or reopen Claude normally once. An already-idle session cannot

package/next/TROUBLESHOOTING.md

@@ -14,7 +14,7 @@ you selected the intended conversation, especially if your friend has several.
 
 For automatic delivery:
 
-- **Claude:** with Relay alpha.13 and Claude Code 2.1.299 or newer, open Claude
+- **Claude:** with Relay alpha.14 and Claude Code 2.1.299 or newer, open Claude
   normally. Check `/hooks` for Relay's user-level session hooks and `/mcp` for
   `relay_remote`. After updating an existing session, reconnect the MCP server
   and send a normal prompt, or reopen Claude once. Disabled hooks prevent wake-up.
@@ -24,6 +24,11 @@ For automatic delivery:
 If the agent is busy, let it finish. `Accepted` only confirms transport; an
 actual answer appears as `Answered`. A closed client cannot respond.
 
+Alpha.13 had a 30-second idle-listener timeout. Update with
+`npx --yes @platys/relay@latest setup` and reopen Claude once. The corrected
+listener lasts up to seven uninterrupted idle days and is replaced at normal
+turn boundaries. After that idle limit, send a normal prompt to rearm it.
+
 ## Claude says channels are blocked
 
 You are using the older channel integration. Update Relay and run setup again,

package/out/core/claude-hooks.js

@@ -1,4 +1,8 @@
 /** User-level hooks follow conversations everywhere; no workspace data is forwarded. */
+// asyncRewake still enforces timeout even with async:true. These listeners wait
+// for activity, unlike the short synchronous attachment and teardown hooks.
+// Keep below the native signed 32-bit millisecond timer limit.
+export const CLAUDE_LISTENER_TIMEOUT_SECONDS = 7 * 24 * 60 * 60;
 export function mergeClaudeSessionHooks(existing, node, entry, connection) {
     const result = structuredClone(existing);
     result.hooks ??= {};
@@ -7,7 +11,8 @@ export function mergeClaudeSessionHooks(existing, node, entry, connection) {
         if (!Array.isArray(prior))
             throw Error('Existing Claude hooks need review');
         result.hooks[event] = prior.map((group) => ({ ...group, hooks: (group.hooks ?? []).filter((hook) => !(hook.type === 'command' && hook.args?.some((arg) => typeof arg === 'string' && /[\\/]claude-session-hook\.js$/.test(arg)))) })).filter((group) => group.hooks.length);
-        result.hooks[event].push({ hooks: [{ type: 'command', command: node, args: [entry, connection], timeout: event === 'SessionEnd' ? 2 : 30, ...(['SessionStart', 'Stop'].includes(event) ? { async: true, asyncRewake: true } : {}), statusMessage: 'Relay session connection' }] });
+        const listener = ['SessionStart', 'Stop'].includes(event);
+        result.hooks[event].push({ hooks: [{ type: 'command', command: node, args: [entry, connection], timeout: listener ? CLAUDE_LISTENER_TIMEOUT_SECONDS : event === 'SessionEnd' ? 2 : 30, ...(listener ? { async: true, asyncRewake: true } : {}), statusMessage: 'Relay session connection' }] });
     }
     return result;
 }

package/out/core/version.js

@@ -1 +1 @@
-export const VERSION = '0.8.0-alpha.13';
+export const VERSION = '0.8.0-alpha.14';

package/out/node/claude-session-mcp.js

@@ -30,9 +30,12 @@ export class ClaudeSessionMcp {
             if (state.closed)
                 throw Error('Relay is closed for this conversation');
             if (name === 'relay_open') {
-                if (args.task)
-                    await this.store.rpc({ jsonrpc: '2.0', id: input.id, method: 'tools/call', params: { name: 'relay_check', arguments: { session_key: state.session_key, task: args.task } } });
-                return { jsonrpc: '2.0', id: input.id, result: { content: [{ type: 'text', text: JSON.stringify({ session_id: state.session_id, session_key: state.session_key, instructions: sessionContext(state) }) }] } };
+                const checked = await this.store.rpc({ jsonrpc: '2.0', id: input.id, method: 'tools/call', params: { name: 'relay_check', arguments: { session_key: state.session_key, ...(args.task !== undefined ? { task: args.task } : {}) } } });
+                if (checked?.error || checked?.result?.isError)
+                    return checked;
+                const data = JSON.parse(checked.result.content.find((item) => item.type === 'text').text);
+                // The check supplied pending messages: preserve them in the model's response.
+                return { jsonrpc: '2.0', id: input.id, result: { content: [{ type: 'text', text: JSON.stringify({ session_id: state.session_id, session_key: state.session_key, instructions: sessionContext(state), inbox: data.inbox }) }] } };
             }
             if (args.session_key !== state.session_key)
                 throw Error('Use this conversation\'s own Relay key');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platys/relay",
-  "version": "0.8.0-alpha.13",
+  "version": "0.8.0-alpha.14",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/",