@schlenkr/ragents 0.1.18 → 0.1.20

package/plugins/ragents.orchestration/web/surface-entities.ts

@@ -1,21 +0,0 @@
-import { useSyncExternalStore } from "react";
-
-const stages = new Map<string, ReadonlySet<string>>();
-const listeners = new Set<() => void>();
-const empty: ReadonlySet<string> = new Set();
-
-const subscribe = (listener: () => void) => {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-};
-
-export function publishSurfaceEntities(runId: string, entities: ReadonlySet<string> | undefined) {
-  if (entities) stages.set(runId, entities);
-  else stages.delete(runId);
-  listeners.forEach((listener) => listener());
-}
-
-export function useSurfaceEntities(runId: string): ReadonlySet<string> {
-  const read = () => stages.get(runId) ?? empty;
-  return useSyncExternalStore(subscribe, read, read);
-}

package/plugins/ragents.orchestration/web/surface-view-settings.ts

@@ -1,42 +0,0 @@
-import { createLocalStorageSetting } from "@ragents/web/lib/local-storage-setting";
-import type { RunActor } from "@ragents/web/run-view";
-
-export interface SurfaceViewPreferences {
-  actorVisibility: Readonly<Record<string, boolean>>;
-}
-
-export const DEFAULT_SURFACE_VIEW_PREFERENCES: SurfaceViewPreferences = Object.freeze({ actorVisibility: Object.freeze({}) });
-export const surfaceViewStorageKey = (runId: string) => `ragents.orchestration.actor-visibility:${runId}`;
-
-export function parseSurfaceViewPreferences(raw: string | null): SurfaceViewPreferences {
-  if (raw === null) return DEFAULT_SURFACE_VIEW_PREFERENCES;
-  const value: unknown = JSON.parse(raw);
-  if (!value || typeof value !== "object" || Array.isArray(value)
-    || Object.keys(value).some((key) => key !== "actorVisibility")
-    || !("actorVisibility" in value) || !value.actorVisibility || typeof value.actorVisibility !== "object"
-    || Array.isArray(value.actorVisibility) || Object.values(value.actorVisibility).some((visible) => typeof visible !== "boolean")) {
-    throw new Error("The stored actor visibility is invalid.");
-  }
-  return value as SurfaceViewPreferences;
-}
-
-export const actorVisibleOnSurface = (actor: RunActor, appActorIds: ReadonlySet<string>, preferences: SurfaceViewPreferences, primaryActorId?: string | null): boolean => {
-  if (actor.kind === "human") return false;
-  const override = Object.hasOwn(preferences.actorVisibility, actor.id) ? preferences.actorVisibility[actor.id] : undefined;
-  return override ?? (actor.id !== primaryActorId && !appActorIds.has(actor.id));
-};
-
-const setting = createLocalStorageSetting({
-  changeEvent: "ragents-actor-visibility-change",
-  matchesKey: (key) => key.startsWith("ragents.orchestration.actor-visibility:"),
-  parse: parseSurfaceViewPreferences,
-  serialize: JSON.stringify,
-});
-
-export function useSurfaceViewPreferences(runId: string): SurfaceViewPreferences {
-  return setting.useValue(surfaceViewStorageKey(runId));
-}
-
-export function saveSurfaceViewPreferences(runId: string, preferences: SurfaceViewPreferences) {
-  setting.save(surfaceViewStorageKey(runId), preferences);
-}

package/plugins/ragents.orchestration/web/tile-docking.ts

