@dotdrelle/wiki-manager 0.15.94 → 0.15.97

package/src/orchestrator/.fuse_hidden0000001c00000001

@@ -1,316 +0,0 @@
-import { createAgentEvent, dispatchAgentEvent } from '../core/agentEvents.js';
-import { callMcpTool, formatMcpToolResult } from '../core/mcp.js';
-import { normalizeRuntimeLog } from '../core/runtimeLog.js';
-import { assertContract } from '../contracts/schemas.js';
-
-const AVAILABLE = 'available';
-const UNAVAILABLE = 'unavailable';
-/**
- * Santé d'un agent restauré depuis le journal, tant qu'aucun `agent_describe`
- * n'a réussi dans le processus courant.
- *
- * Ni `available` ni `unavailable` : on ne SAIT pas. Le distinguer de
- * `unavailable` a une conséquence pratique — un agent inconnu redevient
- * disponible en silence dès le premier scan réussi, là où un agent déclaré
- * indisponible mériterait d'être signalé comme tel à l'utilisateur.
- */
-const UNKNOWN = 'unknown';
-
-/**
- * Un agent persisté n'est pas un agent joignable.
- *
- * Au redémarrage, `hydrateSession` rejoue le journal d'événements et
- * reconstruit les agents avec la santé qu'ils avaient AU MOMENT où l'événement
- * a été écrit. `cme-main` réapparaissait donc `available` alors que son
- * endpoint n'existe plus, était retenu comme fournisseur, et la tâche partait
- * vers un agent absent — la panne observée le 2026-08-04.
- *
- * La persistance dit ce qui a existé, pas ce qui répond maintenant. Seul un
- * `agent_describe` réussi dans ce processus autorise à parler de disponibilité.
- */
-export function markPersistedAgentsStale(session) {
-  if (!session || typeof session !== 'object') return [];
-  const stale = (agent) => ({
-    ...agent,
-    health: UNKNOWN,
-    stale: true,
-    // La santé d'origine est conservée : elle raconte ce qu'on savait avant
-    // l'arrêt, ce qui aide à lire un journal, sans jamais servir au routage.
-    healthBeforeRestart: agent?.health ?? null,
-  });
-  /*
-   TOUTES les représentations restaurées, `agentRegistrySnapshot` compris.
-
-   J'avais d'abord épargné le snapshot, au motif qu'il pouvait porter un scan
-   vivant. C'était une inversion : à l'hydratation, aucun scan n'a encore eu
-   lieu — l'ordre est hydrate → invalidate → discover, et rien ne s'exécute
-   entre les deux premiers. Le snapshot vient donc de la même projection
-   persistée que `session.agents`. L'épargner laissait `cme-main` routable avec
-   son endpoint éteint, ce que la validation à chaud a montré.
-
-   Le seul scan qui compte est celui qui suivra : `discover()` réécrit le
-   snapshot en entier à partir des `agent_describe` réussis.
-  */
-  session.agents = (session.agents ?? []).map(stale);
-  session.agentRegistrySnapshot = (session.agentRegistrySnapshot ?? []).map(stale);
-  return session.agentRegistrySnapshot;
-}
-
-export function createAgentRegistry({
-  callTool = callMcpTool,
-  now = () => new Date(),
-} = {}) {
-  const agentsByInstance = new Map();
-  const instanceByServer = new Map();
-
-  return {
-    async discover(session, { signal = null } = {}) {
-      const discovered = [];
-      const endpoints = Object.entries(session?.mcp ?? {});
-      const activeServers = new Set(endpoints.map(([serverName]) => serverName));
-      for (const [serverName, endpoint] of endpoints) {
-        const agent = await discoverServerAgent(session, serverName, endpoint, { callTool, signal, now });
-        discovered.push(registerAgent(session, agent, { agentsByInstance, instanceByServer }));
-      }
-      for (const [serverName, instanceId] of instanceByServer) {
-        if (activeServers.has(serverName)) continue;
-        const previous = agentsByInstance.get(instanceId);
-        instanceByServer.delete(serverName);
-        agentsByInstance.delete(instanceId);
-        if (previous) dispatchRegistryEvent(session, 'agent.unregistered', {
-          agentInstanceId: instanceId,
-          serverName,
-        });
-      }
-      session.agentRegistry = this;
-      session.agentRegistrySnapshot = this.snapshot();
-      return discovered;
-    },
-    snapshot() {
-      return [...agentsByInstance.values()]
-        .map((agent) => cloneAgent(agent))
-        .sort((a, b) => a.agentInstanceId.localeCompare(b.agentInstanceId));
-    },
-    get(agentInstanceId) {
-      const agent = agentsByInstance.get(String(agentInstanceId));
-      return agent ? cloneAgent(agent) : null;
-    },
-  };
-}
-
-async function discoverServerAgent(session, serverName, endpoint = {}, { callTool, signal, now }) {
-  const lastSeenAt = now().toISOString();
-  if (endpoint.status !== 'connected') {
-    return legacyAgent(serverName, endpoint, { health: UNAVAILABLE, lastSeenAt });
-  }
-
-  const tool = findAgentDescribeTool(serverName, endpoint.tools ?? []);
-  if (!tool) {
-    return legacyAgent(serverName, endpoint, { health: AVAILABLE, lastSeenAt });
-  }
-  const toolName = tool.name;
-
-  try {
-    const result = await callTool(
-      session.mcp,
-      serverName,
-      toolName,
-      describeArguments(tool, session?.workspace),
-      signal,
-    );
-    const description = assertContract('agentDescription', parseToolJsonResult(result));
-    return {
-      serverName,
-      toolName,
-      agentInstanceId: description.agentInstanceId,
-      description,
-      health: description.health?.status ?? AVAILABLE,
-      firstSeenAt: lastSeenAt,
-      lastSeenAt,
-      legacy: false,
-      orchestrable: true,
-    };
-  } catch (error) {
-    return legacyAgent(serverName, endpoint, {
-      health: UNAVAILABLE,
-      lastSeenAt,
-      toolName,
-      error: error instanceof Error ? error.message : String(error),
-    });
-  }
-}
-
-function registerAgent(session, agent, { agentsByInstance, instanceByServer }) {
-  const previousInstanceId = instanceByServer.get(agent.serverName);
-  const previous = previousInstanceId ? agentsByInstance.get(previousInstanceId) : null;
-
-  /*
-   A failed discovery must not erase a known orchestrator agent.
-
-   When the endpoint is transiently unreachable — the runtime boots before its
-   containers (the normal boot order), or a single probe times out —
-   `discoverServerAgent` falls back to a legacy agent with no capabilities. The
-   old code replaced the orchestrator agent with that fallback, so every
-   capability silently vanished from the registry and did not come back until a
-   LATER successful discovery. Keep the orchestrator agent and only refresh its
-   probe timestamp: its capabilities are still real, only the endpoint is down.
-  */
-  if (agent.legacy && previous && !previous.legacy) {
-    agentsByInstance.set(previous.agentInstanceId, { ...previous, lastSeenAt: agent.lastSeenAt });
-    /*
-     Preserving is right; preserving in silence is what caused the hunt.
-
-     Every defect this registry produced was invisible: capabilities vanished
-     without an event, and the resolver could only report the consequence ("no
-     agent provides X") long afterwards. Keeping the agent fixes the loss, not
-     the blindness — a probe that failed is a fact worth stating, once, where
-     the panels and the shell already read.
-
-     Deliberately NOT a health change: the endpoint is down but the agent stays
-     usable by design here, and moving `health` would make `capabilityResolver`
-     refuse it — trading a silent loss for a silent refusal.
-    */
-    dispatchRuntimeLog(session, `agent-registry: ${agent.serverName} did not answer agent_describe`
-      + `${agent.error ? ` (${agent.error})` : ''}; keeping its known capabilities`
-      + ` (${(previous.description?.capabilities ?? []).map((capability) => capability.id).join(', ') || 'none'}).`);
-    return cloneAgent(previous);
-  }
-
-  const firstSeenAt = previous?.firstSeenAt ?? agent.firstSeenAt ?? agent.lastSeenAt;
-  const next = {
-    ...agent,
-    firstSeenAt,
-  };
-
-  if (previous && previous.agentInstanceId !== next.agentInstanceId) {
-    agentsByInstance.delete(previous.agentInstanceId);
-  }
-  agentsByInstance.set(next.agentInstanceId, next);
-  instanceByServer.set(next.serverName, next.agentInstanceId);
-
-  if (!previous || previous.agentInstanceId !== next.agentInstanceId) {
-    dispatchRegistryEvent(session, 'agent.registered', { agent: next });
-  } else if (previous.health !== next.health) {
-    dispatchRegistryEvent(session, 'agent.health_changed', {
-      agent: next,
-      agentInstanceId: next.agentInstanceId,
-      previousHealth: previous.health,
-      health: next.health,
-    });
-  }
-  return cloneAgent(next);
-}
-
-/**
- * Runtime log line, emitted without importing the supervisor.
- *
- * `emitRuntimeLog` lives in `runtime/supervisor.js`, which already imports THIS
- * module: importing it back would close a cycle for one log line. The event
- * shape is the contract, not the helper, so we build it from the same
- * normalizer the supervisor uses.
- */
-function dispatchRuntimeLog(session, message) {
-  if (!session) return;
-  const payload = normalizeRuntimeLog(message, { session });
-  dispatchAgentEvent(session, createAgentEvent('runtime_log', {
-    origin: 'runtime',
-    runId: payload.runId ?? null,
-    taskId: payload.taskId ?? null,
-    workspace: payload.workspaceId ?? null,
-    payload,
-  }));
-}
-
-function dispatchRegistryEvent(session, type, payload) {
-  if (!session) return;
-  dispatchAgentEvent(session, createAgentEvent(type, {
-    origin: 'agent_registry',
-    workspace: session.workspace ?? null,
-    payload,
-  }));
-}
-
-function findAgentDescribeTool(serverName, tools) {
-  const named = tools.filter((tool) => String(tool?.name ?? ''));
-  const byName = (predicate) => named.find((tool) => predicate(String(tool.name)));
-  return byName((name) => name === 'agent_describe')
-    ?? byName((name) => name === `${serverName}__agent_describe`)
-    ?? byName((name) => name.endsWith('__agent_describe'))
-    ?? null;
-}
-
-// Parts of a contract are workspace-scoped — typically the closed vocabulary of
-// an argument (the sources declared in THIS workspace). Published as a bare
-// string, such a field is unverifiable and a planner fills it with any noun
-// from the objective, so it is worth telling the agent which workspace we are
-// asking about.
-//
-// But the orchestrator must not assume an agent accepts an argument it never
-// declared: an agent whose agent_describe schema is `additionalProperties:
-// false` REJECTS the call, drops out of the registry, and its capabilities
-// silently vanish — the objective then resolves to whatever agent is left.
-// Send the workspace only to agents whose own schema says they can take it.
-function describeArguments(tool, workspace) {
-  if (!workspace) return {};
-  const schema = tool?.inputSchema;
-  if (!schema || typeof schema !== 'object') return {};
-  const declaresWorkspace = Object.hasOwn(schema.properties ?? {}, 'workspace');
-  const acceptsExtra = schema.additionalProperties !== false;
-  return declaresWorkspace || acceptsExtra ? { workspace: String(workspace) } : {};
-}
-
-function parseToolJsonResult(result) {
-  if (result && typeof result === 'object' && !Array.isArray(result) && !Array.isArray(result.content)) {
-    return result;
-  }
-  const text = formatMcpToolResult(result);
-  return JSON.parse(text);
-}
-
-function legacyAgent(serverName, endpoint = {}, { health, lastSeenAt, toolName = null, error = null }) {
-  const displayName = endpoint.displayName ?? serverName;
-  const description = {
-    contractVersion: 'legacy',
-    agentType: serverName,
-    agentInstanceId: `${serverName}-legacy`,
-    displayName,
-    capabilities: [],
-    orchestration: {
-      canPlan: false,
-      canExpandPlan: false,
-      canExecute: false,
-      canCancel: false,
-      canResume: false,
-      supportsIdempotency: false,
-      supportsParallelWorkers: false,
-    },
-    limits: {
-      recommendedConcurrency: 0,
-      maxConcurrency: 0,
-    },
-    health: { status: health },
-  };
-  return {
-    serverName,
-    toolName,
-    agentInstanceId: description.agentInstanceId,
-    description,
-    health,
-    firstSeenAt: lastSeenAt,
-    lastSeenAt,
-    legacy: true,
-    orchestrable: false,
-    error,
-  };
-}
-
-function cloneAgent(agent) {
-  return {
-    ...agent,
-    description: cloneJson(agent.description),
-  };
-}
-
-function cloneJson(value) {
-  return value == null ? value : JSON.parse(JSON.stringify(value));
-}