triflux 10.3.4 → 10.4.0

package/hub/assign-callbacks.mjs

@@ -1,5 +1,5 @@
-// hub/assign-callbacks.mjs — assign job 상태 변경용 Named Pipe/Unix socket 브로드캐스터
-
+// hub/assign-callbacks.mjs — assign job 상태 변경용 Named Pipe/Unix socket 브로드캐스터
+
 import net from 'node:net';
 import { existsSync, unlinkSync } from 'node:fs';
 import { IS_WINDOWS, pipePath } from './platform.mjs';
@@ -7,127 +7,127 @@ import { IS_WINDOWS, pipePath } from './platform.mjs';
 export function getAssignCallbackPipePath(sessionId = process.pid) {
   return pipePath('triflux-assign-callback', sessionId);
 }
-
-function buildAssignCallbackEvent(event = {}, row = null) {
-  const source = row || event || {};
-  const updatedAtMs = Number(source.updated_at_ms);
-  const createdAtMs = Number(source.created_at_ms);
-  const timestampMs = Number.isFinite(updatedAtMs)
-    ? updatedAtMs
-    : (Number.isFinite(createdAtMs) ? createdAtMs : Date.now());
-
-  return {
-    event: 'assign_job_status',
-    job_id: source.job_id || event.job_id || null,
-    supervisor_agent: source.supervisor_agent || null,
-    worker_agent: source.worker_agent || null,
-    topic: source.topic || null,
-    task: source.task || null,
-    status: source.status || event.status || null,
-    attempt: Number.isFinite(Number(source.attempt)) ? Number(source.attempt) : null,
-    retry_count: Number.isFinite(Number(source.retry_count)) ? Number(source.retry_count) : null,
-    max_retries: Number.isFinite(Number(source.max_retries)) ? Number(source.max_retries) : null,
-    priority: Number.isFinite(Number(source.priority)) ? Number(source.priority) : null,
-    ttl_ms: Number.isFinite(Number(source.ttl_ms)) ? Number(source.ttl_ms) : null,
-    timeout_ms: Number.isFinite(Number(source.timeout_ms)) ? Number(source.timeout_ms) : null,
-    deadline_ms: Number.isFinite(Number(source.deadline_ms)) ? Number(source.deadline_ms) : null,
-    trace_id: source.trace_id || null,
-    correlation_id: source.correlation_id || null,
-    last_message_id: source.last_message_id || null,
-    result: Object.hasOwn(source, 'result')
-      ? source.result
-      : (Object.hasOwn(event, 'result') ? event.result : null),
-    error: Object.hasOwn(source, 'error')
-      ? source.error
-      : (Object.hasOwn(event, 'error') ? event.error : null),
-    created_at_ms: Number.isFinite(createdAtMs) ? createdAtMs : null,
-    updated_at_ms: Number.isFinite(updatedAtMs) ? updatedAtMs : null,
-    started_at_ms: Number.isFinite(Number(source.started_at_ms)) ? Number(source.started_at_ms) : null,
-    completed_at_ms: Number.isFinite(Number(source.completed_at_ms)) ? Number(source.completed_at_ms) : null,
-    last_retry_at_ms: Number.isFinite(Number(source.last_retry_at_ms)) ? Number(source.last_retry_at_ms) : null,
-    timestamp: new Date(timestampMs).toISOString(),
-  };
-}
-
-export function createAssignCallbackServer({ store = null, sessionId = process.pid } = {}) {
-  const pipePath = getAssignCallbackPipePath(sessionId);
-  const clients = new Set();
-  let server = null;
-  let detachStoreListener = null;
-
-  function removeSocket(socket) {
-    if (!socket) return;
-    clients.delete(socket);
-    try { socket.destroy(); } catch {}
-  }
-
-  function broadcast(event) {
-    const frame = `${JSON.stringify(event)}\n`;
-    for (const socket of Array.from(clients)) {
-      if (!socket.writable || socket.destroyed) {
-        removeSocket(socket);
-        continue;
-      }
-      try {
-        socket.write(frame);
-      } catch {
-        removeSocket(socket);
-      }
-    }
-  }
-
-  return {
-    path: pipePath,
-    getStatus() {
-      return {
-        path: pipePath,
-        clients: clients.size,
-      };
-    },
-    async start() {
-      if (server) return { path: pipePath };
+
+function buildAssignCallbackEvent(event = {}, row = null) {
+  const source = row || event || {};
+  const updatedAtMs = Number(source.updated_at_ms);
+  const createdAtMs = Number(source.created_at_ms);
+  const timestampMs = Number.isFinite(updatedAtMs)
+    ? updatedAtMs
+    : (Number.isFinite(createdAtMs) ? createdAtMs : Date.now());
+
+  return {
+    event: 'assign_job_status',
+    job_id: source.job_id || event.job_id || null,
+    supervisor_agent: source.supervisor_agent || null,
+    worker_agent: source.worker_agent || null,
+    topic: source.topic || null,
+    task: source.task || null,
+    status: source.status || event.status || null,
+    attempt: Number.isFinite(Number(source.attempt)) ? Number(source.attempt) : null,
+    retry_count: Number.isFinite(Number(source.retry_count)) ? Number(source.retry_count) : null,
+    max_retries: Number.isFinite(Number(source.max_retries)) ? Number(source.max_retries) : null,
+    priority: Number.isFinite(Number(source.priority)) ? Number(source.priority) : null,
+    ttl_ms: Number.isFinite(Number(source.ttl_ms)) ? Number(source.ttl_ms) : null,
+    timeout_ms: Number.isFinite(Number(source.timeout_ms)) ? Number(source.timeout_ms) : null,
+    deadline_ms: Number.isFinite(Number(source.deadline_ms)) ? Number(source.deadline_ms) : null,
+    trace_id: source.trace_id || null,
+    correlation_id: source.correlation_id || null,
+    last_message_id: source.last_message_id || null,
+    result: Object.hasOwn(source, 'result')
+      ? source.result
+      : (Object.hasOwn(event, 'result') ? event.result : null),
+    error: Object.hasOwn(source, 'error')
+      ? source.error
+      : (Object.hasOwn(event, 'error') ? event.error : null),
+    created_at_ms: Number.isFinite(createdAtMs) ? createdAtMs : null,
+    updated_at_ms: Number.isFinite(updatedAtMs) ? updatedAtMs : null,
+    started_at_ms: Number.isFinite(Number(source.started_at_ms)) ? Number(source.started_at_ms) : null,
+    completed_at_ms: Number.isFinite(Number(source.completed_at_ms)) ? Number(source.completed_at_ms) : null,
+    last_retry_at_ms: Number.isFinite(Number(source.last_retry_at_ms)) ? Number(source.last_retry_at_ms) : null,
+    timestamp: new Date(timestampMs).toISOString(),
+  };
+}
+
+export function createAssignCallbackServer({ store = null, sessionId = process.pid } = {}) {
+  const pipePath = getAssignCallbackPipePath(sessionId);
+  const clients = new Set();
+  let server = null;
+  let detachStoreListener = null;
+
+  function removeSocket(socket) {
+    if (!socket) return;
+    clients.delete(socket);
+    try { socket.destroy(); } catch {}
+  }
+
+  function broadcast(event) {
+    const frame = `${JSON.stringify(event)}\n`;
+    for (const socket of Array.from(clients)) {
+      if (!socket.writable || socket.destroyed) {
+        removeSocket(socket);
+        continue;
+      }
+      try {
+        socket.write(frame);
+      } catch {
+        removeSocket(socket);
+      }
+    }
+  }
+
+  return {
+    path: pipePath,
+    getStatus() {
+      return {
+        path: pipePath,
+        clients: clients.size,
+      };
+    },
+    async start() {
+      if (server) return { path: pipePath };
       if (!IS_WINDOWS && existsSync(pipePath)) {
         try { unlinkSync(pipePath); } catch {}
       }
-
-      server = net.createServer((socket) => {
-        clients.add(socket);
-        socket.setEncoding('utf8');
-        socket.on('error', () => removeSocket(socket));
-        socket.on('close', () => removeSocket(socket));
-      });
-
-      await new Promise((resolve, reject) => {
-        server.once('error', reject);
-        server.listen(pipePath, () => {
-          server?.off('error', reject);
-          resolve();
-        });
-      });
-
-      if (store?.onAssignStatusChange && !detachStoreListener) {
-        detachStoreListener = store.onAssignStatusChange((event, row) => {
-          broadcast(buildAssignCallbackEvent(event, row));
-        });
-      }
-
-      return { path: pipePath };
-    },
-    async stop() {
-      if (detachStoreListener) {
-        try { detachStoreListener(); } catch {}
-        detachStoreListener = null;
-      }
-      if (!server) return;
-      for (const socket of Array.from(clients)) {
-        removeSocket(socket);
-      }
-      await new Promise((resolve) => server.close(resolve));
-      server = null;
+
+      server = net.createServer((socket) => {
+        clients.add(socket);
+        socket.setEncoding('utf8');
+        socket.on('error', () => removeSocket(socket));
+        socket.on('close', () => removeSocket(socket));
+      });
+
+      await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(pipePath, () => {
+          server?.off('error', reject);
+          resolve();
+        });
+      });
+
+      if (store?.onAssignStatusChange && !detachStoreListener) {
+        detachStoreListener = store.onAssignStatusChange((event, row) => {
+          broadcast(buildAssignCallbackEvent(event, row));
+        });
+      }
+
+      return { path: pipePath };
+    },
+    async stop() {
+      if (detachStoreListener) {
+        try { detachStoreListener(); } catch {}
+        detachStoreListener = null;
+      }
+      if (!server) return;
+      for (const socket of Array.from(clients)) {
+        removeSocket(socket);
+      }
+      await new Promise((resolve) => server.close(resolve));
+      server = null;
       if (!IS_WINDOWS && existsSync(pipePath)) {
         try { unlinkSync(pipePath); } catch {}
       }
-    },
-    broadcast,
-  };
-}
+    },
+    broadcast,
+  };
+}

