@triflux/remote 10.42.0 → 10.43.0

package/hub/pipe.mjs

@@ -269,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/schema.sql

@@ -103,6 +103,7 @@ CREATE TABLE IF NOT EXISTS assign_jobs (
   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
 );

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),

package/hub/store.mjs

@@ -5,6 +5,7 @@ import { mkdirSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { clampDurationMs, DEFAULT_ASSIGN_TIMEOUT_MS, DEFAULT_ASSIGN_TTL_MS } from "@triflux/core/hub/lib/timeout-defaults.mjs";
 import { uuidv7 } from "@triflux/core/hub/lib/uuidv7.mjs";
 import { recalcConfidence } from "@triflux/core/hub/reflexion.mjs";
 
@@ -111,7 +112,7 @@ export function createStore(dbPath, options = {}) {
   db.exec(
     "CREATE TABLE IF NOT EXISTS _meta (key TEXT PRIMARY KEY, value TEXT)",
   );
-  const SCHEMA_VERSION = "4";
+  const SCHEMA_VERSION = "5";
   const curVer = (() => {
     try {
       return db
@@ -143,6 +144,7 @@ export function createStore(dbPath, options = {}) {
     "type",
     "TEXT NOT NULL DEFAULT 'reflexion'",
   );
+  ensureColumn(db, "assign_jobs", "dispatched_at_ms", "INTEGER");
   ensureColumn(
     db,
     "reflexion_entries",
@@ -233,12 +235,12 @@ export function createStore(dbPath, options = {}) {
         job_id, supervisor_agent, worker_agent, topic, task, payload_json,
         status, attempt, retry_count, max_retries, priority, ttl_ms, timeout_ms, deadline_ms,
         trace_id, correlation_id, last_message_id, result_json, error_json,
-        created_at_ms, updated_at_ms, started_at_ms, completed_at_ms, last_retry_at_ms
+        created_at_ms, updated_at_ms, started_at_ms, dispatched_at_ms, completed_at_ms, last_retry_at_ms
       ) VALUES (
         @job_id, @supervisor_agent, @worker_agent, @topic, @task, @payload_json,
         @status, @attempt, @retry_count, @max_retries, @priority, @ttl_ms, @timeout_ms, @deadline_ms,
         @trace_id, @correlation_id, @last_message_id, @result_json, @error_json,
-        @created_at_ms, @updated_at_ms, @started_at_ms, @completed_at_ms, @last_retry_at_ms
+        @created_at_ms, @updated_at_ms, @started_at_ms, @dispatched_at_ms, @completed_at_ms, @last_retry_at_ms
       )`),
     getAssign: db.prepare("SELECT * FROM assign_jobs WHERE job_id = ?"),
     updateAssign: db.prepare(`
@@ -263,6 +265,7 @@ export function createStore(dbPath, options = {}) {
         error_json=@error_json,
         updated_at_ms=@updated_at_ms,
         started_at_ms=@started_at_ms,
+        dispatched_at_ms=@dispatched_at_ms,
         completed_at_ms=@completed_at_ms,
         last_retry_at_ms=@last_retry_at_ms
       WHERE job_id=@job_id`),
@@ -356,12 +359,6 @@ export function createStore(dbPath, options = {}) {
     return Math.max(1, Math.min(Math.trunc(num), 9));
   }
 
-  function clampDuration(value, fallback = 600000, min = 1000, max = 86400000) {
-    const num = Number(value);
-    if (!Number.isFinite(num)) return fallback;
-    return Math.max(min, Math.min(Math.trunc(num), max));
-  }
-
   const store = {
     db,
     uuidv7,
@@ -419,11 +416,12 @@ export function createStore(dbPath, options = {}) {
 
     refreshLease(agentId, ttlMs = 30000) {
       const now = Date.now();
-      S.heartbeat.run(now, now + ttlMs, agentId);
+      const write = S.heartbeat.run(now, now + ttlMs, agentId);
       return {
         agent_id: agentId,
         lease_expires_ms: now + ttlMs,
         server_time_ms: now,
+        effective: { updated: write.changes > 0, store_type: "sqlite", db_path: dbPath ?? null },
       };
     },
 
@@ -629,9 +627,10 @@ export function createStore(dbPath, options = {}) {
       retry_count = 0,
       max_retries = 0,
       priority = 5,
-      ttl_ms = 600000,
-      timeout_ms = 600000,
+      ttl_ms = DEFAULT_ASSIGN_TTL_MS,
+      timeout_ms = DEFAULT_ASSIGN_TIMEOUT_MS,
       deadline_ms,
+      dispatched_at_ms = null,
       trace_id,
       correlation_id,
       last_message_id = null,
@@ -639,7 +638,7 @@ export function createStore(dbPath, options = {}) {
       error = null,
     }) {
       const now = Date.now();
-      const normalizedTimeout = clampDuration(timeout_ms, 600000);
+      const normalizedTimeout = clampDurationMs(timeout_ms, DEFAULT_ASSIGN_TIMEOUT_MS);
       const row = {
         job_id: job_id || uuidv7(),
         supervisor_agent,
@@ -652,7 +651,7 @@ export function createStore(dbPath, options = {}) {
         retry_count: Math.max(0, Number(retry_count) || 0),
         max_retries: Math.max(0, Number(max_retries) || 0),
         priority: clampPriority(priority, 5),
-        ttl_ms: clampDuration(ttl_ms, normalizedTimeout),
+        ttl_ms: clampDurationMs(ttl_ms, normalizedTimeout),
         timeout_ms: normalizedTimeout,
         deadline_ms: Number.isFinite(Number(deadline_ms))
           ? Math.trunc(Number(deadline_ms))
@@ -665,6 +664,10 @@ export function createStore(dbPath, options = {}) {
         created_at_ms: now,
         updated_at_ms: now,
         started_at_ms: status === "running" ? now : null,
+        dispatched_at_ms:
+          dispatched_at_ms == null || !Number.isFinite(Number(dispatched_at_ms))
+            ? null
+            : Math.trunc(Number(dispatched_at_ms)),
         completed_at_ms: ["succeeded", "failed", "timed_out"].includes(status)
           ? now
           : null,
@@ -689,7 +692,7 @@ export function createStore(dbPath, options = {}) {
       const isTerminal = ["succeeded", "failed", "timed_out"].includes(
         nextStatus,
       );
-      const nextTimeout = clampDuration(
+      const nextTimeout = clampDurationMs(
         patch.timeout_ms ?? current.timeout_ms,
         current.timeout_ms,
       );
@@ -717,7 +720,7 @@ export function createStore(dbPath, options = {}) {
           patch.priority ?? current.priority,
           current.priority || 5,
         ),
-        ttl_ms: clampDuration(
+        ttl_ms: clampDurationMs(
           patch.ttl_ms ?? current.ttl_ms,
           current.ttl_ms || nextTimeout,
         ),
@@ -758,6 +761,7 @@ export function createStore(dbPath, options = {}) {
           : nextStatus === "running"
             ? current.started_at_ms || now
             : current.started_at_ms,
+        dispatched_at_ms: Object.hasOwn(patch, "dispatched_at_ms") ? patch.dispatched_at_ms : current.dispatched_at_ms,
         completed_at_ms: Object.hasOwn(patch, "completed_at_ms")
           ? patch.completed_at_ms
           : isTerminal
@@ -849,7 +853,7 @@ export function createStore(dbPath, options = {}) {
         current.attempt + 1,
         Number(patch.attempt ?? current.attempt + 1) || 1,
       );
-      const nextTimeout = clampDuration(
+      const nextTimeout = clampDurationMs(
         patch.timeout_ms ?? current.timeout_ms,
         current.timeout_ms,
       );
@@ -861,6 +865,7 @@ export function createStore(dbPath, options = {}) {
         deadline_ms: Date.now() + nextTimeout,
         completed_at_ms: null,
         started_at_ms: null,
+        dispatched_at_ms: null,
         last_retry_at_ms: Date.now(),
         result: patch.result ?? null,
         error: Object.hasOwn(patch, "error") ? patch.error : current.error,

package/hub/team/claude-daemon-control.mjs

@@ -464,25 +464,46 @@ export function sendClaudeControlRequest(
 
 // claude daemon 은 control.sock 의 mutating op(dispatch 등)에 control-key
 // 인증을 강제한다 (미제시 시 EAUTH "didn't present the daemon control key").
-// key 는 <configDir>/daemon/control.key (configDir 스코프별). 파일이 없으면
-// 인증 미강제 daemon 으로 보고 auth 필드를 생략한다 (fail-open — 구버전 호환).
+// OMC runtime config 는 .omc-launch-profile.json 의 sourceConfigDir 에서 key 를
+// 발급한다. control.sock 은 runtime config hash 를 쓰더라도 auth 는 발급 config
+// 에서 읽어야 한다. 일반 daemon 은 <configDir>/daemon/control.key 를 사용한다.
+// 어느 경로에도 파일이 없으면 인증 미강제 daemon 으로 보고 auth 를 생략한다
+// (fail-open — 구버전 호환).
 export async function readDaemonControlKey(
   configDir = resolveClaudeConfigDir(),
+  { diagnostics } = {},
 ) {
-  try {
-    const key = await fs.readFile(
-      path.join(configDir, "daemon", "control.key"),
-      "utf8",
-    );
-    return key.trim() || undefined;
-  } catch {
-    return undefined;
+  if (!configDir) return undefined;
+
+  const runtimeConfigDir = path.resolve(configDir);
+  const omcProfile = await readOmcLaunchProfile(runtimeConfigDir);
+  const keyConfigDirs = [omcProfile?.sourceConfigDir, runtimeConfigDir].filter(
+    (candidate, index, entries) =>
+      candidate && entries.indexOf(candidate) === index,
+  );
+
+  for (const keyConfigDir of keyConfigDirs) {
+    const keyPath = path.join(keyConfigDir, "daemon", "control.key");
+    try {
+      const key = await fs.readFile(keyPath, "utf8");
+      if (key.trim()) return key.trim();
+    } catch (error) {
+      if (error?.code === "ENOENT") continue;
+      if (Array.isArray(diagnostics)) {
+        diagnostics.push({
+          code: error?.code || "UNKNOWN",
+          path: keyPath,
+          message: error?.message || String(error),
+        });
+      }
+    }
   }
+  return undefined;
 }
 
-export async function buildDaemonControlAuth(configDir) {
+export async function buildDaemonControlAuth(configDir, opts = {}) {
   if (!configDir) return {};
-  const auth = await readDaemonControlKey(configDir);
+  const auth = await readDaemonControlKey(configDir, opts);
   return auth ? { auth } : {};
 }
 

package/hub/team/cli/commands/start/parse-args.mjs

@@ -74,7 +74,7 @@ export function parseTeamArgs(args = []) {
   const assigns = []; // --assign "codex:프롬프트:역할" 형식
   let autoAttach = true;
   let progressive = true;
-  let timeoutSec = 300;
+  let timeoutSec = 0;
   let verbose = false;
   let dashboard = true;
   let dashboardLayout = "lite";
@@ -130,7 +130,7 @@ export function parseTeamArgs(args = []) {
     } else if (current === "--no-progressive") {
       progressive = false;
     } else if (current === "--timeout" && args[index + 1]) {
-      timeoutSec = Number(args[++index]) || 300;
+      timeoutSec = Number(args[++index]) || 0;
     } else if (current === "--mcp-profile" && args[index + 1]) {
       mcpProfile = args[++index].trim();
     } else if ((current === "--model" || current === "-m") && args[index + 1]) {