@@ -1,105 +0,0 @@
-import type { SurfaceTileNode } from "../tiled-layout";
-
-export const SURFACE_TILE_DRAG_TYPE = "application/x-ragents-surface-tile";
-export const TILE_DIVIDER_SIZE = 8;
-export const TILE_MIN_WIDTH = 220;
-export const TILE_MIN_HEIGHT = 160;
-export type TileDockSide = "left" | "right" | "top" | "bottom";
-export interface TileRect { left: number; top: number; width: number; height: number }
-export interface TileDivider extends TileRect {
-  path: readonly number[];
-  direction: "horizontal" | "vertical";
-  ratio: number;
-  minimum: number;
-  maximum: number;
-  span: number;
-}
-
-export function tileEntities(root: SurfaceTileNode | null): string[] {
-  return root === null ? [] : "entity" in root ? [root.entity] : root.children.flatMap(tileEntities);
-}
-
-function tileLeaf(root: SurfaceTileNode | null, entity: string): SurfaceTileNode | undefined {
-  if (root === null) return undefined;
-  if ("entity" in root) return root.entity === entity ? root : undefined;
-  return tileLeaf(root.children[0], entity) ?? tileLeaf(root.children[1], entity);
-}
-
-export function removeTile(root: SurfaceTileNode | null, entity: string): SurfaceTileNode | null {
-  if (root === null || "entity" in root) return root?.entity === entity ? null : root;
-  const first = removeTile(root.children[0], entity);
-  const second = removeTile(root.children[1], entity);
-  if (!first) return second;
-  if (!second) return first;
-  return first === root.children[0] && second === root.children[1] ? root : { ...root, children: [first, second] };
-}
-
-export function dockTile(root: SurfaceTileNode | null, entity: string, target: string | null, side: TileDockSide): SurfaceTileNode | null {
-  if ((root && "entity" in root && root.entity === entity && target === null) || entity === target || (target !== null && !tileEntities(root).includes(target))) return root;
-  const remaining = removeTile(root, entity);
-  const leaf: SurfaceTileNode = tileLeaf(root, entity) ?? { entity };
-  if (!remaining) return leaf;
-  const wrap = (node: SurfaceTileNode): SurfaceTileNode => ({
-    direction: side === "left" || side === "right" ? "horizontal" : "vertical",
-    weights: [1, 1],
-    children: side === "left" || side === "top" ? [leaf, node] : [node, leaf],
-  });
-  if (target === null) return wrap(remaining);
-  const insert = (node: SurfaceTileNode): SurfaceTileNode => "entity" in node
-    ? node.entity === target ? wrap(node) : node
-    : { ...node, children: [insert(node.children[0]), insert(node.children[1])] };
-  return insert(remaining);
-}
-
-export function tileMinimum(root: SurfaceTileNode): { width: number; height: number } {
-  if ("entity" in root) return { width: TILE_MIN_WIDTH, height: TILE_MIN_HEIGHT };
-  const first = tileMinimum(root.children[0]);
-  const second = tileMinimum(root.children[1]);
-  return root.direction === "horizontal"
-    ? { width: first.width + second.width + TILE_DIVIDER_SIZE, height: Math.max(first.height, second.height) }
-    : { width: Math.max(first.width, second.width), height: first.height + second.height + TILE_DIVIDER_SIZE };
-}
-
-export function resizeTile(root: SurfaceTileNode, path: readonly number[], ratio: number): SurfaceTileNode {
-  if ("entity" in root) return root;
-  if (path.length === 0) {
-    const bounded = Math.max(0.001, Math.min(0.999, ratio));
-    return { ...root, weights: [bounded, 1 - bounded] };
-  }
-  const branch = path[0];
-  if (branch !== 0 && branch !== 1) return root;
-  const children: [SurfaceTileNode, SurfaceTileNode] = [...root.children];
-  children[branch] = resizeTile(children[branch], path.slice(1), ratio);
-  return { ...root, children };
-}
-
-export function tileGeometry(root: SurfaceTileNode, bounds: TileRect): { leaves: Map<string, TileRect>; dividers: TileDivider[] } {
-  const leaves = new Map<string, TileRect>();
-  const dividers: TileDivider[] = [];
-  const visit = (node: SurfaceTileNode, rect: TileRect, path: readonly number[]) => {
-    if ("entity" in node) { leaves.set(node.entity, rect); return; }
-    const horizontal = node.direction === "horizontal";
-    const span = Math.max(0, (horizontal ? rect.width : rect.height) - TILE_DIVIDER_SIZE);
-    const firstMinimum = tileMinimum(node.children[0]);
-    const secondMinimum = tileMinimum(node.children[1]);
-    const minimum = span > 0 ? (horizontal ? firstMinimum.width : firstMinimum.height) / span : 0.5;
-    const maximum = span > 0 ? 1 - (horizontal ? secondMinimum.width : secondMinimum.height) / span : 0.5;
-    const scale = Math.max(...node.weights);
-    const firstWeight = node.weights[0] / scale;
-    const requested = firstWeight / (firstWeight + node.weights[1] / scale);
-    const ratio = minimum <= maximum ? Math.max(minimum, Math.min(maximum, requested)) : requested;
-    const first = span * ratio;
-    dividers.push({
-      left: rect.left + (horizontal ? first : 0), top: rect.top + (horizontal ? 0 : first),
-      width: horizontal ? TILE_DIVIDER_SIZE : rect.width, height: horizontal ? rect.height : TILE_DIVIDER_SIZE,
-      path, direction: node.direction, ratio, minimum, maximum, span,
-    });
-    visit(node.children[0], { ...rect, width: horizontal ? first : rect.width, height: horizontal ? rect.height : first }, [...path, 0]);
-    visit(node.children[1], {
-      left: rect.left + (horizontal ? first + TILE_DIVIDER_SIZE : 0), top: rect.top + (horizontal ? 0 : first + TILE_DIVIDER_SIZE),
-      width: horizontal ? span - first : rect.width, height: horizontal ? rect.height : span - first,
-    }, [...path, 1]);
-  };
-  visit(root, bounds, []);
-  return { leaves, dividers };
-}

