@botbotgo/agent-harness 0.0.475 → 0.0.476

package/dist/contracts/core.js

@@ -1 +1 @@
-export const AUTO_AGENT_ID = "auto";
+const o="auto";export{o as AUTO_AGENT_ID};

package/dist/contracts/runtime-evaluation.js

@@ -1 +0,0 @@
-export {};

package/dist/contracts/runtime-memory.js

@@ -1 +0,0 @@
-export {};

package/dist/contracts/runtime-observability.js

@@ -1 +0,0 @@
-export {};

package/dist/contracts/runtime-requests.js

@@ -1 +0,0 @@
-export {};

package/dist/contracts/runtime-scheduling.js

@@ -1 +0,0 @@
-export {};

package/dist/contracts/runtime.js

@@ -1,27 +1 @@
-/*
-Stable contract anchors for source-layout tests:
-export type SessionSummary = {
-export type SessionListSummary = SessionSummary & {
-export type SessionRecord = {
-export type SessionRequestRecord = {
-export type RequestSummary = SessionRequestRecord;
-export type RequestResult = {
-export type RequestListeners = RuntimeListeners & {
-eventListener?: (snapshot: RequestEventSnapshot) => void | Promise<void>;
-dataListener?: (event: RequestDataEvent) => void | Promise<void>;
-export type RequestOptions = RequestStartOptions | RequestDecisionOptions;
-export type RuntimeHistoryItem =
-export type RequestRecord = RequestSummary & {
-traceItems?: unknown[];
-runtimeTimeline?: RuntimeTimelineItem[];
-requests: RequestRecord[];
-export type RuntimeRequestPackageInput = {
-export type RuntimeRequestPackage = {
-requestsPackages: RuntimeRequestPackage[];
-export type UpstreamRuntimeEvent = unknown;
-*/
-export * from "./runtime-observability.js";
-export * from "./runtime-memory.js";
-export * from "./runtime-requests.js";
-export * from "./runtime-scheduling.js";
-export * from "./runtime-evaluation.js";
+export*from"./runtime-observability.js";export*from"./runtime-memory.js";export*from"./runtime-requests.js";export*from"./runtime-scheduling.js";export*from"./runtime-evaluation.js";

package/dist/contracts/types.js

@@ -1,3 +1 @@
-export * from "./core.js";
-export * from "./runtime.js";
-export * from "./workspace.js";
+export*from"./core.js";export*from"./runtime.js";export*from"./workspace.js";

package/dist/contracts/workspace.js

@@ -1 +0,0 @@
-export {};

package/dist/flow/build-flow-graph.js

