@triflux/core 10.50.2 → 10.51.0

package/mesh/mesh-queue.mjs

@@ -1,163 +0,0 @@
-const DEFAULT_MAX_QUEUE_SIZE = 100;
-const DEFAULT_TTL_MS = 0; // 0 = no expiry
-
-/**
- * Creates a per-agent message queue with TTL and size limits.
- *
- * @param {object} [opts]
- * @param {number} [opts.maxQueueSize=100] - Max messages per agent queue
- * @param {number} [opts.ttlMs=0]         - Message TTL in ms (0 = no expiry)
- * @returns {object} Queue API
- */
-export function createMessageQueue(opts = {}) {
-  const { maxQueueSize = DEFAULT_MAX_QUEUE_SIZE, ttlMs = DEFAULT_TTL_MS } =
-    opts;
-
-  /** @type {Map<string, Array<{ message: object, enqueuedAt: number }>>} */
-  const queues = new Map();
-
-  /**
-   * Returns the queue array for an agent (creates if absent).
-   * @param {string} agentId
-   * @returns {Array}
-   */
-  function getQueue(agentId) {
-    let q = queues.get(agentId);
-    if (!q) {
-      q = [];
-      queues.set(agentId, q);
-    }
-    return q;
-  }
-
-  /**
-   * Removes expired messages from the front of a queue.
-   * @param {Array} q
-   * @param {number} now
-   */
-  function purgeExpired(q, now) {
-    if (ttlMs <= 0) return;
-    while (q.length > 0 && now - q[0].enqueuedAt > ttlMs) {
-      q.shift();
-    }
-  }
-
-  /**
-   * Adds a message to the target agent's queue.
-   * If queue exceeds maxQueueSize, the oldest message is dropped.
-   *
-   * @param {string} agentId - Target agent
-   * @param {object} message - Mesh message
-   * @returns {{ queued: boolean, dropped: boolean }}
-   */
-  function enqueue(agentId, message) {
-    if (!agentId || typeof agentId !== "string") {
-      throw new TypeError("agentId must be a non-empty string");
-    }
-    const q = getQueue(agentId);
-    const now = Date.now();
-
-    purgeExpired(q, now);
-
-    let dropped = false;
-    if (q.length >= maxQueueSize) {
-      q.shift();
-      dropped = true;
-    }
-
-    q.push({ message, enqueuedAt: now });
-    return { queued: true, dropped };
-  }
-
-  /**
-   * Removes and returns the next message for an agent.
-   *
-   * @param {string} agentId
-   * @returns {object | null} The message, or null if queue is empty
-   */
-  function dequeue(agentId) {
-    const q = queues.get(agentId);
-    if (!q || q.length === 0) return null;
-
-    const now = Date.now();
-    purgeExpired(q, now);
-
-    if (q.length === 0) return null;
-    return q.shift().message;
-  }
-
-  /**
-   * Returns the next message without removing it.
-   *
-   * @param {string} agentId
-   * @returns {object | null}
-   */
-  function peek(agentId) {
-    const q = queues.get(agentId);
-    if (!q || q.length === 0) return null;
-
-    const now = Date.now();
-    purgeExpired(q, now);
-
-    if (q.length === 0) return null;
-    return q[0].message;
-  }
-
-  /**
-   * Returns the number of (non-expired) messages in an agent's queue.
-   *
-   * @param {string} agentId
-   * @returns {number}
-   */
-  function size(agentId) {
-    const q = queues.get(agentId);
-    if (!q) return 0;
-
-    const now = Date.now();
-    purgeExpired(q, now);
-
-    return q.length;
-  }
-
-  /**
-   * Drains all messages for an agent.
-   *
-   * @param {string} agentId
-   * @returns {object[]} Array of messages
-   */
-  function drain(agentId) {
-    const q = queues.get(agentId);
-    if (!q || q.length === 0) return [];
-
-    const now = Date.now();
-    purgeExpired(q, now);
-
-    const messages = q.map((entry) => entry.message);
-    q.length = 0;
-    return messages;
-  }
-
-  /**
-   * Removes an agent's queue entirely.
-   * @param {string} agentId
-   */
-  function clear(agentId) {
-    queues.delete(agentId);
-  }
-
-  /**
-   * Returns total message count across all agent queues.
-   * @returns {number}
-   */
-  function totalSize() {
-    let total = 0;
-    const now = Date.now();
-    for (const [, q] of queues) {
-      purgeExpired(q, now);
-      total += q.length;
-    }
-    return total;
-  }
-
-  return { enqueue, dequeue, peek, size, drain, clear, totalSize };
-}

