@triflux/core 10.51.0 → 10.52.0

package/hub/delegator/schema/delegator-tools.schema.json

@@ -1,250 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://triflux.dev/schema/hub/delegator-tools.schema.json",
-  "title": "Triflux Delegator MCP Tool Schemas",
-  "$defs": {
-    "Provider": {
-      "type": "string",
-      "enum": ["auto", "codex", "antigravity", "gemini"]
-    },
-    "Mode": {
-      "type": "string",
-      "enum": ["sync", "async"]
-    },
-    "JobStatus": {
-      "type": "string",
-      "enum": ["queued", "running", "waiting_reply", "completed", "failed"]
-    },
-    "McpProfile": {
-      "type": "string",
-      "enum": [
-        "auto",
-        "default",
-        "executor",
-        "designer",
-        "explore",
-        "reviewer",
-        "writer",
-        "none",
-        "implement",
-        "analyze",
-        "review",
-        "docs",
-        "minimal"
-      ]
-    },
-    "SearchTool": {
-      "type": "string",
-      "enum": ["exa", "brave-search", "tavily"]
-    },
-    "NullableDateTime": {
-      "type": ["string", "null"],
-      "format": "date-time"
-    },
-    "NullableString": {
-      "type": ["string", "null"]
-    },
-    "DelegateInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["prompt"],
-      "properties": {
-        "prompt": {
-          "type": "string",
-          "minLength": 1
-        },
-        "provider": {
-          "$ref": "#/$defs/Provider",
-          "default": "auto"
-        },
-        "mode": {
-          "$ref": "#/$defs/Mode",
-          "default": "sync"
-        },
-        "agent_type": {
-          "type": "string",
-          "default": "executor",
-          "minLength": 1
-        },
-        "cwd": {
-          "type": "string",
-          "minLength": 1
-        },
-        "timeout_ms": {
-          "type": "integer",
-          "minimum": 1
-        },
-        "session_key": {
-          "type": "string",
-          "minLength": 1
-        },
-        "thread_id": {
-          "type": "string",
-          "minLength": 1
-        },
-        "reset_session": {
-          "type": "boolean",
-          "default": false
-        },
-        "mcp_profile": {
-          "$ref": "#/$defs/McpProfile",
-          "default": "auto"
-        },
-        "search_tool": {
-          "$ref": "#/$defs/SearchTool"
-        },
-        "context_file": {
-          "type": "string",
-          "minLength": 1
-        },
-        "model": {
-          "type": "string",
-          "minLength": 1
-        },
-        "developer_instructions": {
-          "type": "string",
-          "minLength": 1
-        },
-        "compact_prompt": {
-          "type": "string",
-          "minLength": 1
-        }
-      }
-    },
-    "DelegateReplyInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["job_id", "reply"],
-      "properties": {
-        "job_id": {
-          "type": "string",
-          "minLength": 1
-        },
-        "reply": {
-          "type": "string",
-          "minLength": 1
-        },
-        "done": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "StatusInput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["job_id"],
-      "properties": {
-        "job_id": {
-          "type": "string",
-          "minLength": 1
-        }
-      }
-    },
-    "DelegateOutput": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": [
-        "ok",
-        "job_id",
-        "status",
-        "mode",
-        "provider_requested",
-        "provider_resolved",
-        "agent_type",
-        "transport",
-        "created_at",
-        "started_at",
-        "updated_at",
-        "completed_at",
-        "thread_id",
-        "session_key",
-        "conversation_open"
-      ],
-      "properties": {
-        "ok": {
-          "type": "boolean"
-        },
-        "job_id": {
-          "type": "string",
-          "minLength": 1
-        },
-        "status": {
-          "$ref": "#/$defs/JobStatus"
-        },
-        "mode": {
-          "$ref": "#/$defs/Mode"
-        },
-        "provider_requested": {
-          "$ref": "#/$defs/Provider"
-        },
-        "provider_resolved": {
-          "type": ["string", "null"]
-        },
-        "agent_type": {
-          "type": "string",
-          "minLength": 1
-        },
-        "transport": {
-          "type": "string",
-          "minLength": 1
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date-time"
-        },
-        "started_at": {
-          "$ref": "#/$defs/NullableDateTime"
-        },
-        "updated_at": {
-          "type": "string",
-          "format": "date-time"
-        },
-        "completed_at": {
-          "$ref": "#/$defs/NullableDateTime"
-        },
-        "output": {
-          "type": "string"
-        },
-        "stderr": {
-          "type": "string"
-        },
-        "error": {
-          "type": "string"
-        },
-        "thread_id": {
-          "$ref": "#/$defs/NullableString"
-        },
-        "session_key": {
-          "$ref": "#/$defs/NullableString"
-        },
-        "conversation_open": {
-          "type": "boolean"
-        }
-      }
-    }
-  },
-  "x-triflux-mcp-tools": [
-    {
-      "name": "delegate",
-      "description": "Create a new delegator job and optionally wait for the first result.",
-      "inputSchemaDef": "DelegateInput",
-      "outputSchemaDef": "DelegateOutput",
-      "pipeAction": "delegator_delegate"
-    },
-    {
-      "name": "delegate-reply",
-      "description": "Send a follow-up reply into an existing delegator conversation job.",
-      "inputSchemaDef": "DelegateReplyInput",
-      "outputSchemaDef": "DelegateOutput",
-      "pipeAction": "delegator_reply"
-    },
-    {
-      "name": "status",
-      "description": "Read the latest snapshot for an existing delegator job.",
-      "inputSchemaDef": "StatusInput",
-      "outputSchemaDef": "DelegateOutput",
-      "pipeAction": "delegator_status"
-    }
-  ]
-}

