@tangle-network/charts 2.0.13 → 2.0.15

package/dist/elk-loader-CrLO557o.d.ts

@@ -0,0 +1,268 @@
+import { AnimationEvent, CSSProperties, Component, ReactNode, RefObject } from "react";
+import { ColorMode } from "@xyflow/react";
+import { ELK } from "elkjs/lib/elk-api";
+//#region src/react/agent-graph/agent-graph-layout.d.ts
+/**
+ * Stable desktop geometry for AgentGraph. Spawn edges determine the tree and
+ * packed leaf groups; message and delegation edges never move cards.
+ * ELK lays out candidate column counts; a row-per-depth fallback keeps the
+ * graph usable without that optional peer. Narrow containers use Canvas's list.
+ */
+type AgentGraphStatus = "running" | "waiting" |
+/** Blocked on a person: drawn amber, named in the header. */
+"needs-you" | "succeeded" | "failed" | "stopped" | "idle" | "unknown";
+interface AgentGraphNode {
+  id: string;
+  /** The agent's name, e.g. "root", "memscale". */
+  label: string;
+  /** What it was started as, e.g. "manager", "v6-battery". */
+  role?: string | null;
+  /** The coding harness it runs in, e.g. "opencode", "claude-code", "codex". */
+  harness?: string | null;
+  /** The model it runs, e.g. "glm-5.3-flash"; its brand mark identifies the card. */
+  model?: string | null;
+  status: AgentGraphStatus;
+  /** What it is doing now, or did last — one line. */
+  turn?: string | null;
+  costUsd?: number | null;
+  tokens?: number | null;
+  /** Recorded metrics with units; retained in pointer and keyboard detail cards. */
+  facts?: readonly {
+    label: string;
+    value: string;
+  }[];
+  /** Live cards: what it is doing now, from its real state; the card carries it as `data-activity` for hosts to style. */
+  activity?: AgentGraphActivity | null;
+  /** Live cards: its latest tool calls or events, oldest first; the card shows the last three. */
+  events?: readonly AgentGraphEvent[] | null;
+  /** Recorded activity and full-stream median, when the visible event tail is bounded. Epoch milliseconds. */
+  lastActivityAt?: number;
+  /** Median interval between recorded events, in milliseconds. */
+  medianEventGapMs?: number;
+  /** Live cards: the reasoning effort it runs at, e.g. "high". */
+  effort?: string | null;
+  /** Live cards: epoch ms it was spawned, for its time alive. */
+  startedAt?: number | null;
+  /** Live cards: commits it shipped. */
+  commits?: number | null;
+  /** Live cards: a settled agent's result in its compact row, e.g. "rc2 · 14 commits". */
+  result?: string | null;
+}
+type AgentGraphActivity = "thinking" | "reading" | "building" | "proving" | "writing" | "waiting" | "restarting";
+interface AgentGraphEvent {
+  id: string;
+  /** One line, e.g. "bash cargo test -p prover". */
+  label: string;
+  at?: number;
+}
+type AgentGraphEdgeKind = "spawn" | "message" | "delegation";
+interface AgentGraphEdge {
+  from: string;
+  to: string;
+  kind: AgentGraphEdgeKind;
+  /** How many times it happened; a badge shows counts above one. */
+  count?: number;
+  label?: string;
+}
+type AgentGraphDirection = "TB" | "LR";
+/** Every agent card's size. Fixed, so a status or turn update never moves a card. */
+declare const AGENT_CARD: {
+  readonly width: 240;
+  readonly height: 88;
+};
+/** A live card: room for the header, a two-line thinking line and the last three events. Fixed for the same reason. */
+declare const LIVE_AGENT_CARD: {
+  readonly width: 296;
+  readonly height: 164;
+};
+type CardSize = {
+  readonly width: number;
+  readonly height: number;
+};
+/** A parent with at least this many leaf workers draws them as a grid. */
+declare const GRID_MIN_LEAVES = 4;
+/** The manager stays with its workers instead of reserving an otherwise empty tree layer. */
+declare const FRAME_CAPTION = 80;
+/** A parent's leaf workers, drawn as one grid in one frame. */
+interface AgentLeafGroup {
+  id: string;
+  parentId: string;
+  memberIds: readonly string[];
+}
+/** The run's tree as the layout reads it: valid, de-duplicated spawn edges and
+ *  the leaf groups they produce. */
+interface AgentTopology {
+  /** Changes only when the tree does, never on a status update. */
+  key: string;
+  agentIds: readonly string[];
+  spawns: readonly {
+    from: string;
+    to: string;
+  }[];
+  groups: readonly AgentLeafGroup[];
+  /** Agent id → the group drawing it, for grouped agents only. */
+  groupOf: ReadonlyMap<string, string>;
+}
+declare function buildAgentTopology(nodes: readonly AgentGraphNode[], edges: readonly AgentGraphEdge[]): AgentTopology;
+interface AgentFrame {
+  group: AgentLeafGroup;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  collapsed?: boolean;
+}
+interface AgentLayout {
+  /** The grid column count this layout was made with. */
+  columns: number;
+  /** Top-left corner of every agent card. */
+  positions: ReadonlyMap<string, {
+    x: number;
+    y: number;
+  }>;
+  frames: readonly AgentFrame[];
+  width: number;
+  height: number;
+}
+/** Lay the run out with every grid `columns` wide. */
+declare function layoutAgents(topology: AgentTopology, direction: AgentGraphDirection, columns: number, card?: CardSize, collapsed?: ReadonlySet<string>): Promise<AgentLayout>;
+//#endregion
+//#region src/react/agent-graph/format.d.ts
+/**
+ * Display formatters for the workflow graph's live run-state chips. Pure and
+ * dependency-free so they can be unit-tested without rendering the graph.
+ */
+/** Human-readable duration: `850ms`, `4.2s`, `1m30s`. Undefined for an absent,
+ *  non-finite, or negative input (e.g. clock skew) so the caller renders no
+ *  chip rather than a confusing `-5ms`. */
+declare function fmtDuration(ms: number | undefined): string | undefined;
+/** Human-readable USD cost: `$0`, `$0.0032` (sub-cent, 4dp), `$1.20`. Undefined
+ *  for an absent, non-finite, or negative input — a cost is a billing amount, so
+ *  a negative value is bad data, not a refund to render. */
+declare function fmtCost(usd: number | undefined): string | undefined;
+/** Bound host-supplied preview/error text to a fixed length (with an ellipsis)
+ *  before it reaches the DOM, so an oversized payload can't bloat the node tree —
+ *  the card only ever shows a short preview, and CSS clamping is visual only.
+ *  Truncation is code-point aware: it never slices through a surrogate pair (which
+ *  would leave a lone surrogate that renders as the replacement character). */
+declare function clampPreview(text: string, max?: number): string;
+/** Human-readable token usage: `1200/340 tok`. Undefined when neither side is a
+ *  finite, non-negative count, so the caller renders no chip; an invalid side
+ *  (negative / NaN / absent) shows as 0 rather than leaking `-5/NaN tok`. */
+declare function fmtTokens(input: number | undefined, output: number | undefined): string | undefined;
+/** A token total in a few characters: `840 tok`, `12.4k tok`, `1.2M tok`.
+ *  Undefined for an absent, non-finite or negative count. */
+declare function fmtTokenTotal(tokens: number | null | undefined): string | undefined;
+declare function fmtEventTime(at: number | undefined, now: number, frozen?: boolean): string;
+//#endregion
+//#region src/react/agent-graph/naming.d.ts
+/**
+ * Human-facing naming for workflow nodes. A definition addresses things by
+ * machine identifier — an action kind (`agent.run`), a hub action path
+ * (`github.pulls.reviews.create`), a profile slug (`pr-reviewer`) — and showing
+ * those verbatim on a node makes the graph read like a config file. These turn
+ * an identifier into the label a person would say out loud.
+ *
+ * Pure and dependency-free so the naming rules are unit-testable without the
+ * YAML parser or a render.
+ */
+/** How the first word of a humanized identifier is cased. An initialism is
+ *  ALWAYS upper-cased whichever is chosen — that is the whole point of the table
+ *  above, and `.toLowerCase()`ing the result afterwards silently undoes it
+ *  ("List API keys" → "list api keys"). */
+type LeadCase = "sentence" | "lower" | "title";
+/**
+ * Humanize a machine identifier: `pr-reviewer` → "PR reviewer", `sandbox.spawn`
+ * → "Sandbox spawn", `postMessage` → "Post message". Known initialisms are
+ * upper-cased wherever they appear; `lead` picks the case of the rest.
+ *
+ *  - `sentence` (default): "Create issue comment" — a label or a title.
+ *  - `lower`: "create issue comment" — a fragment that sits INSIDE a phrase
+ *    ("On pull request"), where a capital would read as a new sentence. An
+ *    initialism still wins: `ci_run_completed` → "CI run completed", never
+ *    "cI run completed".
+ *  - `title`: "Google Sheets" — a brand/proper name.
+ *
+ * An identifier that carries no word characters is returned verbatim rather than
+ * blanked.
+ */
+declare function humanizeIdentifier(id: string, lead?: LeadCase): string;
+/** A model slug without its provider prefix (`anthropic/claude-sonnet-5` →
+ *  `claude-sonnet-5`) — the vendor is noise on a card whose width is the scarce
+ *  resource, and the full slug stays in the node's config for the detail view. */
+declare function shortModel(model: string): string;
+/** The parts of a hub action path (`<provider>.<resource…>.<operation>`). */
+interface ActionPathParts {
+  /** The connector the action runs against (`github`). */
+  provider: string;
+  /** The trailing verb (`create`). */
+  operation: string;
+  /** Everything between provider and operation (`pulls.reviews`), when present —
+   *  a two-segment path (`slack.postMessage`) has no resource. */
+  resource?: string;
+}
+/** Split a hub action path into provider / resource / operation. Null when the
+ *  value isn't a dotted path (a `${…}` expression, or a bare word), so callers
+ *  fall back to showing it verbatim instead of inventing structure. */
+declare function parseActionPath(path: string): ActionPathParts | null;
+/**
+ * The operation label for an action path, in n8n's `operation: resource` shape:
+ * `github.pulls.reviews.create` → "create: pulls.reviews", `slack.postMessage`
+ * → "post message". The provider names the node itself (its title + logo), so
+ * it is deliberately absent here. A path we can't split is shown verbatim.
+ */
+declare function actionPathLabel(path: string): string;
+//#endregion
+//#region src/react/agent-graph/run-ui-state.d.ts
+declare function useRunNow(fixed?: number): number;
+declare function useMotionAllowed(): boolean;
+declare function tokenMilliseconds(token: string, element?: Element | null): number;
+declare const ambientStyle: CSSProperties;
+/** The document timeline is the page's epoch, including marks mounted later. */
+declare function syncAmbient(event: AnimationEvent<HTMLElement | SVGElement>): void;
+declare function activityTiming(agent: Pick<AgentGraphNode, "events" | "lastActivityAt" | "medianEventGapMs">): {
+  lastActivityAt: number | undefined;
+  medianEventGapMs: number;
+};
+declare function agentQuietActivity(agent: AgentGraphNode, now: number): {
+  quietMs: number;
+  label: string;
+} | null;
+/** Attention is finite and state changes work without animation completion. */
+declare function useAttention(ref: RefObject<HTMLElement | null>, status: string): void;
+//#endregion
+//#region src/react/agent-graph/canvas-theme.d.ts
+/** Motion is opt-OUT, so it is only used where the reader's preference can be
+ *  read and says nothing against it. Somewhere without `matchMedia` cannot say
+ *  a reader tolerates movement, so it gets none. */
+declare function motionAllowed(): boolean;
+declare function useColorMode(wrapperRef: RefObject<HTMLDivElement | null>, hasGraph: boolean): ColorMode;
+/** Selection preserves the status border and stays quieter than failure or a response request. */
+declare const SELECTION_OUTLINE: CSSProperties;
+//#endregion
+//#region src/react/agent-graph/graph-style.d.ts
+declare const RESTING_SHADOW = "inset 0 1px 0 hsl(var(--foreground) / 0.06), 0 1px 3px hsl(var(--shadow-color) / 0.08)";
+declare const RESTING_BORDER = "hsl(var(--foreground) / 0.14)";
+declare function edgeColor(status: string | undefined): string;
+//#endregion
+//#region src/react/agent-graph/graph-lazy.d.ts
+declare function retryImport<T>(factory: () => Promise<T>, retries?: number, delayMs?: number): Promise<T>;
+declare class GraphErrorBoundary extends Component<{
+  fallback: ReactNode;
+  children: ReactNode;
+}, {
+  hasError: boolean;
+}> {
+  state: {
+    hasError: boolean;
+  };
+  static getDerivedStateFromError(): {
+    hasError: boolean;
+  };
+  render(): ReactNode;
+}
+//#endregion
+//#region src/react/agent-graph/elk-loader.d.ts
+declare function loadElk(): Promise<ELK | null>;
+//#endregion
+export { AGENT_CARD as A, AgentLeafGroup as B, shortModel as C, fmtEventTime as D, fmtDuration as E, AgentGraphEdgeKind as F, LIVE_AGENT_CARD as G, CardSize as H, AgentGraphEvent as I, buildAgentTopology as K, AgentGraphNode as L, AgentGraphActivity as M, AgentGraphDirection as N, fmtTokenTotal as O, AgentGraphEdge as P, AgentGraphStatus as R, parseActionPath as S, fmtCost as T, FRAME_CAPTION as U, AgentTopology as V, GRID_MIN_LEAVES as W, useRunNow as _, RESTING_SHADOW as a, actionPathLabel as b, motionAllowed as c, agentQuietActivity as d, ambientStyle as f, useMotionAllowed as g, useAttention as h, RESTING_BORDER as i, AgentFrame as j, fmtTokens as k, useColorMode as l, tokenMilliseconds as m, GraphErrorBoundary as n, edgeColor as o, syncAmbient as p, layoutAgents as q, retryImport as r, SELECTION_OUTLINE as s, loadElk as t, activityTiming as u, ActionPathParts as v, clampPreview as w, humanizeIdentifier as x, LeadCase as y, AgentLayout as z };

package/dist/flow-trace-DRluIYw8.js

@@ -0,0 +1,10 @@
+//#region src/flow-trace.ts
+/** Internal quantity boundaries shared by construction, aggregation and presentation. */
+const finiteNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
+const reportedCount = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : void 0;
+function sumReportedCounts(values) {
+	if (!values.length || values.some((value) => reportedCount(value) === void 0)) return void 0;
+	return reportedCount(values.reduce((sum, value) => sum + value, 0));
+}
+//#endregion
+export { reportedCount as n, sumReportedCounts as r, finiteNumber as t };