package/hub/delegator/index.mjs

@@ -1,14 +1,14 @@
-export {
-  DELEGATOR_JOB_STATUSES,
-  DELEGATOR_MCP_SERVER_INFO,
-  DELEGATOR_MODES,
-  DELEGATOR_PIPE_ACTIONS,
-  DELEGATOR_PROVIDERS,
-  DELEGATOR_SCHEMA_URL,
-  DELEGATOR_TOOL_NAMES,
-} from './contracts.mjs';
-export { DelegatorService } from './service.mjs';
-export {
-  getDelegatorMcpToolDefinitions,
-  loadDelegatorSchemaBundle,
-} from './tool-definitions.mjs';
+export {
+  DELEGATOR_JOB_STATUSES,
+  DELEGATOR_MCP_SERVER_INFO,
+  DELEGATOR_MODES,
+  DELEGATOR_PIPE_ACTIONS,
+  DELEGATOR_PROVIDERS,
+  DELEGATOR_SCHEMA_URL,
+  DELEGATOR_TOOL_NAMES,
+} from './contracts.mjs';
+export { DelegatorService } from './service.mjs';
+export {
+  getDelegatorMcpToolDefinitions,
+  loadDelegatorSchemaBundle,
+} from './tool-definitions.mjs';

package/hub/delegator/tool-definitions.mjs