@@ -1,50 +1 @@
-import { projectRuntimeTimeline } from "../runtime/harness/events/timeline.js";
-import { buildRuntimeSurface, buildAttempts, convertUpstreamEventsWithAgents, resolveContext, } from "./flow-graph-upstream.js";
-import { deriveAgentName, deriveInitialAgentId, normalizeRuntimeEvents, readRequestId, readSessionId, } from "./flow-graph-normalization.js";
-import { buildRuntimeNodes } from "./flow-graph-runtime.js";
-export function buildFlowGraph(input) {
-    const runtimeData = input.runtimeTimeline
-        ?? (input.runtimeEvents ? projectRuntimeTimeline(normalizeRuntimeEvents(input.runtimeEvents), {
-            ...(readSessionId(input) ? { sessionId: readSessionId(input) } : {}),
-            ...(readRequestId(input) ? { requestId: readRequestId(input) } : {}),
-        }) : []);
-    const initialAgentId = deriveInitialAgentId(input, runtimeData);
-    const upstreamContext = input.upstreamEvents
-        ? convertUpstreamEventsWithAgents(input.upstreamEvents, initialAgentId)
-        : { projections: [], delegationNodes: [] };
-    const upstreamProjections = input.upstreamProjections ?? upstreamContext.projections.map((record) => record.projection);
-    const { sessionId, requestId } = resolveContext(input, runtimeData, upstreamProjections);
-    const { nodes: runtimeNodes, edges: runtimeEdges, groups: runtimeGroups } = buildRuntimeNodes(runtimeData);
-    for (const node of runtimeNodes) {
-        node.agentId = typeof node.detail.agentId === "string" ? node.detail.agentId : initialAgentId;
-        node.agentName = deriveAgentName(node.agentId);
-    }
-    const projectionRecords = input.upstreamProjections
-        ? input.upstreamProjections.map((projection, index) => ({
-            projection,
-            agentId: initialAgentId,
-            agentName: deriveAgentName(initialAgentId),
-            sourceEventId: "key" in projection ? projection.key : `projection:${index + 1}`,
-        }))
-        : upstreamContext.projections;
-    const { nodes: attemptNodes, edges: attemptEdges, groups: attemptGroups } = buildAttempts(projectionRecords, upstreamContext.delegationNodes, runtimeGroups, sessionId, requestId);
-    const runtimeSurface = buildRuntimeSurface([...upstreamContext.delegationNodes, ...attemptNodes]);
-    return {
-        graphId: `${sessionId}/${requestId}`,
-        scope: input.scope === "session" || input.scope === "request" ? input.scope : "request",
-        sessionId,
-        requestId,
-        nodes: [...runtimeNodes, ...attemptNodes],
-        edges: [...runtimeEdges, ...attemptEdges],
-        groups: [...runtimeGroups, ...attemptGroups],
-        metadata: {
-            initialAgentId,
-            initialAgentName: deriveAgentName(initialAgentId),
-            runtimeTimelineCount: runtimeData.length,
-            upstreamProjectionCount: upstreamProjections.length,
-            delegationCount: upstreamContext.delegationNodes.length,
-            runtimeSurface,
-            ...(input.metadata ?? {}),
-        },
-    };
-}
+import{projectRuntimeTimeline as E}from"../runtime/harness/events/timeline.js";import{buildRuntimeSurface as h,buildAttempts as A,convertUpstreamEventsWithAgents as R,resolveContext as q}from"./flow-graph-upstream.js";import{deriveAgentName as d,deriveInitialAgentId as C,normalizeRuntimeEvents as P,readRequestId as u,readSessionId as l}from"./flow-graph-normalization.js";import{buildRuntimeNodes as b}from"./flow-graph-runtime.js";function T(e){const n=e.runtimeTimeline??(e.runtimeEvents?E(P(e.runtimeEvents),{...l(e)?{sessionId:l(e)}:{},...u(e)?{requestId:u(e)}:{}}):[]),o=C(e,n),s=e.upstreamEvents?R(e.upstreamEvents,o):{projections:[],delegationNodes:[]},m=e.upstreamProjections??s.projections.map(t=>t.projection),{sessionId:r,requestId:a}=q(e,n,m),{nodes:i,edges:p,groups:c}=b(n);for(const t of i)t.agentId=typeof t.detail.agentId=="string"?t.detail.agentId:o,t.agentName=d(t.agentId);const I=e.upstreamProjections?e.upstreamProjections.map((t,j)=>({projection:t,agentId:o,agentName:d(o),sourceEventId:"key"in t?t.key:`projection:${j+1}`})):s.projections,{nodes:g,edges:v,groups:N}=A(I,s.delegationNodes,c,r,a),f=h([...s.delegationNodes,...g]);return{graphId:`${r}/${a}`,scope:e.scope==="session"||e.scope==="request"?e.scope:"request",sessionId:r,requestId:a,nodes:[...i,...g],edges:[...p,...v],groups:[...c,...N],metadata:{initialAgentId:o,initialAgentName:d(o),runtimeTimelineCount:n.length,upstreamProjectionCount:m.length,delegationCount:s.delegationNodes.length,runtimeSurface:f,...e.metadata??{}}}}export{T as buildFlowGraph};

package/dist/flow/export-mermaid.js

