thinkpool-pair 0.7.302 → 0.7.303

package/bridge.mjs

@@ -124,7 +124,7 @@ import { stampEvent, makeSeqCounter, maxSeq, seqable, capReplayEvents, chunkRepl
 import { createLatestReplayPump, requestedReplayIds } from './replay-transport.mjs'
 import { classifyCodeEvent, unknownCodeEventNotice } from './code-event-contract.mjs'
 import { fetchPairControlDeliveryAuthority } from './pair-control-authority.mjs'
-import { SIDE_HANDOFF_PROMPT, SIDE_ROLE_PROMPT, appendSideContext, assistantTextSince, sideContextBlock, sideSnapshot } from './side-lane.mjs'
+import { SIDE_HANDOFF_PROMPT, SIDE_ROLE_PROMPT, appendSideContext, assistantTextSince, dispatchSideContexts, sideContextBlock, sideSnapshot } from './side-lane.mjs'
 import { planMeterLine } from './plan-meters.mjs'
 import { priceForModel } from './model-prices.mjs'
 import { makeThrottledTrack } from './presence.mjs'
@@ -994,6 +994,32 @@ function advanceStructuredTurn(entry, now = Date.now()) {
   return true
 }
 
+function dispatchPendingSideContexts(entry) {
+  if (!entry?.pendingSideContexts?.length || typeof entry.session?.sendTurn !== 'function') return false
+  const outcome = dispatchSideContexts({
+    contexts: entry.pendingSideContexts,
+    busy: entry.session?.turnActive === true,
+    sendTurn: (prompt) => entry.session?.sendTurn(prompt),
+  })
+  entry.pendingSideContexts = outcome.pending
+  if (!outcome.dispatched) return false
+  beginStructuredTurn(entry)
+  entry.flush?.()
+  announce()
+  return true
+}
+
+function schedulePendingSideContexts(entry) {
+  if (!entry?.pendingSideContexts?.length || entry._sideContextTimer) return
+  entry._sideContextTimer = setTimeout(() => {
+    entry._sideContextTimer = null
+    if (dispatchPendingSideContexts(entry)) {
+      process.stderr.write('\n  ◆ started main turn from side-lane handoff.\n')
+    }
+  }, 0)
+  entry._sideContextTimer.unref?.()
+}
+
 function stampStructuredTurn(entry, event) {
   if (event && event.turnRev == null && Number(entry?._turnRev) > 0) event.turnRev = entry._turnRev
   return event
@@ -3238,6 +3264,7 @@ function openStructured({ id, runtime = 'claude', model, models, effort, resume,
             const done = { kind: 'control', text: 'Brought to main.', by: request.by }
             stampEvent(done); pushLog(entry, done); bcast('code-event', { term: id, evt: done })
             parent.flush?.()
+            schedulePendingSideContexts(parent)
           } else {
             const failed = { kind: 'control', text: parent ? 'Couldn’t prepare a handoff — try again.' : 'The main terminal is no longer available.', by: request.by }
             stampEvent(failed); pushLog(entry, failed); bcast('code-event', { term: id, evt: failed })
@@ -3252,6 +3279,9 @@ function openStructured({ id, runtime = 'claude', model, models, effort, resume,
         const stalePermissionIds = [...entry.pending.keys()]
         drainPending(entry)
         for (const pendingId of stalePermissionIds) bcast('code-perm', { term: id, id: pendingId, decision: 'deny', name: 'agent' })
+        // Bring-to-main never interrupts an active parent turn. If a handoff arrived
+        // while this lane was working, start it on the first idle tick after settle.
+        schedulePendingSideContexts(entry)
         const settledAt = Date.now()
         if (shouldRecordTurnDone({ entry, subtype: evt.subtype, startedAt, now: settledAt })) {
           persistAgentEvent({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thinkpool-pair",
-  "version": "0.7.302",
+  "version": "0.7.303",
   "description": "Share a local coding-agent CLI (Claude Code, Codex, Gemini, Aider, …) into a ThinkPool Code room, live.",
   "type": "module",
   "bin": {

package/side-lane.mjs

@@ -8,6 +8,9 @@ Focus first on reading, searching, comparing, and answering the side task. You a
 export const SIDE_HANDOFF_PROMPT = `Prepare a compact handoff for the main terminal now.
 Return only the handoff. Include: conclusion, strongest evidence, files changed or artifacts produced, and any unresolved question or recommended next action. Do not continue the investigation and do not address the reader conversationally.`
 
+export const SIDE_MAIN_TURN_PROMPT = `A room member chose Bring to main.
+Read the side-lane handoff below, incorporate the relevant findings into the main lane's current work, and respond now. If the handoff recommends a next step that is already authorized and in scope, take it; otherwise explain the concrete impact on the current work.`
+
 export function sideSnapshot(log) {
   return buildRecapFromLog(Array.isArray(log) ? log : [], SIDE_RECAP_CAP)
 }
@@ -40,3 +43,21 @@ export function appendSideContext(contexts, context, cap = 4) {
   if (!context) return Array.isArray(contexts) ? contexts.slice(-cap) : []
   return [...(Array.isArray(contexts) ? contexts : []), context].slice(-cap)
 }
+
+export function sideMainTurnPrompt(contexts) {
+  const handoffs = (Array.isArray(contexts) ? contexts : []).filter(Boolean)
+  if (!handoffs.length) return ''
+  return `${SIDE_MAIN_TURN_PROMPT}\n\n${handoffs.join('\n\n')}`
+}
+
+export function dispatchSideContexts({ contexts, busy, sendTurn }) {
+  const pending = (Array.isArray(contexts) ? contexts : []).filter(Boolean).slice(-4)
+  if (!pending.length || busy || typeof sendTurn !== 'function') return { dispatched: false, pending }
+  const prompt = sideMainTurnPrompt(pending)
+  try {
+    if (sendTurn(prompt) === false) return { dispatched: false, pending }
+  } catch {
+    return { dispatched: false, pending }
+  }
+  return { dispatched: true, pending: [] }
+}