@agfpd/iapeer 0.2.55 → 0.2.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agfpd/iapeer",
-  "version": "0.2.55",
+  "version": "0.2.57",
   "description": "Foundation core for the iapeer multi-agent ecosystem: identity, registry, storage, codec.",
   "type": "module",
   "bin": {

package/src/daemon/daemon.test.ts

@@ -77,7 +77,12 @@ describe('listTools', () => {
     const tools = listTools(readPeersIndex()) as any[]
     expect(tools.map(t => t.name).sort()).toEqual(['send_to_peer'])
     expect(tools.every(t => t._meta['anthropic/alwaysLoad'] === true)).toBe(true)
-    expect(tools.find(t => t.name === 'send_to_peer').description).toContain('arthur')
+    const sendTool = tools.find(t => t.name === 'send_to_peer')
+    expect(sendTool.description).toContain('arthur')
+    expect(sendTool.description).toContain('wakes it and delivers there')
+    expect(sendTool.description).toContain('parallel to the default runtime')
+    expect(sendTool.inputSchema.properties.runtime.description).toContain('wakes it warm-on-demand')
+    expect(sendTool.inputSchema.properties.runtime.description).toContain('parallel session')
   })
 })
 

package/src/daemon/index.ts

@@ -98,7 +98,7 @@ export function buildSendDescription(index: PeersIndex): string {
   }
   lines.push(
     '',
-    "Use `personality`, not a runtime-prefixed identity. Set `runtime` only for a current-send override. Descriptions identify the peer's role; runtimes identify reachable delivery endpoints; intelligence identifies the nature of the peer (artificial / natural / absent). Inbound peer messages arrive as <iap from-personality=\"...\" from-runtime=\"...\" from-intelligence=\"...\"> blocks. The topic attribute is optional.",
+    "Use `personality`, not a runtime-prefixed identity. Set `runtime` to target a specific declared runtime for this send. If that runtime is warm-asleep, the daemon wakes it and delivers there; use this to intentionally bring up a second session of the same peer in parallel to the default runtime (for example codex alongside claude). Descriptions identify the peer's role; runtimes identify reachable delivery endpoints; intelligence identifies the nature of the peer (artificial / natural / absent). Inbound peer messages arrive as <iap from-personality=\"...\" from-runtime=\"...\" from-intelligence=\"...\"> blocks. The topic attribute is optional.",
   )
   return lines.join('\n')
 }
@@ -122,7 +122,7 @@ export function listTools(index: PeersIndex): unknown[] {
           runtime: {
             type: 'string',
             description:
-              'Optional delivery runtime override for this send. Runtime ids are short channel names such as claude, codex, telegram.',
+              'Optional target runtime for this send. If the specified runtime is declared and wakeable but asleep, the daemon wakes it warm-on-demand and delivers there; choosing a non-default runtime can intentionally start that peer\'s parallel session. Runtime ids are short channel names such as claude, codex, telegram.',
             pattern: RUNTIME_RE_SOURCE,
           },
           message: {

package/src/lifecycle/index.ts

@@ -1001,6 +1001,22 @@ export async function wakeOrSpawn(args: WakeArgs, deps: WakeDeps = {}): Promise<
     const firstMessage = composeFirstMessage(cwd, args.task, fresh)
     const result = await launch(spec, adapter, firstMessage, launchCfg)
     if (result.status === 'FAILED') {
+      // enroll-on-FAILED (0.2.57): launch can return FAILED on a ready-gate false-negative
+      // (model-did-not-process-task) while the tmux session + its process actually SURVIVE —
+      // observed live (ttlverify, 13.06). Since 0.2.55 removed the self-TTL, such a remnant
+      // would be an UNBOUNDED orphan: no .session → invisible to superviseTick's idle-reap,
+      // and no wall-clock backstop. If the session is in fact ALIVE, enroll it so the
+      // activity-aware idle-reap stays the UNIVERSAL bound (a genuinely wedged session is
+      // idle-reaped after idleSecs; a false-negative-but-working one keeps working and is
+      // reaped only when truly idle, and its next message reaches it via the has-session fast
+      // path above). We do NOT flip to READY — the wake DID fail its ready-gate, the caller
+      // must still hear FAILED; we only make the live remnant supervised. Best-effort: a write
+      // hiccup must not mask the original FAILED reason.
+      if (sessionAlive(sock, identity)) {
+        try {
+          writeSessionState(cfg, { identity, runtime, personality: args.personality, cwd, wokeAt: Date.now() })
+        } catch { /* keep the original FAILED reason — enroll is best-effort */ }
+      }
       return { status: 'FAILED', woke: false, runtime, reason: result.reason }
     }
     // The session is up and the message delivered. Recording supervise-state must not