@triflux/remote 10.0.0-alpha.1

package/hub/team/orchestrator.mjs

@@ -0,0 +1,161 @@
+// hub/team/orchestrator.mjs — 작업 분배 + 프롬프트 구성
+// 의존성: pane.mjs만 사용
+import { injectPrompt } from "./pane.mjs";
+
+/**
+ * 작업 분해 (LLM 없이 구분자 기반)
+ * @param {string} taskDescription — 전체 작업 설명
+ * @param {number} agentCount — 에이전트 수
+ * @returns {string[]} 각 에이전트의 서브태스크
+ */
+export function decomposeTask(taskDescription, agentCount) {
+  if (agentCount <= 0) return [];
+  if (agentCount === 1) return [taskDescription];
+
+  // '+', ',', '\n' 기준으로 분리
+  const parts = taskDescription
+    .split(/[+,\n]+/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+  if (parts.length === 0) return [taskDescription];
+
+  // 에이전트보다 서브태스크가 적으면 마지막 에이전트에 전체 태스크 부여
+  if (parts.length < agentCount) {
+    const result = [...parts];
+    while (result.length < agentCount) {
+      result.push(taskDescription);
+    }
+    return result;
+  }
+
+  // 에이전트보다 서브태스크가 많으면 앞에서부터 N개, 나머지는 마지막에 합침
+  if (parts.length > agentCount) {
+    const result = parts.slice(0, agentCount - 1);
+    result.push(parts.slice(agentCount - 1).join(" + "));
+    return result;
+  }
+
+  return parts;
+}
+
+/**
+ * 리드(보통 claude) 초기 프롬프트 생성
+ * @param {string} taskDescription
+ * @param {object} config
+ * @param {string} config.agentId
+ * @param {string} config.hubUrl
+ * @param {string} config.teammateMode
+ * @param {Array<{agentId:string, cli:string, subtask:string}>} config.workers
+ * @returns {string}
+ */
+export function buildLeadPrompt(taskDescription, config) {
+  const { agentId, hubUrl, teammateMode = "tmux", workers = [] } = config;
+
+  const roster = workers
+    .map((w, i) => `${i + 1}. ${w.agentId} (${w.cli}) — ${w.subtask}`)
+    .join("\n") || "- (워커 없음)";
+
+  const workerIds = workers.map((w) => w.agentId).join(", ");
+
+  const bridgePath = "node hub/bridge.mjs";
+
+  return `리드 에이전트: ${agentId}
+
+목표: ${taskDescription}
+모드: ${teammateMode}
+
+워커:
+${roster}
+
+규칙:
+- 가능한 짧고 핵심만 지시/요약(토큰 절약)
+- 워커 제어:
+  ${bridgePath} result --agent ${agentId} --topic lead.control
+- 워커 결과 수집:
+  ${bridgePath} context --agent ${agentId} --max 20
+- 최종 결과는 topic="task.result"를 모아 통합
+
+워커 ID: ${workerIds || "(없음)"}
+지금 즉시 워커를 배정하고 병렬 진행을 관리하라.`;
+}
+
+/**
+ * 워커 초기 프롬프트 생성
+ * @param {string} subtask — 이 에이전트의 서브태스크
+ * @param {object} config
+ * @param {string} config.cli — codex/gemini/claude
+ * @param {string} config.agentId — 에이전트 식별자
+ * @param {string} config.hubUrl — Hub URL
+ * @returns {string}
+ */
+export function buildPrompt(subtask, config) {
+  const { cli, agentId, hubUrl } = config;
+
+  const hubBase = hubUrl.replace("/mcp", "");
+
+  const bridgePath = "node hub/bridge.mjs";
+
+  return `워커: ${agentId} (${cli})
+작업: ${subtask}
+
+필수 규칙:
+1) 간결하게 작업(불필요한 장문 설명 금지)
+2) 시작 즉시 등록:
+   ${bridgePath} register --agent ${agentId} --cli ${cli} --topics lead.control,task.result
+3) 주기적으로 수신함 확인:
+   ${bridgePath} context --agent ${agentId} --max 10
+4) lead.control 수신 시 즉시 반응 (interrupt/stop/pause/resume)
+5) 완료 시 결과 발행:
+   ${bridgePath} result --agent ${agentId} --topic task.result --file <출력파일>
+
+지금 작업을 시작하라.`;
+}
+
+/**
+ * 팀 오케스트레이션 실행 — 각 pane에 프롬프트 주입
+ * @param {string} sessionName — tmux 세션 이름
+ * @param {Array<{target: string, cli: string, subtask: string}>} assignments
+ * @param {object} opts
+ * @param {string} opts.hubUrl — Hub URL
+ * @param {{target:string, cli:string, task:string}|null} opts.lead
+ * @param {string} opts.teammateMode
+ * @returns {Promise<void>}
+ */
+export async function orchestrate(sessionName, assignments, opts = {}) {
+  const {
+    hubUrl = "http://127.0.0.1:27888/mcp",
+    lead = null,
+    teammateMode = "tmux",
+  } = opts;
+
+  const workers = assignments.map(({ target, cli, subtask }) => ({
+    target,
+    cli,
+    subtask,
+    agentId: `${cli}-${target.split(".").pop()}`,
+  }));
+
+  if (lead?.target) {
+    const leadAgentId = `${lead.cli || "claude"}-${lead.target.split(".").pop()}`;
+    const leadPrompt = buildLeadPrompt(lead.task || "팀 작업 조율", {
+      agentId: leadAgentId,
+      hubUrl,
+      teammateMode,
+      workers: workers.map((w) => ({ agentId: w.agentId, cli: w.cli, subtask: w.subtask })),
+    });
+    injectPrompt(lead.target, leadPrompt, { useFileRef: true });
+    await new Promise((r) => setTimeout(r, 100));
+  }
+
+  for (const worker of workers) {
+    const prompt = buildPrompt(worker.subtask, {
+      cli: worker.cli,
+      agentId: worker.agentId,
+      hubUrl,
+      sessionName,
+    });
+    injectPrompt(worker.target, prompt, { useFileRef: true });
+    await new Promise((r) => setTimeout(r, 100));
+  }
+}

package/hub/team/pane.mjs

@@ -0,0 +1,153 @@
+// hub/team/pane.mjs — pane별 CLI 실행 + stdin 주입
+// 의존성: child_process, fs, os, path (Node.js 내장)만 사용
+import { writeFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { detectMultiplexer, tmuxExec } from "./session.mjs";
+import { psmuxExec } from "./psmux.mjs";
+
+import { buildExecArgs } from "../codex-adapter.mjs";
+
+function quoteArg(value) {
+  return `"${String(value).replace(/"/g, '\\"')}"`;
+}
+
+function getPsmuxSessionName(target) {
+  return String(target).split(":")[0]?.trim() || "";
+}
+
+/** Windows 경로를 멀티플렉서용 경로로 변환 */
+function toMuxPath(p) {
+  if (process.platform !== "win32") return p;
+
+  const mux = detectMultiplexer();
+
+  // psmux는 Windows 네이티브 경로 그대로 사용
+  if (mux === "psmux") return p;
+
+  const normalized = p.replace(/\\/g, "/");
+  const m = normalized.match(/^([A-Za-z]):\/(.*)$/);
+  if (!m) return normalized;
+
+  const drive = m[1].toLowerCase();
+  const rest = m[2];
+
+  // wsl tmux는 /mnt/c/... 경로를 사용
+  if (mux === "wsl-tmux") {
+    return `/mnt/${drive}/${rest}`;
+  }
+
+  // Git Bash/MSYS tmux는 /c/... 경로를 사용
+  return `/${drive}/${rest}`;
+}
+
+/** 멀티플렉서 커맨드 실행 (session.mjs와 동일 패턴) */
+function muxExec(args, opts = {}) {
+  const exec = detectMultiplexer() === "psmux" ? psmuxExec : tmuxExec;
+  return exec(args, {
+    encoding: "utf8",
+    timeout: 10000,
+    stdio: ["pipe", "pipe", "pipe"],
+    windowsHide: true,
+    ...opts,
+  });
+}
+
+/**
+ * CLI 에이전트 시작 커맨드 생성
+ * @param {'codex'|'gemini'|'claude'} cli
+ * @param {{ trustMode?: boolean }} [options]
+ * @returns {string} 실행할 셸 커맨드
+ */
+export function buildCliCommand(cli, options = {}) {
+  const { trustMode = false } = options;
+
+  switch (cli) {
+    case "codex":
+      // trust 모드에서는 exec 서브커맨드 기반 명령을 사용
+      if (trustMode) {
+        return buildExecArgs({});
+      }
+      return "codex";
+    case "gemini":
+      // interactive 모드 — MCP는 ~/.gemini/settings.json에 사전 등록
+      return "gemini";
+    case "claude":
+      // interactive 모드
+      return "claude";
+    default:
+      return cli; // 커스텀 CLI 허용
+  }
+}
+
+/**
+ * pane에 CLI 시작
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} command — 실행할 커맨드
+ */
+export function startCliInPane(target, command) {
+  // CLI 시작도 buffer paste를 재사용해 셸/플랫폼별 quoting 차이를 제거한다.
+  injectPrompt(target, command);
+}
+
+/**
+ * pane에 프롬프트 주입 (load-buffer + paste-buffer 방식)
+ * 멀티라인 + 특수문자 안전, 크기 제한 없음
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} prompt — 주입할 텍스트
+ */
+/**
+ * pane에 프롬프트 주입
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} prompt — 주입할 텍스트
+ * @param {object} [opts]
+ * @param {boolean} [opts.useFileRef] — true면 TUI용 @file 참조 방식 (psmux 전용)
+ */
+export function injectPrompt(target, prompt, { useFileRef = false } = {}) {
+  const tmpDir = join(tmpdir(), "tfx-multi");
+  mkdirSync(tmpDir, { recursive: true });
+
+  const safeTarget = target.replace(/[:.]/g, "-");
+  const tmpFile = join(tmpDir, `prompt-${safeTarget}-${Date.now()}.txt`);
+
+  // psmux + TUI 앱: @file 참조로 주입 (paste-buffer는 TUI와 호환 안 됨)
+  if (detectMultiplexer() === "psmux" && useFileRef) {
+    writeFileSync(tmpFile, prompt, "utf8");
+    const filePath = tmpFile.replace(/\\/g, "/");
+    psmuxExec(["select-pane", "-t", target]);
+    psmuxExec(["send-keys", "-t", target, "-l", `@${filePath}`]);
+    psmuxExec(["send-keys", "-t", target, "Enter"]);
+    // TUI가 파일을 읽을 시간을 주고 정리
+    setTimeout(() => { try { unlinkSync(tmpFile); } catch {} }, 10000);
+    return;
+  }
+
+  try {
+    writeFileSync(tmpFile, prompt, "utf8");
+
+    if (detectMultiplexer() === "psmux") {
+      const sessionName = getPsmuxSessionName(target);
+      psmuxExec(["load-buffer", "-t", sessionName, toMuxPath(tmpFile)]);
+      psmuxExec(["select-pane", "-t", target]);
+      psmuxExec(["paste-buffer", "-t", target]);
+      psmuxExec(["send-keys", "-t", target, "Enter"]);
+      return;
+    }
+
+    // tmux load-buffer → paste-buffer → Enter
+    muxExec(`load-buffer ${quoteArg(toMuxPath(tmpFile))}`);
+    muxExec(`paste-buffer -t ${target}`);
+    muxExec(`send-keys -t ${target} Enter`);
+  } finally {
+    try { unlinkSync(tmpFile); } catch {}
+  }
+}
+
+/**
+ * pane에 키 입력 전송
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} keys — tmux 키 표현 (예: 'C-c', 'Enter')
+ */
+export function sendKeys(target, keys) {
+  muxExec(`send-keys -t ${target} ${keys}`);
+}