@logicseek/hello-cc 1.0.1 → 1.0.2

package/lib/ui/help.mjs

@@ -8,13 +8,15 @@ export function createHelpFunctions(config = {}) {
     helpMain() {
       console.log(`${productName} ${version}
 
-Project-local coordination bus for multiple Claude Code and Codex CLI sessions.
+Project-local coordination bus for Claude Code, Codex, and DeepSeek Harness sessions.
 
 Usage:
   ${cliName} [--root DIR] [--db FILE] [--json] <command> [args]
 
 Commands:
   web                          Start coordination, shims, tmux, and browser console
+  dsh <setup|status|web>        Connect DeepSeek Harness through project-local hooks
+  native <subcommand>           Run owned Codex/Claude/dsh workers through native protocols
   up                           Initialize local coordination only
   down                         Stop the running hello-cc web runtime
   update                       Update the global npm install of hello-cc
@@ -44,7 +46,8 @@ Commands:
   gc [--older-than DAYS] [--history] [--yes] Clean technical state; opt in to history cleanup
   doctor                       Run a read-only database health check (integrity, sizes, row counts)
 Internal:
-  hook                         Hook entrypoint used by Claude/Codex
+  mcp serve --peer ID           Serve executor-authorized project coordination tools over stdio
+  hook                         Hook entrypoint used by Claude/Codex/dsh
   find-root                    Shim helper
   which-real                   Shim helper
 

package/lib/web/adoption-state.mjs

@@ -0,0 +1,55 @@
+// Persist Web terminal detachment separately from process liveness. Existing
+// audit events survive a runtime restart without changing the database schema.
+
+function identityFor(value = {}) {
+  const identity = value.adoptionIdentity || value.identity || value;
+  const processIdentity = identity.process_identity || identity.processIdentity || {};
+  return {
+    pid: identity.pid || processIdentity.pid || value.pid || null,
+    process_start_token: identity.process_start_token || processIdentity.startToken || null,
+    tmux_session_created: identity.tmux_session_created || identity.session_created || null,
+    tmux_session_id: identity.tmux_session_id || identity.session_id || null
+  };
+}
+
+export function writeAdoptionState(db, session, paused, time) {
+  const peer = session?.peerId || session?.peer || session?.id;
+  if (typeof peer !== 'string' || !peer || typeof paused !== 'boolean' ||
+      !Number.isSafeInteger(time) || time < 0) {
+    throw new TypeError('Adoption state requires a peer, a boolean paused value, and an integer timestamp');
+  }
+  const payload = {
+    peer,
+    pane: session.pane || null,
+    identity: identityFor(session),
+    source: 'web',
+    target_peer: peer,
+    runtime_session_id: session.id || null
+  };
+  db.prepare(`
+    INSERT INTO events(type, actor, task_id, payload, created_at)
+    VALUES (?, 'web', NULL, ?, ?)
+  `).run(paused ? 'web.adoption.paused' : 'web.adoption.resumed', JSON.stringify(payload), time);
+  return { ...payload, paused };
+}
+
+export function adoptionPaused(db, { peer, pane = null, ...observed } = {}) {
+  if (typeof peer !== 'string' || !peer) return false;
+  const event = db.prepare(`
+    SELECT type, payload FROM events
+    WHERE type IN ('web.adoption.paused', 'web.adoption.resumed')
+      AND json_valid(payload)
+      AND json_extract(payload, '$.peer') = ?
+      AND (? IS NULL OR json_extract(payload, '$.pane') = ? OR json_extract(payload, '$.pane') IS NULL)
+    ORDER BY id DESC LIMIT 1
+  `).get(peer, pane, pane);
+  if (!event || event.type !== 'web.adoption.paused') return false;
+  const stored = identityFor(JSON.parse(event.payload));
+  const current = identityFor(observed);
+  // Known identity changes mean a different live terminal. An unavailable
+  // observation cannot silently revoke an intentional pause.
+  for (const key of Object.keys(stored)) {
+    if (stored[key] !== null && current[key] !== null && String(stored[key]) !== String(current[key])) return false;
+  }
+  return true;
+}

package/lib/web/auto-attach.mjs

@@ -5,6 +5,9 @@
 import { inferPeerKind } from '../integrations/providers.mjs';
 import { runTmux } from '../tmux.mjs';
 import { inspectProviderProcess } from '../integrations/peers/processes.mjs';
+import { isDshHookBinding } from '../core/peers/bindings.mjs';
+import { inspectProcessIdentity } from '../process/identity.mjs';
+import { adoptionPaused } from './adoption-state.mjs';
 
 export function createAutoAttach(deps) {
   const {
@@ -17,6 +20,8 @@ export function createAutoAttach(deps) {
     resolveSessionPeerId,
     reAdoptOrphanManagedTmuxSessions, reapDeadPeersForProject
   } = deps;
+  const execTmux = deps.runTmux || runTmux;
+  const inspectIdentity = deps.inspectProcessIdentity || inspectProcessIdentity;
 
   function listTmuxPanesOnce() {
     // Use '|' not '\t' as the field separator: older tmux (3.3a) replaces
@@ -25,7 +30,7 @@ export function createAutoAttach(deps) {
     // user-created session name could contain '|', corrupting the parse. Callers
     // that need the session name use tmuxSessionNameForPane(pane.pane) which
     // queries a single field with no separator issue.
-    const result = runTmux([
+    const result = execTmux([
       'list-panes',
       '-a',
       '-F',
@@ -98,7 +103,7 @@ export function createAutoAttach(deps) {
         SELECT p.id, p.kind, p.role, p.worktree, p.pid,
                b.peer AS binding_peer, b.provider, b.provider_session_id,
                b.provider_session_name, b.resume_mode, b.resume_arg,
-               b.command AS binding_command, b.runtime_session_id,
+               b.command AS binding_command, b.transport AS binding_transport, b.runtime_session_id,
                b.runtime_target
         FROM peers p
         LEFT JOIN peer_bindings b ON b.peer = p.id
@@ -130,12 +135,23 @@ export function createAutoAttach(deps) {
       const attached = attachedTmuxState(ctx, db);
 
       for (const row of rows) {
+        if (['native', 'app-server'].includes(row.binding_transport)) continue;
+        // A dsh PID/pane belongs to the service, which may host many Agent
+        // sessions. A hook's conversation binding grants no terminal control.
+        if (isDshHookBinding({ provider: row.provider || row.kind, transport: row.binding_transport })) continue;
         if (attached.peers.has(row.id)) continue;
         if (row.binding_peer && attached.peers.has(row.binding_peer)) continue;
         if (row.runtime_session_id && attached.peers.has(row.runtime_session_id)) continue;
 
         const pane = paneByPid.get(Number(row.pid));
         if (!pane || attached.panes.has(pane.pane)) continue;
+        const identity = inspectIdentity(pane.pid);
+        if (adoptionPaused(db, {
+          peer: row.id,
+          pane: pane.pane,
+          pid: pane.pid,
+          process_identity: identity?.state === 'live' ? identity.identity : null
+        })) continue;
 
         const binding = row.binding_peer ? {
           provider: row.provider,