@@ -1,35 +1,35 @@
-import { readFileSync } from 'node:fs';
-
-import { DELEGATOR_SCHEMA_URL } from './contracts.mjs';
-
-let schemaBundleCache = null;
-
-function deepClone(value) {
-  if (value == null) return value;
-  return JSON.parse(JSON.stringify(value));
-}
-
-export function loadDelegatorSchemaBundle() {
-  if (schemaBundleCache) {
-    return schemaBundleCache;
-  }
-
-  schemaBundleCache = JSON.parse(readFileSync(DELEGATOR_SCHEMA_URL, 'utf8'));
-  return schemaBundleCache;
-}
-
-export function getDelegatorMcpToolDefinitions() {
-  const bundle = loadDelegatorSchemaBundle();
-  const defs = bundle.$defs || {};
-  const tools = Array.isArray(bundle['x-triflux-mcp-tools'])
-    ? bundle['x-triflux-mcp-tools']
-    : [];
-
-  return tools.map((tool) => ({
-    name: tool.name,
-    description: tool.description,
-    inputSchema: deepClone(defs[tool.inputSchemaDef]),
-    outputSchema: deepClone(defs[tool.outputSchemaDef]),
-    pipeAction: tool.pipeAction,
-  }));
-}
+import { readFileSync } from 'node:fs';
+
+import { DELEGATOR_SCHEMA_URL } from './contracts.mjs';
+
+let schemaBundleCache = null;
+
+function deepClone(value) {
+  if (value == null) return value;
+  return JSON.parse(JSON.stringify(value));
+}
+
+export function loadDelegatorSchemaBundle() {
+  if (schemaBundleCache) {
+    return schemaBundleCache;
+  }
+
+  schemaBundleCache = JSON.parse(readFileSync(DELEGATOR_SCHEMA_URL, 'utf8'));
+  return schemaBundleCache;
+}
+
+export function getDelegatorMcpToolDefinitions() {
+  const bundle = loadDelegatorSchemaBundle();
+  const defs = bundle.$defs || {};
+  const tools = Array.isArray(bundle['x-triflux-mcp-tools'])
+    ? bundle['x-triflux-mcp-tools']
+    : [];
+
+  return tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: deepClone(defs[tool.inputSchemaDef]),
+    outputSchema: deepClone(defs[tool.outputSchemaDef]),
+    pipeAction: tool.pipeAction,
+  }));
+}