package/mesh/mesh-registry.mjs

@@ -1,78 +0,0 @@
-/**
- * Creates an agent registry for the mesh network.
- * Agents register with capabilities; registry enables discovery.
- * @returns {object} Registry API
- */
-export function createRegistry() {
-  // Map<agentId, AgentInfo>
-  const agents = new Map();
-
-  /**
-   * Registers an agent with the registry.
-   * @param {string} agentId
-   * @param {string[]} capabilities
-   */
-  function register(agentId, capabilities = []) {
-    if (!agentId || typeof agentId !== "string") {
-      throw new TypeError("agentId must be a non-empty string");
-    }
-    if (!Array.isArray(capabilities)) {
-      throw new TypeError("capabilities must be an array");
-    }
-    const info = Object.freeze({
-      agentId,
-      capabilities: Object.freeze([...capabilities]),
-      registeredAt: new Date().toISOString(),
-    });
-    agents.set(agentId, info);
-  }
-
-  /**
-   * Unregisters an agent from the registry.
-   * @param {string} agentId
-   */
-  function unregister(agentId) {
-    agents.delete(agentId);
-  }
-
-  /**
-   * Discovers agents that have a specific capability.
-   * @param {string} capability
-   * @returns {string[]} Array of agentIds
-   */
-  function discover(capability) {
-    const result = [];
-    for (const [agentId, info] of agents) {
-      if (info.capabilities.includes(capability)) {
-        result.push(agentId);
-      }
-    }
-    return result;
-  }
-
-  /**
-   * Gets agent info by ID.
-   * @param {string} agentId
-   * @returns {object | null}
-   */
-  function getAgent(agentId) {
-    return agents.get(agentId) ?? null;
-  }
-
-  /**
-   * Lists all registered agents.
-   * @returns {object[]}
-   */
-  function listAll() {
-    return [...agents.values()];
-  }
-
-  /**
-   * Clears all registered agents.
-   */
-  function clear() {
-    agents.clear();
-  }
-
-  return { register, unregister, discover, getAgent, listAll, clear };
-}

package/mesh/mesh-router.mjs

@@ -1,77 +0,0 @@
-import { validate } from "./mesh-protocol.mjs";
-
-/**
- * Routes a mesh message to target agent(s) based on the `to` field.
- *
- * Addressing modes:
- *   - "agent-id"       → direct delivery (registry lookup)
- *   - "*"              → broadcast to all registered agents
- *   - "capability:X"   → discover agents with capability X
- *
- * @param {object} message  - A mesh-protocol message
- * @param {object} registry - A mesh-registry instance
- * @returns {{ routed: boolean, targets?: string[], reason?: string }}
- */
-export function routeMessage(message, registry) {
-  const { valid, errors } = validate(message);
-  if (!valid) {
-    return { routed: false, reason: `invalid message: ${errors.join(", ")}` };
-  }
-
-  const { to, from } = message;
-
-  // Broadcast
-  if (to === "*") {
-    const all = registry.listAll();
-    const targets = all.map((a) => a.agentId).filter((id) => id !== from);
-    if (targets.length === 0) {
-      return { routed: false, reason: "broadcast: no agents registered" };
-    }
-    return { routed: true, targets };
-  }
-
-  // Capability-based routing
-  if (to.startsWith("capability:")) {
-    const capability = to.slice("capability:".length);
-    if (!capability) {
-      return { routed: false, reason: "capability: empty capability name" };
-    }
-    const targets = registry.discover(capability);
-    if (targets.length === 0) {
-      return {
-        routed: false,
-        reason: `capability: no agents with "${capability}"`,
-      };
-    }
-    return { routed: true, targets };
-  }
-
-  // Direct addressing
-  const agent = registry.getAgent(to);
-  if (!agent) {
-    return { routed: false, reason: `agent not found: "${to}"` };
-  }
-  return { routed: true, targets: [to] };
-}
-
-/**
- * Routes a message and collects dead-letter info when delivery fails.
- *
- * @param {object} message
- * @param {object} registry
- * @returns {{ routed: boolean, targets?: string[], deadLetter?: object }}
- */
-export function routeOrDeadLetter(message, registry) {
-  const result = routeMessage(message, registry);
-  if (!result.routed) {
-    return {
-      ...result,
-      deadLetter: {
-        originalMessage: message,
-        reason: result.reason,
-        timestamp: new Date().toISOString(),
-      },
-    };
-  }
-  return result;
-}

