@triflux/remote 10.41.1 → 10.43.0

package/hub/pipe.mjs

@@ -222,6 +222,7 @@ export function createPipeServer({
     switch (action) {
       case "register": {
         const result = router.registerAgent(payload);
+        if (!result?.ok) return result;
         if (client) {
           client.agentId = payload.agent_id;
           client.subscriptions = new Set(
@@ -230,7 +231,7 @@ export function createPipeServer({
           touchClient(client);
           pushPendingMessages(client.agentId);
         }
-        return { ok: true, data: { ...result, pipe_path: pipePath } };
+        return { ok: true, data: { ...result.data, pipe_path: pipePath } };
       }
 
       case "subscribe": {
@@ -268,6 +269,9 @@ export function createPipeServer({
           payload.heartbeat_ttl_ms || heartbeatTtlMs,
         );
         if (client) touchClient(client);
+        if (result?.effective?.updated === false) {
+          return { ok: false, error: { code: "AGENT_NOT_FOUND", message: `heartbeat target not registered: ${agentId}` } };
+        }
         return { ok: true, data: result };
       }
 

package/hub/public/tray.html

@@ -62,8 +62,8 @@
     .mini-head, .mcp-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 8px; min-width: 0; }
     .mini-title, .mcp-name { font-size: 12px; font-weight: 650; line-height: 1.25; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
     .path-text { font-size: 10px; color: var(--text-muted); margin-top: 4px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
-    .focus-btn { background: transparent; border: 1px solid rgba(10,132,255,0.45); color: #64b5ff; font-size: 10px; line-height: 1; padding: 4px 7px; cursor: pointer; border-radius: 6px; flex: 0 0 auto; }
-    .focus-btn:hover { background: var(--accent); color: #fff; }
+    .copy-btn { background: transparent; border: 1px solid rgba(10,132,255,0.45); color: #64b5ff; font-size: 10px; line-height: 1; padding: 4px 7px; cursor: pointer; border-radius: 6px; flex: 0 0 auto; }
+    .copy-btn:hover { background: var(--accent); color: #fff; }
     .agent-view { display: flex; flex-direction: column; gap: 8px; }
     .project-group { min-width: 0; border: 1px solid rgba(255,255,255,0.06); background: rgba(0,0,0,0.13); border-radius: 9px; overflow: hidden; }
     .project-group > summary, .session-card > summary, .bubble-wrap > summary { list-style: none; }
@@ -115,6 +115,8 @@
     .chip { display: inline-flex; align-items: center; gap: 5px; min-height: 20px; border-radius: 999px; padding: 3px 7px; background: rgba(255,255,255,0.08); border: 1px solid rgba(255,255,255,0.07); font-size: 10px; color: rgba(255,255,255,0.76); }
     .copy-chip { cursor: pointer; }
     .copy-chip:hover { border-color: rgba(10,132,255,0.42); color: #8ec9ff; }
+    .copy-chip, .copy-btn { -webkit-user-drag: none; }
+    .chat-session-id, .bubble-preview, .bubble-full, .runtime-sub, .path-text, .session-summary-title, .session-summary-sub, .project-path { -webkit-user-select: text; user-select: text; }
     .chip.on { color: var(--success); border-color: rgba(50,215,75,0.25); background: rgba(50,215,75,0.08); }
     .chip.partial { color: var(--warning); border-color: rgba(255,214,10,0.25); background: rgba(255,214,10,0.08); }
     .chip.off { color: var(--danger); border-color: rgba(255,69,58,0.25); background: rgba(255,69,58,0.08); }
@@ -190,7 +192,45 @@
     }
     function renderCopyChip(label, value) {
       if (!value) return '';
-      return `<span class="chip copy-chip" title="Copy ${escapeHtml(label)}" data-copy-text="${dataAttr(value)}">${escapeHtml(label)} ${escapeHtml(shortId(value))}</span>`;
+      return `<span class="chip copy-chip" draggable="false" title="Copy ${escapeHtml(label)}" data-copy-text="${dataAttr(value)}">${escapeHtml(label)} ${escapeHtml(shortId(value))}</span>`;
+    }
+
+    function shellQuote(value) {
+      const text = String(value ?? '').trim();
+      return `'${text.replace(/'/g, `'\\''`)}'`;
+    }
+
+    function commandCwd(row) {
+      const cwd = String(row?.cwd || row?.worktreePath || '').trim();
+      if (!cwd || cwd === 'local' || cwd === 'local runtime') return '';
+      if (/^https?:\/\//iu.test(cwd)) return '';
+      return cwd;
+    }
+
+    function sessionAttachCommand(row) {
+      const sid = String(row?.sessionId || '').trim();
+      if (!sid) return '';
+      const agentId = String(row?.agent_id || row?.agent?.id || '').trim().toLowerCase();
+      const cwd = commandCwd(row);
+      const prefix = cwd ? `cd ${shellQuote(cwd)} && ` : '';
+      if (agentId === 'codex') return `${prefix}codex resume ${shellQuote(sid)}`;
+      if (agentId === 'claude') return `${prefix}claude --resume ${shellQuote(sid)}`;
+      if (agentId === 'antigravity') {
+        const conversationId = String(row?.conversationId || '').trim();
+        const token = conversationId || sid;
+        const suffix = token === sid ? '' : ` # session ${sid}`;
+        return `${prefix}agy --conversation ${shellQuote(token)}${suffix}`;
+      }
+      return `${prefix}tfx-live start --session ${shellQuote(sid)} --resume ${shellQuote(sid)}`;
+    }
+
+    function renderSessionCopyButton(row) {
+      const sid = String(row?.sessionId || '').trim();
+      const command = sessionAttachCommand(row);
+      if (!sid || !command) return '';
+      const pid = numericPid(row?.pid);
+      const agentId = row?.agent_id || row?.agent?.id || '';
+      return `<button class="copy-btn" draggable="false" data-copy-text="${dataAttr(command)}" data-session-id="${dataAttr(sid)}" data-pid="${dataAttr(pid)}" data-agent-id="${dataAttr(agentId)}" title="Copy launch command">Copy</button>`;
     }
 
     function collectOpenDetailKeys(container) {
@@ -471,10 +511,8 @@
 
     function renderChatBubble(row, { side = 'worker' } = {}) {
       const sid = row.sessionId || '';
-      const pid = numericPid(row.pid);
-      const agentId = row.agent_id || row.agent?.id || '';
       const text = bubbleText(row, side === 'cto' ? 'CTO prompt unavailable' : 'Worker prompt unavailable');
-      const focusDisabled = row.synthetic || !sid;
+      const copyButton = row.synthetic ? '' : renderSessionCopyButton(row);
       const badge = side === 'cto'
         ? '<span class="agent-badge">T</span>'
         : renderAgentTag(row.agent) || '<span class="agent-badge">A</span>';
@@ -482,7 +520,7 @@
         <div class="bubble-card ${escapeHtml(side)}">
           <div class="chat-session-title">
             <span style="display:flex;align-items:center;gap:6px;min-width:0;">${badge}<span class="chat-session-id">${escapeHtml(sid || side)}</span></span>
-            ${focusDisabled ? '' : `<button class="focus-btn" data-focus-session="1" data-session-id="${dataAttr(sid)}" data-pid="${dataAttr(pid)}" data-agent-id="${dataAttr(agentId)}">Focus</button>`}
+            ${copyButton}
           </div>
           <details class="bubble-wrap" data-open-key="bubble:${escapeHtml(side)}:${dataAttr(sid || text.slice(0, 24))}">
             <summary class="bubble-preview">${escapeHtml(compactText(text, 'prompt'))}</summary>
@@ -494,10 +532,8 @@
 
     function renderRuntimeCard(row) {
       const sid = row.sessionId || '';
-      const pid = numericPid(row.pid);
-      const agentId = row.agent_id || row.agent?.id || '';
       const status = row.status || row.phase || 'active';
-      const focusDisabled = row.focusable === false || !sid || !pid;
+      const copyButton = row.focusable === false ? '' : renderSessionCopyButton(row);
       return `
         <div class="runtime-card">
           ${renderAgentTag(row.agent)}
@@ -505,7 +541,7 @@
             <div class="runtime-title"><span class="runtime-command">${escapeHtml(commandLabel(row))}</span><span class="agent-state ${escapeHtml(status)}">${escapeHtml(status)}</span></div>
             <div class="runtime-sub">${escapeHtml(displayPath(row.cwd || row.host || 'local runtime'))}${row.elapsed ? ` · ${escapeHtml(row.elapsed)}` : ''}</div>
           </div>
-          ${focusDisabled ? '' : `<button class="focus-btn" data-focus-session="1" data-session-id="${dataAttr(sid)}" data-pid="${dataAttr(pid)}" data-agent-id="${dataAttr(agentId)}">Focus</button>`}
+          ${copyButton}
         </div>
       `;
     }
@@ -703,54 +739,15 @@
         setTimeout(() => { element.textContent = previous; }, 700);
       }
     }
-    function postNativeTrayMessage(message) {
-      try {
-        window?.webkit?.messageHandlers?.tray?.postMessage(message);
-      } catch (_err) {
-        // Browser fallback: the web tray can run without a native wrapper.
-      }
-    }
-
-    async function focusSession(sid, pid, agentId, button) {
-      if (!sid) return;
-      const previous = button?.textContent || 'Focus';
-      if (button) {
-        button.disabled = true;
-        button.textContent = 'Focusing…';
-      }
-      try {
-        const res = await fetch('/api/focus-session', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ sessionId: sid, pid: pid || undefined, agentId: agentId || undefined })
-        });
-        const body = await res.json().catch(() => ({}));
-        if (!res.ok || body?.ok === false || body?.focus?.ok === false) throw new Error(body?.error || body?.focus?.error || 'focus failed');
-        if (button) button.textContent = 'Focused';
-        postNativeTrayMessage({ type: 'focus-complete' });
-      } catch (err) {
-        console.error(err);
-        if (button) button.textContent = 'Failed';
-      } finally {
-        setTimeout(() => {
-          if (button) {
-            button.textContent = previous;
-            button.disabled = false;
-          }
-        }, 650);
-      }
-    }
     document.addEventListener('click', event => {
       const copyTarget = event.target.closest('[data-copy-text]');
       if (copyTarget) {
         copyText(copyTarget.dataset.copyText, copyTarget);
-        return;
-      }
-      const focusTarget = event.target.closest('[data-focus-session]');
-      if (focusTarget) {
-        focusSession(focusTarget.dataset.sessionId, Number(focusTarget.dataset.pid || 0), focusTarget.dataset.agentId || '', focusTarget);
       }
     });
+    document.addEventListener('dragstart', event => {
+      if (event.target.closest('[data-copy-text]')) event.preventDefault();
+    });
 
     setInterval(fetchState, 3000);
     fetchState();

package/hub/schema.sql

@@ -0,0 +1,149 @@
+-- tfx-hub 상태 저장소 스키마
+-- SQLite WAL 모드 기반 메시지 버스
+
+-- 에이전트 등록 테이블
+CREATE TABLE IF NOT EXISTS agents (
+  agent_id TEXT PRIMARY KEY,
+  cli TEXT NOT NULL CHECK (cli IN ('codex','gemini','claude','other')),
+  pid INTEGER,
+  capabilities_json TEXT NOT NULL DEFAULT '[]',
+  topics_json TEXT NOT NULL DEFAULT '[]',
+  last_seen_ms INTEGER NOT NULL,
+  lease_expires_ms INTEGER NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('online','stale','offline')),
+  metadata_json TEXT NOT NULL DEFAULT '{}'
+);
+
+-- 메시지 테이블
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL CHECK (type IN ('request','response','event','handoff','human_request','human_response','system')),
+  from_agent TEXT NOT NULL,
+  to_agent TEXT NOT NULL,
+  topic TEXT NOT NULL,
+  priority INTEGER NOT NULL CHECK (priority BETWEEN 1 AND 9),
+  ttl_ms INTEGER NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  expires_at_ms INTEGER NOT NULL,
+  correlation_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL CHECK (status IN ('queued','delivered','acked','expired','dead_letter'))
+);
+
+-- 메시지 수신함 (배달 추적)
+CREATE TABLE IF NOT EXISTS message_inbox (
+  delivery_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  message_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  delivered_at_ms INTEGER,
+  acked_at_ms INTEGER,
+  attempts INTEGER NOT NULL DEFAULT 0,
+  UNIQUE(message_id, agent_id),
+  FOREIGN KEY(message_id) REFERENCES messages(id) ON DELETE CASCADE
+);
+
+-- 사용자 입력 요청 테이블
+CREATE TABLE IF NOT EXISTS human_requests (
+  request_id TEXT PRIMARY KEY,
+  requester_agent TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK (kind IN ('captcha','approval','credential','choice','text')),
+  prompt TEXT NOT NULL,
+  schema_json TEXT NOT NULL DEFAULT '{}',
+  state TEXT NOT NULL CHECK (state IN ('pending','accepted','declined','cancelled','timed_out')),
+  deadline_ms INTEGER NOT NULL,
+  default_action TEXT NOT NULL CHECK (default_action IN ('decline','cancel','timeout_continue')),
+  correlation_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  response_json TEXT
+);
+
+-- 데드 레터 큐
+CREATE TABLE IF NOT EXISTS dead_letters (
+  message_id TEXT PRIMARY KEY,
+  reason TEXT NOT NULL,
+  failed_at_ms INTEGER NOT NULL,
+  last_error TEXT
+);
+
+-- 인덱스
+CREATE INDEX IF NOT EXISTS idx_messages_status ON messages(status);
+CREATE INDEX IF NOT EXISTS idx_messages_to_agent ON messages(to_agent, status);
+CREATE INDEX IF NOT EXISTS idx_messages_correlation ON messages(correlation_id);
+CREATE INDEX IF NOT EXISTS idx_messages_trace ON messages(trace_id);
+CREATE INDEX IF NOT EXISTS idx_messages_expires ON messages(expires_at_ms);
+CREATE INDEX IF NOT EXISTS idx_messages_priority ON messages(priority DESC, created_at_ms ASC);
+CREATE INDEX IF NOT EXISTS idx_inbox_agent ON message_inbox(agent_id, delivered_at_ms);
+CREATE INDEX IF NOT EXISTS idx_inbox_message ON message_inbox(message_id);
+CREATE INDEX IF NOT EXISTS idx_human_requests_state ON human_requests(state);
+CREATE INDEX IF NOT EXISTS idx_agents_status ON agents(status);
+CREATE INDEX IF NOT EXISTS idx_agents_lease ON agents(lease_expires_ms);
+
+-- Assign Job 테이블
+CREATE TABLE IF NOT EXISTS assign_jobs (
+  job_id TEXT PRIMARY KEY,
+  supervisor_agent TEXT NOT NULL,
+  worker_agent TEXT NOT NULL,
+  topic TEXT NOT NULL DEFAULT 'assign.job',
+  task TEXT NOT NULL DEFAULT '',
+  payload_json TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL CHECK (status IN ('queued','running','succeeded','failed','timed_out')),
+  attempt INTEGER NOT NULL DEFAULT 1,
+  retry_count INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 0,
+  priority INTEGER NOT NULL DEFAULT 5 CHECK (priority BETWEEN 1 AND 9),
+  ttl_ms INTEGER NOT NULL DEFAULT 600000,
+  timeout_ms INTEGER NOT NULL DEFAULT 600000,
+  deadline_ms INTEGER,
+  trace_id TEXT NOT NULL,
+  correlation_id TEXT NOT NULL,
+  last_message_id TEXT,
+  result_json TEXT,
+  error_json TEXT,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL,
+  started_at_ms INTEGER,
+  dispatched_at_ms INTEGER,
+  completed_at_ms INTEGER,
+  last_retry_at_ms INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_status ON assign_jobs(status, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_supervisor ON assign_jobs(supervisor_agent, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_worker ON assign_jobs(worker_agent, updated_at_ms DESC);
+CREATE INDEX IF NOT EXISTS idx_assign_jobs_deadline ON assign_jobs(deadline_ms, status);
+
+-- 파이프라인 상태 테이블 (Phase 2)
+CREATE TABLE IF NOT EXISTS pipeline_state (
+  team_name TEXT PRIMARY KEY,
+  phase TEXT NOT NULL DEFAULT 'plan',
+  fix_attempt INTEGER DEFAULT 0,
+  fix_max INTEGER DEFAULT 3,
+  ralph_iteration INTEGER DEFAULT 0,
+  ralph_max INTEGER DEFAULT 10,
+  artifacts TEXT DEFAULT '{}',
+  phase_history TEXT DEFAULT '[]',
+  created_at INTEGER,
+  updated_at INTEGER
+);
+
+-- Reflexion 에러 학습 테이블
+CREATE TABLE IF NOT EXISTS reflexion_entries (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL DEFAULT 'reflexion', -- reflexion | adaptive
+  error_pattern TEXT NOT NULL,          -- 에러 시그니처 (정규화)
+  error_message TEXT NOT NULL,          -- 원본 에러 메시지
+  context_json TEXT NOT NULL DEFAULT '{}', -- { file, function, cli, agent }
+  solution TEXT NOT NULL,               -- 해결책 설명
+  solution_code TEXT,                   -- 해결 코드 스니펫 (있으면)
+  adaptive_state_json TEXT NOT NULL DEFAULT '{}', -- adaptive rule metadata
+  confidence REAL NOT NULL DEFAULT 0.5, -- 솔루션 신뢰도 (0-1)
+  hit_count INTEGER NOT NULL DEFAULT 1, -- 매칭 횟수
+  success_count INTEGER NOT NULL DEFAULT 0, -- 성공 횟수
+  last_hit_ms INTEGER NOT NULL,
+  created_at_ms INTEGER NOT NULL,
+  updated_at_ms INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_reflexion_pattern ON reflexion_entries(error_pattern);
+CREATE INDEX IF NOT EXISTS idx_reflexion_confidence ON reflexion_entries(confidence DESC);

package/hub/server.mjs

@@ -32,6 +32,13 @@ import {
 import { broker as brokerInstance, reloadBroker } from "@triflux/core/hub/account-broker.mjs";
 import { createAdaptiveEngine } from "@triflux/core/hub/adaptive.mjs";
 import { createAssignCallbackServer } from "@triflux/core/hub/assign-callbacks.mjs";
+import {
+  clampDurationMs,
+  DEFAULT_ASSIGN_TIMEOUT_MS,
+  DEFAULT_ASSIGN_TTL_MS,
+  DEFAULT_REGISTER_TIMEOUT_SEC,
+  resolveWorkerLeaseTtlMs,
+} from "@triflux/core/hub/lib/timeout-defaults.mjs";
 import { DelegatorService } from "@triflux/core/hub/delegator/index.mjs";
 import { createHitlManager } from "@triflux/core/hub/hitl.mjs";
 import {
@@ -143,7 +150,7 @@ function buildHubUrl(host, port) {
 
 function parseHubPort(value) {
   const parsed = Number.parseInt(String(value ?? ""), 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
 }
 
 function isPidAlive(pid, killFn = process.kill) {
@@ -963,16 +970,17 @@ export async function startHub({
   createDelegatorWorker = createDelegatorMcpWorker,
 } = {}) {
   const resolvedPort = parseHubPort(portOpt);
-  const portSpecified = Number.isFinite(resolvedPort) && resolvedPort > 0;
+  const portSpecified = Number.isFinite(resolvedPort);
+  const ephemeralPort = resolvedPort === 0;
   const livePeer = detectLivePeer();
   const livePidPort = parseHubPort(livePeer?.port);
-  const port = portSpecified
+  let port = portSpecified
     ? resolvedPort
     : resolveHubPort(process.env, {
         detectPeer: () => livePeer,
       });
 
-  if (portSpecified && livePeer.alive && livePidPort && port !== livePidPort) {
+  if (portSpecified && !ephemeralPort && livePeer.alive && livePidPort && port !== livePidPort) {
     hubLog.warn(
       {
         requestedPort: port,
@@ -983,11 +991,8 @@ export async function startHub({
     );
   }
 
-  const existingHub = await tryReuseExistingHub({
-    port,
-    portSpecified,
-    host,
-    detectPeer: () => livePeer,
+  const existingHub = ephemeralPort ? null : await tryReuseExistingHub({
+    port, portSpecified, host, detectPeer: () => livePeer,
   });
   if (existingHub) return existingHub;
 
@@ -1026,7 +1031,7 @@ export async function startHub({
     lockHeld = false;
   };
 
-  const lockedExistingHub = await tryReuseExistingHub({
+  const lockedExistingHub = ephemeralPort ? null : await tryReuseExistingHub({
     port,
     portSpecified,
     host,
@@ -1038,9 +1043,9 @@ export async function startHub({
   }
 
   const HUB_TOKEN = process.env.TFX_HUB_TOKEN?.trim() || null;
-  if (HUB_TOKEN) {
+  if (!ephemeralPort && HUB_TOKEN) {
     writeOwnedTokenFile({ token: HUB_TOKEN, port });
-  } else {
+  } else if (!ephemeralPort) {
     cleanupOwnedTokenFile({ token: HUB_TOKEN, port });
   }
 
@@ -1690,7 +1695,7 @@ export async function startHub({
             const {
               agent_id,
               cli,
-              timeout_sec = 600,
+              timeout_sec = DEFAULT_REGISTER_TIMEOUT_SEC,
               topics = [],
               capabilities = [],
               metadata = {},
@@ -1709,7 +1714,10 @@ export async function startHub({
               metadata?.task ||
               cli;
             const workerStartedAt = performance.now();
-            const heartbeat_ttl_ms = (timeout_sec + 120) * 1000;
+            const hasExplicitTimeout = Number.isFinite(Number(body.timeout_sec));
+            const heartbeat_ttl_ms = hasExplicitTimeout
+              ? (timeout_sec + 120) * 1000
+              : Math.max((timeout_sec + 120) * 1000, resolveWorkerLeaseTtlMs());
             const result = await pipe.executeCommand("register", {
               agent_id,
               cli,
@@ -1725,7 +1733,7 @@ export async function startHub({
               });
               recordWorker(agent_id, "spawned", command, 0);
             }
-            return writeJson(res, 200, result);
+            return writeJson(res, result.ok ? 200 : 409, result);
           }
 
           if (path === "/bridge/result" && req.method === "POST") {
@@ -1750,6 +1758,16 @@ export async function startHub({
             return writeJson(res, 200, result);
           }
 
+          if (path === "/bridge/heartbeat" && req.method === "POST") {
+            const { agent_id, ttl_ms } = body;
+            if (!agent_id) return writeJson(res, 400, { ok: false, error: "agent_id 필수" });
+            const result = await pipe.executeCommand("heartbeat", {
+              agent_id,
+              heartbeat_ttl_ms: clampDurationMs(ttl_ms, resolveWorkerLeaseTtlMs()),
+            });
+            return writeJson(res, result.ok ? 200 : 404, result);
+          }
+
           if (path === "/bridge/control" && req.method === "POST") {
             const {
               from_agent = "lead",
@@ -1881,8 +1899,8 @@ export async function startHub({
               topic = "assign.job",
               payload = {},
               priority = 5,
-              ttl_ms = 600000,
-              timeout_ms = 600000,
+              ttl_ms = DEFAULT_ASSIGN_TTL_MS,
+              timeout_ms = DEFAULT_ASSIGN_TIMEOUT_MS,
               max_retries = 0,
               trace_id,
               correlation_id,
@@ -2352,7 +2370,7 @@ export async function startHub({
     try {
       store.close();
     } catch {}
-    if (!preserveTokenFile) {
+    if (!ephemeralPort && !preserveTokenFile) {
       cleanupOwnedTokenFile({ token: HUB_TOKEN, port });
     }
     releaseStartupLock();
@@ -2426,6 +2444,8 @@ export async function startHub({
       httpServer.listen(port, host, () => {
         httpServer.off("error", onError);
         try {
+          const boundAddress = httpServer.address();
+          if (boundAddress && typeof boundAddress === "object") port = boundAddress.port;
           let idleTimer = null;
           let stopPromise = null;
 
@@ -2446,7 +2466,7 @@ export async function startHub({
             idleTimeoutMs: hubIdleTimeoutMs,
           };
 
-          writeState({
+          if (!ephemeralPort) writeState({
             pid: process.pid,
             port,
             host,
@@ -2464,7 +2484,7 @@ export async function startHub({
             session_id: sessionId,
           });
           releaseStartupLock();
-          void syncHubMcpSettingsIfAvailable({ hubUrl: info.url });
+          if (!ephemeralPort) void syncHubMcpSettingsIfAvailable({ hubUrl: info.url });
 
           hubLog.info(
             {
@@ -2551,8 +2571,10 @@ export async function startHub({
                 synapseRegistry.destroy();
               } catch {}
               store.close();
-              cleanupOwnedPidFile();
-              cleanupOwnedTokenFile({ token: HUB_TOKEN, port });
+              if (!ephemeralPort) {
+                cleanupOwnedPidFile();
+                cleanupOwnedTokenFile({ token: HUB_TOKEN, port });
+              }
               httpServer.closeAllConnections();
               await new Promise((resolveClose) =>
                 httpServer.close(resolveClose),