package/hub/hitl.mjs

@@ -1,143 +1,143 @@
-// hub/hitl.mjs — Human-in-the-Loop 매니저
-// 사용자 입력 요청/응답, 타임아웃 자동 처리
-
-/**
- * HITL 매니저 생성
- * @param {object} store — createStore() 반환 객체
- * @param {object} router — createRouter() 반환 객체
- */
-export function createHitlManager(store, router = null) {
-  function forwardHumanResponse({ requesterAgent, requestId, action, content, submittedBy, correlationId, traceId, priority }) {
-    if (!router?.handlePublish) {
-      throw new Error('router.handlePublish is required for HITL forwarding');
-    }
-    return router.handlePublish({
-      from: 'hub:hitl',
-      to: requesterAgent,
-      topic: 'human.response',
-      priority,
-      ttl_ms: 300000,
-      payload: { request_id: requestId, action, content, submitted_by: submittedBy },
-      correlation_id: correlationId,
-      trace_id: traceId,
-      message_type: 'human_response',
-    });
-  }
-
-  return {
-    /**
-     * 사용자에게 입력 요청 생성
-     * 터미널에 알림 출력 후 pending 상태로 저장
-     */
-    requestHumanInput({
-      requester_agent, kind, prompt, requested_schema = {},
-      deadline_ms, default_action, channel_preference = 'terminal',
-      correlation_id, trace_id,
-    }) {
-      const result = store.insertHumanRequest({
-        requester_agent, kind, prompt, requested_schema,
-        deadline_ms, default_action,
-        correlation_id, trace_id,
-      });
-
-      // 터미널 알림 (stderr — stdout은 MCP 용)
-      const kindLabel = { captcha: 'CAPTCHA', approval: '승인', credential: '자격증명', choice: '선택', text: '텍스트' };
-      process.stderr.write(
-        `\n[tfx-hub] 사용자 입력 요청 (${kindLabel[kind] || kind})\n` +
-        `  요청자: ${requester_agent}\n` +
-        `  내용: ${prompt}\n` +
-        `  ID: ${result.request_id}\n` +
-        `  제한: ${Math.round(deadline_ms / 1000)}초\n\n`,
-      );
-
-      return { ok: true, data: result };
-    },
-
-    /**
-     * 사용자 입력 응답 제출
-     * 유효성 검증 → 상태 업데이트 → 요청자에게 응답 메시지 전달
-     */
-    submitHumanInput({ request_id, action, content = null, submitted_by = 'human' }) {
-      // 요청 조회
-      const hr = store.getHumanRequest(request_id);
-      if (!hr) {
-        return { ok: false, error: { code: 'NOT_FOUND', message: `요청 없음: ${request_id}` } };
-      }
-      if (hr.state !== 'pending') {
-        return { ok: false, error: { code: 'ALREADY_HANDLED', message: `이미 처리됨: ${hr.state}` } };
-      }
-
-      // 상태 매핑
-      const stateMap = { accept: 'accepted', decline: 'declined', cancel: 'cancelled' };
-      const newState = stateMap[action];
-      if (!newState) {
-        return { ok: false, error: { code: 'INVALID_ACTION', message: `잘못된 action: ${action}` } };
-      }
-
-      // DB 업데이트
-      store.updateHumanRequest(request_id, newState, content);
-
-      // 요청자에게 응답 메시지 전달
-      let forwardedMessageId = null;
-      if (action === 'accept' || action === 'decline') {
-        const published = forwardHumanResponse({
-          requesterAgent: hr.requester_agent,
-          requestId: request_id,
-          action,
-          content,
-          submittedBy: submitted_by,
-          correlationId: hr.correlation_id,
-          traceId: hr.trace_id,
-          priority: 7,
-        });
-        forwardedMessageId = published.data?.message_id || null;
-      }
-
-      return {
-        ok: true,
-        data: { request_id, new_state: newState, forwarded_message_id: forwardedMessageId },
-      };
-    },
-
-    /**
-     * 만료된 요청 자동 처리
-     * deadline 초과 시 default_action 적용
-     */
-    checkTimeouts() {
-      const pending = store.getPendingHumanRequests();
-      const now = Date.now();
-      const expired = pending.filter(hr => hr.deadline_ms <= now);
-      if (!expired.length) return 0;
-
-      const expireRequests = () => {
-        for (const hr of expired) {
-          store.updateHumanRequest(hr.request_id, 'timed_out', null);
-          if (hr.default_action === 'timeout_continue') {
-            forwardHumanResponse({
-              requesterAgent: hr.requester_agent,
-              requestId: hr.request_id,
-              action: 'timeout_continue',
-              content: null,
-              submittedBy: 'system',
-              correlationId: hr.correlation_id,
-              traceId: hr.trace_id,
-              priority: 5,
-            });
-          }
-        }
-        return expired.length;
-      };
-
-      const processExpired = store.db?.transaction
-        ? store.db.transaction(expireRequests)
-        : expireRequests;
-
-      return processExpired();
-    },
-
-    /** 대기 중인 요청 목록 */
-    getPendingRequests() {
-      return store.getPendingHumanRequests();
-    },
-  };
-}
+// hub/hitl.mjs — Human-in-the-Loop 매니저
+// 사용자 입력 요청/응답, 타임아웃 자동 처리
+
+/**
+ * HITL 매니저 생성
+ * @param {object} store — createStore() 반환 객체
+ * @param {object} router — createRouter() 반환 객체
+ */
+export function createHitlManager(store, router = null) {
+  function forwardHumanResponse({ requesterAgent, requestId, action, content, submittedBy, correlationId, traceId, priority }) {
+    if (!router?.handlePublish) {
+      throw new Error('router.handlePublish is required for HITL forwarding');
+    }
+    return router.handlePublish({
+      from: 'hub:hitl',
+      to: requesterAgent,
+      topic: 'human.response',
+      priority,
+      ttl_ms: 300000,
+      payload: { request_id: requestId, action, content, submitted_by: submittedBy },
+      correlation_id: correlationId,
+      trace_id: traceId,
+      message_type: 'human_response',
+    });
+  }
+
+  return {
+    /**
+     * 사용자에게 입력 요청 생성
+     * 터미널에 알림 출력 후 pending 상태로 저장
+     */
+    requestHumanInput({
+      requester_agent, kind, prompt, requested_schema = {},
+      deadline_ms, default_action, channel_preference = 'terminal',
+      correlation_id, trace_id,
+    }) {
+      const result = store.insertHumanRequest({
+        requester_agent, kind, prompt, requested_schema,
+        deadline_ms, default_action,
+        correlation_id, trace_id,
+      });
+
+      // 터미널 알림 (stderr — stdout은 MCP 용)
+      const kindLabel = { captcha: 'CAPTCHA', approval: '승인', credential: '자격증명', choice: '선택', text: '텍스트' };
+      process.stderr.write(
+        `\n[tfx-hub] 사용자 입력 요청 (${kindLabel[kind] || kind})\n` +
+        `  요청자: ${requester_agent}\n` +
+        `  내용: ${prompt}\n` +
+        `  ID: ${result.request_id}\n` +
+        `  제한: ${Math.round(deadline_ms / 1000)}초\n\n`,
+      );
+
+      return { ok: true, data: result };
+    },
+
+    /**
+     * 사용자 입력 응답 제출
+     * 유효성 검증 → 상태 업데이트 → 요청자에게 응답 메시지 전달
+     */
+    submitHumanInput({ request_id, action, content = null, submitted_by = 'human' }) {
+      // 요청 조회
+      const hr = store.getHumanRequest(request_id);
+      if (!hr) {
+        return { ok: false, error: { code: 'NOT_FOUND', message: `요청 없음: ${request_id}` } };
+      }
+      if (hr.state !== 'pending') {
+        return { ok: false, error: { code: 'ALREADY_HANDLED', message: `이미 처리됨: ${hr.state}` } };
+      }
+
+      // 상태 매핑
+      const stateMap = { accept: 'accepted', decline: 'declined', cancel: 'cancelled' };
+      const newState = stateMap[action];
+      if (!newState) {
+        return { ok: false, error: { code: 'INVALID_ACTION', message: `잘못된 action: ${action}` } };
+      }
+
+      // DB 업데이트
+      store.updateHumanRequest(request_id, newState, content);
+
+      // 요청자에게 응답 메시지 전달
+      let forwardedMessageId = null;
+      if (action === 'accept' || action === 'decline') {
+        const published = forwardHumanResponse({
+          requesterAgent: hr.requester_agent,
+          requestId: request_id,
+          action,
+          content,
+          submittedBy: submitted_by,
+          correlationId: hr.correlation_id,
+          traceId: hr.trace_id,
+          priority: 7,
+        });
+        forwardedMessageId = published.data?.message_id || null;
+      }
+
+      return {
+        ok: true,
+        data: { request_id, new_state: newState, forwarded_message_id: forwardedMessageId },
+      };
+    },
+
+    /**
+     * 만료된 요청 자동 처리
+     * deadline 초과 시 default_action 적용
+     */
+    checkTimeouts() {
+      const pending = store.getPendingHumanRequests();
+      const now = Date.now();
+      const expired = pending.filter(hr => hr.deadline_ms <= now);
+      if (!expired.length) return 0;
+
+      const expireRequests = () => {
+        for (const hr of expired) {
+          store.updateHumanRequest(hr.request_id, 'timed_out', null);
+          if (hr.default_action === 'timeout_continue') {
+            forwardHumanResponse({
+              requesterAgent: hr.requester_agent,
+              requestId: hr.request_id,
+              action: 'timeout_continue',
+              content: null,
+              submittedBy: 'system',
+              correlationId: hr.correlation_id,
+              traceId: hr.trace_id,
+              priority: 5,
+            });
+          }
+        }
+        return expired.length;
+      };
+
+      const processExpired = store.db?.transaction
+        ? store.db.transaction(expireRequests)
+        : expireRequests;
+
+      return processExpired();
+    },
+
+    /** 대기 중인 요청 목록 */
+    getPendingRequests() {
+      return store.getPendingHumanRequests();
+    },
+  };
+}