package/hub/delegator/service.mjs

@@ -1,336 +0,0 @@
-import { randomUUID } from "node:crypto";
-
-import {
-  DELEGATOR_JOB_STATUSES,
-  DELEGATOR_MODES,
-  DELEGATOR_PROVIDERS,
-} from "./contracts.mjs";
-import { getDelegatorMcpToolDefinitions } from "./tool-definitions.mjs";
-
-function deepClone(value) {
-  if (value == null) return value;
-  return JSON.parse(JSON.stringify(value));
-}
-
-function assertKnown(enumValues, value, fieldName) {
-  if (value == null) return;
-  if (!enumValues.includes(value)) {
-    throw new Error(`Unsupported ${fieldName}: ${value}`);
-  }
-}
-
-function normalizeProvider(provider = "auto") {
-  const value = provider || "auto";
-  return value === "gemini" ? "antigravity" : value;
-}
-
-export class DelegatorService {
-  constructor({
-    idFactory = randomUUID,
-    now = () => new Date(),
-    worker = null,
-  } = {}) {
-    this.idFactory = idFactory;
-    this.now = now;
-    this.jobs = new Map();
-    this.worker = worker;
-    this._workerJobMap = new Map();
-  }
-
-  listToolDefinitions() {
-    return getDelegatorMcpToolDefinitions();
-  }
-
-  createJobSnapshot(input = {}) {
-    const timestamp = this.now().toISOString();
-    const jobId = input.job_id || this.idFactory();
-    const mode = input.mode || "sync";
-    const providerRequested = normalizeProvider(input.provider);
-
-    assertKnown(DELEGATOR_MODES, mode, "mode");
-    assertKnown(DELEGATOR_PROVIDERS, providerRequested, "provider");
-
-    return {
-      ok: true,
-      job_id: jobId,
-      status: "queued",
-      mode,
-      provider_requested: providerRequested,
-      provider_resolved: null,
-      agent_type: input.agent_type || "executor",
-      transport: "resident-pending",
-      created_at: timestamp,
-      started_at: null,
-      updated_at: timestamp,
-      completed_at: null,
-      output: "",
-      stderr: "",
-      error: "",
-      thread_id: input.thread_id || null,
-      session_key: input.session_key || null,
-      conversation_open: false,
-    };
-  }
-
-  recordJob(snapshot) {
-    if (!snapshot?.job_id) {
-      throw new Error("job_id is required");
-    }
-    assertKnown(DELEGATOR_JOB_STATUSES, snapshot.status, "status");
-    this.jobs.set(snapshot.job_id, deepClone(snapshot));
-    return this.getStatusSnapshot(snapshot.job_id);
-  }
-
-  getStatusSnapshot(jobId) {
-    const snapshot = this.jobs.get(jobId);
-    return snapshot ? deepClone(snapshot) : null;
-  }
-
-  // -- 필드 정규화 헬퍼 --
-
-  _normalizeInput(input = {}) {
-    return {
-      prompt: input.prompt,
-      provider: normalizeProvider(input.provider),
-      mode: input.mode || "sync",
-      agent_type: input.agent_type || input.agentType || "executor",
-      cwd: input.cwd || null,
-      timeout_ms: input.timeout_ms || input.timeoutMs || null,
-      session_key: input.session_key || input.sessionKey || null,
-      thread_id: input.thread_id || input.threadId || null,
-      reset_session: input.reset_session ?? input.resetSession ?? false,
-      mcp_profile: input.mcp_profile || input.mcpProfile || "auto",
-      search_tool: input.search_tool || input.searchTool || null,
-      context_file: input.context_file || input.contextFile || null,
-      model: input.model || null,
-      developer_instructions:
-        input.developer_instructions || input.developerInstructions || null,
-      compact_prompt: input.compact_prompt || input.compactPrompt || null,
-    };
-  }
-
-  _toWorkerArgs(normalized) {
-    return {
-      prompt: normalized.prompt,
-      provider: normalized.provider,
-      mode: normalized.mode,
-      agentType: normalized.agent_type,
-      cwd: normalized.cwd,
-      timeoutMs: normalized.timeout_ms,
-      sessionKey: normalized.session_key,
-      threadId: normalized.thread_id,
-      resetSession: normalized.reset_session,
-      mcpProfile: normalized.mcp_profile,
-      searchTool: normalized.search_tool,
-      contextFile: normalized.context_file,
-      model: normalized.model,
-      developerInstructions: normalized.developer_instructions,
-      compactPrompt: normalized.compact_prompt,
-    };
-  }
-
-  _applyWorkerResult(jobId, workerResult) {
-    const snapshot = this.jobs.get(jobId);
-    if (!snapshot) return null;
-
-    const timestamp = this.now().toISOString();
-    const ok = workerResult.ok !== false;
-
-    snapshot.ok = ok;
-    snapshot.status = workerResult.status || (ok ? "completed" : "failed");
-    snapshot.provider_resolved =
-      workerResult.providerResolved || workerResult.provider_resolved || null;
-    snapshot.transport = workerResult.transport || snapshot.transport;
-    snapshot.output = workerResult.output || "";
-    snapshot.stderr = workerResult.stderr || "";
-    snapshot.error = workerResult.error || "";
-    snapshot.thread_id =
-      workerResult.threadId || workerResult.thread_id || null;
-    snapshot.session_key =
-      workerResult.sessionKey || workerResult.session_key || null;
-    snapshot.conversation_open =
-      workerResult.conversationOpen ?? workerResult.conversation_open ?? false;
-    snapshot.started_at = snapshot.started_at || timestamp;
-    snapshot.updated_at = timestamp;
-    if (snapshot.status === "completed" || snapshot.status === "failed") {
-      snapshot.completed_at = timestamp;
-    }
-
-    this.jobs.set(jobId, deepClone(snapshot));
-    return deepClone(snapshot);
-  }
-
-  _failJob(jobId, error) {
-    const snapshot = this.jobs.get(jobId);
-    if (snapshot) {
-      const timestamp = this.now().toISOString();
-      snapshot.ok = false;
-      snapshot.status = "failed";
-      snapshot.error = error;
-      snapshot.updated_at = timestamp;
-      snapshot.completed_at = timestamp;
-      this.jobs.set(jobId, deepClone(snapshot));
-      return deepClone(snapshot);
-    }
-    return this._errorSnapshot(jobId, error);
-  }
-
-  _errorSnapshot(jobId, error) {
-    const timestamp = this.now().toISOString();
-    return {
-      ok: false,
-      job_id: jobId || "unknown",
-      status: "failed",
-      mode: "sync",
-      provider_requested: "auto",
-      provider_resolved: null,
-      agent_type: "executor",
-      transport: "resident-pending",
-      created_at: timestamp,
-      started_at: null,
-      updated_at: timestamp,
-      completed_at: timestamp,
-      output: "",
-      stderr: "",
-      error,
-      thread_id: null,
-      session_key: null,
-      conversation_open: false,
-    };
-  }
-
-  // -- 위임/응답/상태 메서드 --
-
-  async delegate(input = {}) {
-    const normalized = this._normalizeInput(input);
-
-    if (
-      !normalized.prompt ||
-      typeof normalized.prompt !== "string" ||
-      !normalized.prompt.trim()
-    ) {
-      return this._errorSnapshot(null, "prompt is required");
-    }
-
-    const snapshot = this.createJobSnapshot(normalized);
-    this.recordJob(snapshot);
-
-    if (!this.worker) {
-      return this._failJob(snapshot.job_id, "worker가 설정되지 않았습니다");
-    }
-
-    const workerArgs = this._toWorkerArgs(normalized);
-
-    try {
-      const workerResult = await this.worker.delegate(workerArgs, null);
-
-      // worker job ID 매핑 (reply/status에서 사용)
-      const workerJobId = workerResult.jobId || workerResult.job_id;
-      if (workerJobId) {
-        this._workerJobMap.set(snapshot.job_id, workerJobId);
-      }
-
-      return this._applyWorkerResult(snapshot.job_id, workerResult);
-    } catch (err) {
-      return this._failJob(
-        snapshot.job_id,
-        err instanceof Error ? err.message : String(err),
-      );
-    }
-  }
-
-  async reply(input = {}) {
-    const jobId = input.job_id || input.jobId;
-    if (!jobId) {
-      return this._errorSnapshot("unknown", "job_id is required");
-    }
-
-    const snapshot = this.jobs.get(jobId);
-    if (!snapshot) {
-      return this._errorSnapshot(jobId, "job not found");
-    }
-
-    if (!snapshot.conversation_open) {
-      return this._failJob(jobId, "conversation is not open");
-    }
-
-    if (!this.worker) {
-      return this._failJob(jobId, "worker가 설정되지 않았습니다");
-    }
-
-    const workerJobId = this._workerJobMap.get(jobId);
-    if (!workerJobId) {
-      return this._failJob(jobId, "worker job 매핑을 찾을 수 없습니다");
-    }
-
-    try {
-      const workerResult = await this.worker.reply(
-        {
-          job_id: workerJobId,
-          reply: input.reply,
-          done: input.done ?? false,
-        },
-        null,
-      );
-
-      return this._applyWorkerResult(jobId, workerResult);
-    } catch (err) {
-      return this._failJob(
-        jobId,
-        err instanceof Error ? err.message : String(err),
-      );
-    }
-  }
-
-  async status({ job_id: jobId, jobId: jobIdAlias } = {}) {
-    const resolvedId = jobId || jobIdAlias;
-    const snapshot = this.getStatusSnapshot(resolvedId);
-
-    if (!snapshot) {
-      const timestamp = this.now().toISOString();
-      return {
-        ok: false,
-        job_id: resolvedId || "unknown-job",
-        status: "failed",
-        mode: "async",
-        provider_requested: "auto",
-        provider_resolved: null,
-        agent_type: "executor",
-        transport: "resident-pending",
-        created_at: timestamp,
-        started_at: null,
-        updated_at: timestamp,
-        completed_at: null,
-        output: "",
-        stderr: "",
-        error: "job not found",
-        thread_id: null,
-        session_key: null,
-        conversation_open: false,
-      };
-    }
-
-    // running/queued 상태이면 worker에서 최신 상태 갱신
-    if (
-      this.worker &&
-      (snapshot.status === "running" || snapshot.status === "queued")
-    ) {
-      const workerJobId = this._workerJobMap.get(resolvedId);
-      if (workerJobId) {
-        try {
-          const workerResult = await this.worker.getJobStatus(
-            workerJobId,
-            null,
-          );
-          if (workerResult && workerResult.ok !== undefined) {
-            return this._applyWorkerResult(resolvedId, workerResult);
-          }
-        } catch {
-          // worker 상태 확인 실패 시 캐시된 snapshot 반환
-        }
-      }
-    }
-
-    return snapshot;
-  }
-}

package/hub/delegator/tool-definitions.mjs

@@ -1,35 +0,0 @@
-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,
-  }));
-}