package/scripts/lib/dynamic-route-cli.mjs

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-// scripts/lib/dynamic-route-cli.mjs
-//
-// Phase 1 Wire-up 3 helper — tfx-route.sh 등 sh 경로에서 dynamic routing
-// decision 을 받아 단일 CLI 문자열 (또는 JSON) 으로 출력한다.
-//
-// 사용:
-//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex
-//   → "codex"
-//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex --json
-//   → {"scenario":"fallback","mode":"codex-default","shards":[{"cli":"codex",...}]}
-//   node scripts/lib/dynamic-route-cli.mjs --agent-hint codex --field scenario
-//   → "fallback"
-//
-// 정책:
-//   - opt-in env TRIFLUX_DYNAMIC_ROUTING=1|true 미설정 시 즉시 silent exit 0
-//     (override 없음 = stdout empty, sh caller 가 graceful no-op).
-//   - error 발생 시 stderr 에 한 줄 + exit 0 (sh caller 가 fallback path 진행).
-
-import { createDynamicRouter } from "../../hub/dynamic-routing-engine.mjs";
-
-function parseArgs(argv) {
-  const args = {
-    taskId: `tfx-route-${process.pid}-${Date.now()}`,
-    agentHint: "codex",
-    teamSize: 1,
-    json: false,
-    field: null,
-  };
-  for (let i = 2; i < argv.length; i++) {
-    const v = argv[i];
-    switch (v) {
-      case "--task-id":
-        args.taskId = argv[++i] || args.taskId;
-        break;
-      case "--agent-hint":
-        args.agentHint = argv[++i] || args.agentHint;
-        break;
-      case "--team-size":
-        args.teamSize = Number(argv[++i]) || args.teamSize;
-        break;
-      case "--json":
-        args.json = true;
-        break;
-      case "--field":
-        args.field = argv[++i] || null;
-        break;
-      case "--help":
-      case "-h":
-        process.stdout.write(
-          "Usage: dynamic-route-cli.mjs [--task-id ID] [--agent-hint CLI] [--team-size N] [--json|--field FIELD]\n",
-        );
-        process.exit(0);
-        break;
-    }
-  }
-  return args;
-}
-
-async function main() {
-  const args = parseArgs(process.argv);
-
-  // opt-in env 미설정 시 silent no-op (sh caller graceful path)
-  const flag = process.env.TRIFLUX_DYNAMIC_ROUTING;
-  if (flag !== "1" && flag !== "true") return;
-
-  let decision;
-  try {
-    const router = createDynamicRouter();
-    decision = await router.routeRequest({
-      task_id: args.taskId,
-      team_size: args.teamSize,
-      agent_hint: args.agentHint,
-    });
-  } catch (err) {
-    process.stderr.write(
-      `[dynamic-route-cli] error: ${err?.message || String(err)}\n`,
-    );
-    return;
-  }
-
-  if (args.json) {
-    process.stdout.write(JSON.stringify(decision));
-    return;
-  }
-
-  if (args.field) {
-    const value = decision?.[args.field];
-    if (value !== undefined && value !== null) {
-      process.stdout.write(String(value));
-    }
-    return;
-  }
-
-  // 기본 — shards[0].cli 만 stdout 으로 (sh caller 가 즉시 비교)
-  const cli = decision?.shards?.[0]?.cli;
-  if (cli) {
-    process.stdout.write(String(cli));
-  }
-}
-
-main().catch((err) => {
-  process.stderr.write(
-    `[dynamic-route-cli] fatal: ${err?.message || String(err)}\n`,
-  );
-  process.exit(0); // sh caller 가 정상 fallback 하도록 always 0
-});