package/plugins/ragents.orchestration/web/tiled-view-settings.ts

@@ -1,74 +0,0 @@
-import { createLocalStorageSetting } from "@ragents/web/lib/local-storage-setting";
-import { useEffect, useMemo } from "react";
-import { ORCHESTRATION_PLUGIN_ID, surfaceLayoutOf } from "../contract";
-import { surfaceTileEntities, surfaceTileNodeOf, type SurfaceTileNode } from "../tiled-layout";
-import type { RunView } from "@ragents/web/run-view";
-
-export interface SurfacePresentation {
-  root: SurfaceTileNode | null;
-  programBasis?: string;
-}
-
-export const surfacePresentationStorageKey = (runId: string) => `ragents.orchestration.tile-presentation:${runId}`;
-
-export function parseSurfacePresentation(raw: string | null): SurfacePresentation | null {
-  if (raw === null || raw === "null") return null;
-  const value: unknown = JSON.parse(raw);
-  if (!value || typeof value !== "object" || Array.isArray(value)
-    || !("root" in value) || Object.keys(value).some((key) => !["root", "programBasis"].includes(key))
-    || ("programBasis" in value && typeof value.programBasis !== "string")) {
-    throw new Error("The stored tile view is invalid.");
-  }
-  return { root: value.root === null ? null : surfaceTileNodeOf(value.root),
-    ...("programBasis" in value ? { programBasis: value.programBasis as string } : {}),
-  };
-}
-
-const setting = createLocalStorageSetting({
-  changeEvent: "ragents-tile-presentation-change",
-  matchesKey: (key) => key.startsWith("ragents.orchestration.tile-presentation:"),
-  parse: parseSurfacePresentation,
-  serialize: JSON.stringify,
-});
-
-export const useSurfacePresentationOverride = (runId: string) => setting.useValue(surfacePresentationStorageKey(runId));
-export const saveSurfacePresentation = (runId: string, value: SurfacePresentation | null) =>
-  setting.save(surfacePresentationStorageKey(runId), value);
-
-export const surfaceProgramBasis = (program: SurfacePresentation): string => JSON.stringify({ root: program.root });
-
-export function currentSurfaceOverride(personal: SurfacePresentation | null, program: SurfacePresentation): SurfacePresentation | null {
-  if (!personal) return null;
-  if (personal.programBasis !== undefined) return personal.programBasis === surfaceProgramBasis(program) ? personal : null;
-  const entities = new Set(surfaceTileEntities(personal.root));
-  return surfaceTileEntities(program.root).some((entity) => !entities.has(entity)) ? null : personal;
-}
-
-export function useSurfacePresentation(runId: string, view: RunView | undefined) {
-  const state = view?.pluginStates.find((entry) => entry.pluginId === ORCHESTRATION_PLUGIN_ID && entry.scope.kind === "run")?.state;
-  const stateKey = useMemo(() => state === undefined ? undefined : JSON.stringify(state), [state]);
-  const programLayout = useMemo(() => {
-    try { return { layout: stateKey === undefined ? undefined : surfaceLayoutOf(JSON.parse(stateKey)) }; }
-    catch (error) { return { error: error instanceof Error ? error.message : String(error) }; }
-  }, [stateKey]);
-  const program = useMemo((): SurfacePresentation => ({ root: programLayout.layout?.root ?? null }), [programLayout]);
-  const programBasis = useMemo(() => surfaceProgramBasis(program), [program]);
-  const storedLayout = useSurfacePresentationOverride(runId);
-  const personalLayout = view && !programLayout.error ? currentSurfaceOverride(storedLayout, program) : storedLayout;
-  useEffect(() => {
-    if (storedLayout && !personalLayout) saveSurfacePresentation(runId, null);
-  }, [runId, storedLayout, personalLayout]);
-  return { programLayout, personalLayout, presentation: personalLayout ?? program, programBasis };
-}
-
-export function initialTileLayout(entities: readonly string[], direction: "horizontal" | "vertical" = "horizontal"): SurfaceTileNode | null {
-  if (entities.length === 0) return null;
-  if (entities.length === 1) return { entity: entities[0]! };
-  const middle = Math.ceil(entities.length / 2);
-  const nextDirection = direction === "horizontal" ? "vertical" : "horizontal";
-  return {
-    direction,
-    weights: [middle, entities.length - middle],
-    children: [initialTileLayout(entities.slice(0, middle), nextDirection)!, initialTileLayout(entities.slice(middle), nextDirection)!],
-  };
-}