@@ -1,464 +1,2 @@
-import { formatAgentName } from "../utils/agent-display.js";
-const PRODUCT_VIEW_KINDS = new Set(["agent", "tool", "skill", "memory"]);
-const STRUCTURAL_EDGE_KINDS = new Set(["sequence", "contains"]);
-const PRODUCT_VIEW_EDGE_KINDS = new Set(["sequence", "approval", "resume", "result"]);
-const GENERIC_PRODUCT_TOOL_FAMILIES = new Set([
-    "ls",
-    "read-file",
-    "write-file",
-    "task",
-    "glob",
-    "grep",
-    "bash",
-    "sh",
-    "cat",
-]);
-function sanitizeMermaidId(value) {
-    return value.replace(/[^A-Za-z0-9_]/g, "_");
-}
-function escapeMermaidLabel(value) {
-    return value.replace(/"/g, '\\"');
-}
-function renderNode(node, mermaidId) {
-    const label = escapeMermaidLabel(`${node.label} [${node.status}]`);
-    switch (node.kind) {
-        case "approval":
-            return `  ${mermaidId}{"${label}"}`;
-        case "queue":
-            return `  ${mermaidId}[/"${label}"/]`;
-        case "recovery":
-            return `  ${mermaidId}{{"${label}"}}`;
-        case "artifact":
-            return `  ${mermaidId}[("${label}")]`;
-        case "skill":
-            return `  ${mermaidId}[["${label}"]]`;
-        case "memory":
-            return `  ${mermaidId}[("${label}")]`;
-        default:
-            return `  ${mermaidId}["${label}"]`;
-    }
-}
-function renderAgentRoot(label, mermaidId) {
-    return `  ${mermaidId}["${escapeMermaidLabel(label)}"]`;
-}
-function renderStartNode(mermaidId) {
-    return `  ${mermaidId}(("Start"))`;
-}
-function renderEndNode(mermaidId) {
-    return `  ${mermaidId}(("End"))`;
-}
-function renderEdge(edge, fromId, toId) {
-    const connector = edge.kind === "retry" || edge.kind === "fallback" ? "-.->" : edge.kind === "resume" ? "==>" : "-->";
-    const label = edge.label ?? edge.condition ?? (edge.kind !== "sequence" && edge.kind !== "contains" ? edge.kind : "");
-    return label
-        ? `  ${fromId} ${connector}|"${escapeMermaidLabel(label)}"| ${toId}`
-        : `  ${fromId} ${connector} ${toId}`;
-}
-function edgeKey(edge) {
-    return `${edge.from}::${edge.to}::${edge.kind}::${edge.label ?? ""}::${edge.condition ?? ""}`;
-}
-function collapseEdgePath(source, target, path) {
-    const representative = [...path].reverse().find((edge) => !STRUCTURAL_EDGE_KINDS.has(edge.kind) || edge.label || edge.condition);
-    const sourceEventIds = [...new Set(path.flatMap((edge) => edge.sourceEventIds))];
-    return {
-        id: `collapsed:${source}:${target}:${sourceEventIds.join(",")}`,
-        from: source,
-        to: target,
-        kind: representative?.kind ?? "sequence",
-        label: representative?.label,
-        condition: representative?.condition,
-        sourceEventIds,
-    };
-}
-function nodeIdentity(node) {
-    if (node.kind === "agent") {
-        const fromAgentId = typeof node.detail.fromAgentId === "string" ? node.detail.fromAgentId : "agent";
-        const toAgentId = node.agentId ?? "agent";
-        return `${node.kind}:${fromAgentId}:${toAgentId}`;
-    }
-    return `${node.kind}:${node.agentId ?? "-"}:${node.label}`;
-}
-function findCrossAgentBridgeNodeIds(nodes, edges) {
-    const nodeById = new Map(nodes.map((node) => [node.id, node]));
-    const incidentAgentIdsByNodeId = new Map();
-    for (const edge of edges) {
-        const fromNode = nodeById.get(edge.from);
-        const toNode = nodeById.get(edge.to);
-        if (!fromNode || !toNode) {
-            continue;
-        }
-        if (toNode.agentId) {
-            let agentIds = incidentAgentIdsByNodeId.get(fromNode.id);
-            if (!agentIds) {
-                agentIds = new Set();
-                incidentAgentIdsByNodeId.set(fromNode.id, agentIds);
-            }
-            agentIds.add(toNode.agentId);
-        }
-        if (fromNode.agentId) {
-            let agentIds = incidentAgentIdsByNodeId.get(toNode.id);
-            if (!agentIds) {
-                agentIds = new Set();
-                incidentAgentIdsByNodeId.set(toNode.id, agentIds);
-            }
-            agentIds.add(fromNode.agentId);
-        }
-    }
-    const bridgeNodeIds = new Set();
-    for (const node of nodes) {
-        if (node.kind === "agent") {
-            continue;
-        }
-        const agentIds = incidentAgentIdsByNodeId.get(node.id) ?? new Set();
-        if (node.agentId) {
-            agentIds.add(node.agentId);
-        }
-        if (agentIds.size > 1) {
-            bridgeNodeIds.add(node.id);
-        }
-    }
-    return bridgeNodeIds;
-}
-function findDelegationCarrierToolNodeIds(nodes) {
-    const delegationSourceEventIds = new Set(nodes
-        .filter((node) => node.kind === "agent")
-        .flatMap((node) => node.sourceEventIds));
-    return new Set(nodes
-        .filter((node) => node.kind === "tool" && node.sourceEventIds.some((id) => delegationSourceEventIds.has(id)))
-        .map((node) => node.id));
-}
-function selectProductViewNodes(nodes) {
-    const selected = new Map();
-    for (const node of nodes) {
-        const key = nodeIdentity(node);
-        const existing = selected.get(key);
-        if (!existing) {
-            selected.set(key, node);
-            continue;
-        }
-        const existingCompleted = existing.status === "completed";
-        const nodeCompleted = node.status === "completed";
-        const preferCompleted = !existingCompleted && nodeCompleted;
-        const preserveCompleted = existingCompleted && !nodeCompleted;
-        const preferLatest = !preserveCompleted && (existing.sequenceEnd ?? 0) <= (node.sequenceEnd ?? 0);
-        if (preferCompleted || preferLatest) {
-            selected.set(key, node);
-        }
-    }
-    return [...selected.values()].sort((left, right) => (left.sequenceStart ?? 0) - (right.sequenceStart ?? 0));
-}
-function trimToolNodesForProductView(nodes, delegatingAgentIds) {
-    const keptToolKeys = new Set();
-    const orderedToolKeysByAgentId = new Map();
-    const toolKeyByNodeId = new Map();
-    const genericToolKeysByAgentId = new Map();
-    for (const node of nodes) {
-        if (node.kind !== "tool") {
-            continue;
-        }
-        const agentId = node.agentId ?? "";
-        const toolName = (() => {
-            if (typeof node.detail.toolName === "string" && node.detail.toolName.trim().length > 0) {
-                return node.detail.toolName.trim();
-            }
-            const labelMatch = /^(?:Calling|Completed) tool (.+?)(?: \[[^\]]+\])?$/i.exec(node.label);
-            return labelMatch?.[1]?.trim() || node.label;
-        })();
-        const normalizedToolName = toolName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-        const toolKey = `${agentId}:${normalizedToolName}`;
-        toolKeyByNodeId.set(node.id, toolKey);
-        if (GENERIC_PRODUCT_TOOL_FAMILIES.has(normalizedToolName)) {
-            let genericToolKeys = genericToolKeysByAgentId.get(agentId);
-            if (!genericToolKeys) {
-                genericToolKeys = new Set();
-                genericToolKeysByAgentId.set(agentId, genericToolKeys);
-            }
-            genericToolKeys.add(toolKey);
-        }
-        const toolKeys = orderedToolKeysByAgentId.get(agentId);
-        if (toolKeys) {
-            if (!toolKeys.includes(toolKey)) {
-                toolKeys.push(toolKey);
-            }
-        }
-        else {
-            orderedToolKeysByAgentId.set(agentId, [toolKey]);
-        }
-    }
-    for (const [agentId, toolKeys] of orderedToolKeysByAgentId.entries()) {
-        const genericToolKeys = genericToolKeysByAgentId.get(agentId) ?? new Set();
-        const preferredToolKeys = toolKeys.filter((toolKey) => !genericToolKeys.has(toolKey));
-        const selectedToolKeys = preferredToolKeys.length > 0
-            ? preferredToolKeys.slice(-2)
-            : delegatingAgentIds.has(agentId)
-                ? []
-                : toolKeys.slice(-2);
-        selectedToolKeys.forEach((toolKey) => keptToolKeys.add(toolKey));
-    }
-    return nodes.filter((node) => node.kind !== "tool" || keptToolKeys.has(toolKeyByNodeId.get(node.id) ?? ""));
-}
-function collectVisibleEdges(graph, visibleNodes, includedEdgeKinds) {
-    const visibleNodeIds = new Set(visibleNodes.map((node) => node.id));
-    const candidateEdges = graph.edges.filter((edge) => includedEdgeKinds ? includedEdgeKinds.has(edge.kind) : true);
-    const outgoingByNodeId = new Map();
-    for (const edge of candidateEdges) {
-        const outgoing = outgoingByNodeId.get(edge.from);
-        if (outgoing) {
-            outgoing.push(edge);
-        }
-        else {
-            outgoingByNodeId.set(edge.from, [edge]);
-        }
-    }
-    const visibleEdges = candidateEdges.filter((edge) => visibleNodeIds.has(edge.from) && visibleNodeIds.has(edge.to));
-    const seenEdgeKeys = new Set(visibleEdges.map((edge) => edgeKey(edge)));
-    for (const node of visibleNodes) {
-        const queue = (outgoingByNodeId.get(node.id) ?? [])
-            .filter((edge) => !visibleNodeIds.has(edge.to))
-            .map((edge) => ({ nodeId: edge.to, path: [edge] }));
-        const visitedHiddenNodes = new Set();
-        while (queue.length > 0) {
-            const current = queue.shift();
-            if (visitedHiddenNodes.has(current.nodeId)) {
-                continue;
-            }
-            visitedHiddenNodes.add(current.nodeId);
-            for (const edge of outgoingByNodeId.get(current.nodeId) ?? []) {
-                const nextPath = [...current.path, edge];
-                if (visibleNodeIds.has(edge.to)) {
-                    if (edge.to === node.id) {
-                        continue;
-                    }
-                    const collapsed = collapseEdgePath(node.id, edge.to, nextPath);
-                    const key = edgeKey(collapsed);
-                    if (!seenEdgeKeys.has(key)) {
-                        seenEdgeKeys.add(key);
-                        visibleEdges.push(collapsed);
-                    }
-                    continue;
-                }
-                queue.push({ nodeId: edge.to, path: nextPath });
-            }
-        }
-    }
-    return visibleEdges;
-}
-function getRuntimeSurface(graph) {
-    const runtimeSurface = graph.metadata.runtimeSurface;
-    return Array.isArray(runtimeSurface) ? runtimeSurface : [];
-}
-export function exportFlowGraphToMermaid(graph, options = {}) {
-    const direction = options.direction ?? "TD";
-    const view = options.view ?? "product";
-    const productView = view === "product";
-    const includedKinds = options.includeKinds
-        ? new Set(options.includeKinds)
-        : view === "debug"
-            ? null
-            : PRODUCT_VIEW_KINDS;
-    const includedEdgeKinds = options.includeEdgeKinds
-        ? new Set(options.includeEdgeKinds)
-        : view === "debug"
-            ? null
-            : new Set(PRODUCT_VIEW_EDGE_KINDS);
-    const includeGroups = options.includeGroups ?? true;
-    const includeDetails = options.includeDetails ?? false;
-    const allFilteredNodes = graph.nodes.filter((node) => {
-        if (!includeDetails && node.layer === "detail") {
-            return false;
-        }
-        return includedKinds ? includedKinds.has(node.kind) : true;
-    });
-    const hiddenDelegationNodes = productView
-        ? allFilteredNodes.filter((node) => node.kind === "agent")
-        : [];
-    const delegationCarrierToolNodeIds = productView
-        ? findDelegationCarrierToolNodeIds(allFilteredNodes)
-        : new Set();
-    const delegatingAgentIds = productView
-        ? new Set(allFilteredNodes
-            .filter((node) => node.kind === "agent" && typeof node.detail.fromAgentId === "string")
-            .map((node) => node.detail.fromAgentId))
-        : new Set();
-    const filteredNodes = productView
-        ? allFilteredNodes.filter((node) => node.kind !== "agent" && !delegationCarrierToolNodeIds.has(node.id))
-        : allFilteredNodes;
-    const initiallySelectedNodes = productView
-        ? trimToolNodesForProductView(selectProductViewNodes(filteredNodes), delegatingAgentIds)
-        : filteredNodes;
-    let nodes = initiallySelectedNodes;
-    let edges = collectVisibleEdges(graph, nodes, includedEdgeKinds);
-    if (productView) {
-        const crossAgentBridgeNodeIds = findCrossAgentBridgeNodeIds(nodes, edges);
-        if (crossAgentBridgeNodeIds.size > 0) {
-            nodes = nodes.filter((node) => !crossAgentBridgeNodeIds.has(node.id));
-            edges = collectVisibleEdges(graph, nodes, includedEdgeKinds);
-        }
-    }
-    const nodeById = new Map(nodes.map((node) => [node.id, node]));
-    const nodeIdSet = new Set(nodes.map((node) => node.id));
-    if (productView) {
-        edges = edges.filter((edge) => {
-            const fromNode = nodeById.get(edge.from);
-            const toNode = nodeById.get(edge.to);
-            if (!fromNode || !toNode) {
-                return true;
-            }
-            return !fromNode.agentId || !toNode.agentId || fromNode.agentId === toNode.agentId;
-        });
-    }
-    const lines = [`flowchart ${direction}`];
-    const mermaidIdByNodeId = new Map();
-    const initialAgentId = typeof graph.metadata.initialAgentId === "string" ? graph.metadata.initialAgentId : null;
-    const startNodeId = productView && initialAgentId ? "graph_start" : null;
-    const endNodeId = productView ? "graph_end" : null;
-    const agentRootIdByAgentId = new Map();
-    for (const node of nodes) {
-        mermaidIdByNodeId.set(node.id, sanitizeMermaidId(node.id));
-    }
-    if (productView) {
-        const seenAgentIds = new Set();
-        for (const node of allFilteredNodes) {
-            const agentId = node.agentId;
-            if (!agentId || seenAgentIds.has(agentId)) {
-                // noop
-            }
-            else {
-                seenAgentIds.add(agentId);
-                agentRootIdByAgentId.set(agentId, sanitizeMermaidId(`agent_root:${agentId}`));
-            }
-            if (node.kind !== "agent") {
-                continue;
-            }
-            const fromAgentId = typeof node.detail.fromAgentId === "string" ? node.detail.fromAgentId : null;
-            if (!fromAgentId || seenAgentIds.has(fromAgentId)) {
-                continue;
-            }
-            seenAgentIds.add(fromAgentId);
-            agentRootIdByAgentId.set(fromAgentId, sanitizeMermaidId(`agent_root:${fromAgentId}`));
-        }
-    }
-    for (const [agentId, mermaidId] of agentRootIdByAgentId) {
-        const representative = nodes.find((node) => node.agentId === agentId
-            || (node.kind === "agent" && typeof node.detail.fromAgentId === "string" && node.detail.fromAgentId === agentId));
-        const representativeName = representative?.agentId === agentId
-            ? representative.agentName
-            : (typeof representative?.detail.fromAgentName === "string" ? representative.detail.fromAgentName : undefined);
-        lines.push(renderAgentRoot(representativeName ?? formatAgentName(agentId), mermaidId));
-    }
-    if (startNodeId) {
-        lines.push(renderStartNode(startNodeId));
-    }
-    if (endNodeId) {
-        lines.push(renderEndNode(endNodeId));
-    }
-    if (includeGroups) {
-        const groupedNodeIds = new Set();
-        for (const group of graph.groups) {
-            const groupNodes = group.nodeIds.filter((nodeId) => nodeIdSet.has(nodeId));
-            if (groupNodes.length === 0) {
-                continue;
-            }
-            lines.push(`  subgraph ${sanitizeMermaidId(group.id)}["${escapeMermaidLabel(group.label)}"]`);
-            for (const nodeId of groupNodes) {
-                groupedNodeIds.add(nodeId);
-                const node = nodes.find((candidate) => candidate.id === nodeId);
-                if (!node) {
-                    continue;
-                }
-                lines.push(renderNode(node, mermaidIdByNodeId.get(node.id)));
-            }
-            lines.push("  end");
-        }
-        for (const node of nodes) {
-            if (!groupedNodeIds.has(node.id)) {
-                lines.push(renderNode(node, mermaidIdByNodeId.get(node.id)));
-            }
-        }
-    }
-    else {
-        for (const node of nodes) {
-            lines.push(renderNode(node, mermaidIdByNodeId.get(node.id)));
-        }
-    }
-    for (const edge of edges) {
-        lines.push(renderEdge(edge, mermaidIdByNodeId.get(edge.from), mermaidIdByNodeId.get(edge.to)));
-    }
-    if (productView) {
-        const handoffPairs = new Set();
-        for (const item of getRuntimeSurface(graph)) {
-            if (item.kind !== "agent") {
-                continue;
-            }
-            const fromAgentId = item.ownerAgentId ?? null;
-            const toAgentId = item.agentId ?? null;
-            if (!fromAgentId || !toAgentId) {
-                continue;
-            }
-            const fromRoot = agentRootIdByAgentId.get(fromAgentId);
-            const toRoot = agentRootIdByAgentId.get(toAgentId);
-            if (!fromRoot || !toRoot || fromRoot === toRoot) {
-                continue;
-            }
-            const pairKey = `${fromAgentId}:${toAgentId}`;
-            if (handoffPairs.has(pairKey)) {
-                // noop
-            }
-            else {
-                handoffPairs.add(pairKey);
-                lines.push(renderEdge({
-                    id: `synthetic:handoff:${pairKey}`,
-                    from: `agent_root:${fromAgentId}`,
-                    to: `agent_root:${toAgentId}`,
-                    kind: "spawn",
-                    label: "handoff",
-                    sourceEventIds: item.sourceEventId ? [item.sourceEventId] : [],
-                }, fromRoot, toRoot));
-            }
-        }
-    }
-    if (startNodeId && initialAgentId) {
-        const initialRootId = agentRootIdByAgentId.get(initialAgentId);
-        if (initialRootId) {
-            lines.push(`  ${startNodeId} --> ${initialRootId}`);
-        }
-    }
-    for (const [agentId, rootMermaidId] of agentRootIdByAgentId) {
-        const firstAgentStep = nodes.find((node) => node.agentId === agentId && node.kind !== "agent");
-        if (!firstAgentStep) {
-            continue;
-        }
-        const incomingDelegation = !productView
-            ? hiddenDelegationNodes.find((node) => node.agentId === agentId)
-            : null;
-        if (incomingDelegation) {
-            lines.push(renderEdge({
-                id: `synthetic:${incomingDelegation.id}->agent-root:${agentId}`,
-                from: incomingDelegation.id,
-                to: `agent_root:${agentId}`,
-                kind: "spawn",
-                label: "spawn",
-                sourceEventIds: [],
-            }, mermaidIdByNodeId.get(incomingDelegation.id), rootMermaidId));
-        }
-        lines.push(renderEdge({
-            id: `synthetic:agent-root:${agentId}->${firstAgentStep.id}`,
-            from: `agent_root:${agentId}`,
-            to: firstAgentStep.id,
-            kind: "sequence",
-            sourceEventIds: [],
-        }, rootMermaidId, mermaidIdByNodeId.get(firstAgentStep.id)));
-    }
-    if (endNodeId) {
-        const finalVisibleStep = [...nodes]
-            .filter((node) => node.kind !== "agent")
-            .sort((left, right) => (right.sequenceEnd ?? right.sequenceStart ?? 0) - (left.sequenceEnd ?? left.sequenceStart ?? 0))[0];
-        const finalAnchorId = finalVisibleStep
-            ? mermaidIdByNodeId.get(finalVisibleStep.id)
-            : (initialAgentId ? agentRootIdByAgentId.get(initialAgentId) : undefined);
-        if (finalAnchorId) {
-            lines.push(`  ${finalAnchorId} --> ${endNodeId}`);
-        }
-    }
-    return lines.join("\n");
-}
+import{formatAgentName as V}from"../utils/agent-display.js";const x=new Set(["agent","tool","skill","memory"]),z=new Set(["sequence","contains"]),G=new Set(["sequence","approval","resume","result"]),L=new Set(["ls","read-file","write-file","task","glob","grep","bash","sh","cat"]);function K(e){return e.replace(/[^A-Za-z0-9_]/g,"_")}function T(e){return e.replace(/"/g,'\\"')}function q(e,n){const o=T(`${e.label} [${e.status}]`);switch(e.kind){case"approval":return`  ${n}{"${o}"}`;case"queue":return`  ${n}[/"${o}"/]`;case"recovery":return`  ${n}{{"${o}"}}`;case"artifact":return`  ${n}[("${o}")]`;case"skill":return`  ${n}[["${o}"]]`;case"memory":return`  ${n}[("${o}")]`;default:return`  ${n}["${o}"]`}}function O(e,n){return`  ${n}["${T(e)}"]`}function U(e){return`  ${e}(("Start"))`}function F(e){return`  ${e}(("End"))`}function _(e,n,o){const i=e.kind==="retry"||e.kind==="fallback"?"-.->":e.kind==="resume"?"==>":"-->",l=e.label??e.condition??(e.kind!=="sequence"&&e.kind!=="contains"?e.kind:"");return l?`  ${n} ${i}|"${T(l)}"| ${o}`:`  ${n} ${i} ${o}`}function R(e){return`${e.from}::${e.to}::${e.kind}::${e.label??""}::${e.condition??""}`}function j(e,n,o){const i=[...o].reverse().find(r=>!z.has(r.kind)||r.label||r.condition),l=[...new Set(o.flatMap(r=>r.sourceEventIds))];return{id:`collapsed:${e}:${n}:${l.join(",")}`,from:e,to:n,kind:i?.kind??"sequence",label:i?.label,condition:i?.condition,sourceEventIds:l}}function W(e){if(e.kind==="agent"){const n=typeof e.detail.fromAgentId=="string"?e.detail.fromAgentId:"agent",o=e.agentId??"agent";return`${e.kind}:${n}:${o}`}return`${e.kind}:${e.agentId??"-"}:${e.label}`}function H(e,n){const o=new Map(e.map(r=>[r.id,r])),i=new Map;for(const r of n){const s=o.get(r.from),u=o.get(r.to);if(!(!s||!u)){if(u.agentId){let d=i.get(s.id);d||(d=new Set,i.set(s.id,d)),d.add(u.agentId)}if(s.agentId){let d=i.get(u.id);d||(d=new Set,i.set(u.id,d)),d.add(s.agentId)}}}const l=new Set;for(const r of e){if(r.kind==="agent")continue;const s=i.get(r.id)??new Set;r.agentId&&s.add(r.agentId),s.size>1&&l.add(r.id)}return l}function Z(e){const n=new Set(e.filter(o=>o.kind==="agent").flatMap(o=>o.sourceEventIds));return new Set(e.filter(o=>o.kind==="tool"&&o.sourceEventIds.some(i=>n.has(i))).map(o=>o.id))}function J(e){const n=new Map;for(const o of e){const i=W(o),l=n.get(i);if(!l){n.set(i,o);continue}const r=l.status==="completed",s=o.status==="completed",u=!r&&s,g=!(r&&!s)&&(l.sequenceEnd??0)<=(o.sequenceEnd??0);(u||g)&&n.set(i,o)}return[...n.values()].sort((o,i)=>(o.sequenceStart??0)-(i.sequenceStart??0))}function Q(e,n){const o=new Set,i=new Map,l=new Map,r=new Map;for(const s of e){if(s.kind!=="tool")continue;const u=s.agentId??"",g=(typeof s.detail.toolName=="string"&&s.detail.toolName.trim().length>0?s.detail.toolName.trim():/^(?:Calling|Completed) tool (.+?)(?: \[[^\]]+\])?$/i.exec(s.label)?.[1]?.trim()||s.label).toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,""),w=`${u}:${g}`;if(l.set(s.id,w),L.has(g)){let h=r.get(u);h||(h=new Set,r.set(u,h)),h.add(w)}const I=i.get(u);I?I.includes(w)||I.push(w):i.set(u,[w])}for(const[s,u]of i.entries()){const d=r.get(s)??new Set,g=u.filter(I=>!d.has(I));(g.length>0?g.slice(-2):n.has(s)?[]:u.slice(-2)).forEach(I=>o.add(I))}return e.filter(s=>s.kind!=="tool"||o.has(l.get(s.id)??""))}function B(e,n,o){const i=new Set(n.map(d=>d.id)),l=e.edges.filter(d=>o?o.has(d.kind):!0),r=new Map;for(const d of l){const g=r.get(d.from);g?g.push(d):r.set(d.from,[d])}const s=l.filter(d=>i.has(d.from)&&i.has(d.to)),u=new Set(s.map(d=>R(d)));for(const d of n){const g=(r.get(d.id)??[]).filter(I=>!i.has(I.to)).map(I=>({nodeId:I.to,path:[I]})),w=new Set;for(;g.length>0;){const I=g.shift();if(!w.has(I.nodeId)){w.add(I.nodeId);for(const h of r.get(I.nodeId)??[]){const N=[...I.path,h];if(i.has(h.to)){if(h.to===d.id)continue;const M=j(d.id,h.to,N),p=R(M);u.has(p)||(u.add(p),s.push(M));continue}g.push({nodeId:h.to,path:N})}}}}return s}function X(e){const n=e.metadata.runtimeSurface;return Array.isArray(n)?n:[]}function ee(e,n={}){const o=n.direction??"TD",i=n.view??"product",l=i==="product",r=n.includeKinds?new Set(n.includeKinds):i==="debug"?null:x,s=n.includeEdgeKinds?new Set(n.includeEdgeKinds):i==="debug"?null:new Set(G),u=n.includeGroups??!0,d=n.includeDetails??!1,g=e.nodes.filter(t=>!d&&t.layer==="detail"?!1:r?r.has(t.kind):!0),w=l?g.filter(t=>t.kind==="agent"):[],I=l?Z(g):new Set,h=l?new Set(g.filter(t=>t.kind==="agent"&&typeof t.detail.fromAgentId=="string").map(t=>t.detail.fromAgentId)):new Set,N=l?g.filter(t=>t.kind!=="agent"&&!I.has(t.id)):g;let p=l?Q(J(N),h):N,k=B(e,p,s);if(l){const t=H(p,k);t.size>0&&(p=p.filter(a=>!t.has(a.id)),k=B(e,p,s))}const D=new Map(p.map(t=>[t.id,t])),P=new Set(p.map(t=>t.id));l&&(k=k.filter(t=>{const a=D.get(t.from),c=D.get(t.to);return!a||!c?!0:!a.agentId||!c.agentId||a.agentId===c.agentId}));const $=[`flowchart ${o}`],S=new Map,A=typeof e.metadata.initialAgentId=="string"?e.metadata.initialAgentId:null,b=l&&A?"graph_start":null,v=l?"graph_end":null,y=new Map;for(const t of p)S.set(t.id,K(t.id));if(l){const t=new Set;for(const a of g){const c=a.agentId;if(!c||t.has(c)||(t.add(c),y.set(c,K(`agent_root:${c}`))),a.kind!=="agent")continue;const f=typeof a.detail.fromAgentId=="string"?a.detail.fromAgentId:null;!f||t.has(f)||(t.add(f),y.set(f,K(`agent_root:${f}`)))}}for(const[t,a]of y){const c=p.find(m=>m.agentId===t||m.kind==="agent"&&typeof m.detail.fromAgentId=="string"&&m.detail.fromAgentId===t),f=c?.agentId===t?c.agentName:typeof c?.detail.fromAgentName=="string"?c.detail.fromAgentName:void 0;$.push(O(f??V(t),a))}if(b&&$.push(U(b)),v&&$.push(F(v)),u){const t=new Set;for(const a of e.groups){const c=a.nodeIds.filter(f=>P.has(f));if(c.length!==0){$.push(`  subgraph ${K(a.id)}["${T(a.label)}"]`);for(const f of c){t.add(f);const m=p.find(E=>E.id===f);m&&$.push(q(m,S.get(m.id)))}$.push("  end")}}for(const a of p)t.has(a.id)||$.push(q(a,S.get(a.id)))}else for(const t of p)$.push(q(t,S.get(t.id)));for(const t of k)$.push(_(t,S.get(t.from),S.get(t.to)));if(l){const t=new Set;for(const a of X(e)){if(a.kind!=="agent")continue;const c=a.ownerAgentId??null,f=a.agentId??null;if(!c||!f)continue;const m=y.get(c),E=y.get(f);if(!m||!E||m===E)continue;const C=`${c}:${f}`;t.has(C)||(t.add(C),$.push(_({id:`synthetic:handoff:${C}`,from:`agent_root:${c}`,to:`agent_root:${f}`,kind:"spawn",label:"handoff",sourceEventIds:a.sourceEventId?[a.sourceEventId]:[]},m,E)))}}if(b&&A){const t=y.get(A);t&&$.push(`  ${b} --> ${t}`)}for(const[t,a]of y){const c=p.find(m=>m.agentId===t&&m.kind!=="agent");if(!c)continue;const f=l?null:w.find(m=>m.agentId===t);f&&$.push(_({id:`synthetic:${f.id}->agent-root:${t}`,from:f.id,to:`agent_root:${t}`,kind:"spawn",label:"spawn",sourceEventIds:[]},S.get(f.id),a)),$.push(_({id:`synthetic:agent-root:${t}->${c.id}`,from:`agent_root:${t}`,to:c.id,kind:"sequence",sourceEventIds:[]},a,S.get(c.id)))}if(v){const t=[...p].filter(c=>c.kind!=="agent").sort((c,f)=>(f.sequenceEnd??f.sequenceStart??0)-(c.sequenceEnd??c.sequenceStart??0))[0],a=t?S.get(t.id):A?y.get(A):void 0;a&&$.push(`  ${a} --> ${v}`)}return $.join(`
+`)}export{ee as exportFlowGraphToMermaid};