@schlenkr/ragents 0.1.18 → 0.1.20

package/plugins/ragents.orchestration/contract.ts

@@ -1,51 +0,0 @@
-import { handleKey } from "@ragents/engine/src/http/contracts";
-import { surfaceTileNodeOf } from "./tiled-layout.js";
-
-export const ORCHESTRATION_PLUGIN_ID = "ragents.orchestration";
-
-export type SurfaceEntity =
-  | { kind: "actor"; handle: string }
-  | { kind: "app"; id: string };
-
-export type SurfaceTileNode =
-  | { entity: string; chatInput?: boolean }
-  | { direction: "horizontal" | "vertical"; weights: [number, number]; children: [SurfaceTileNode, SurfaceTileNode] };
-
-export type SurfaceLayout = {
-  root: SurfaceTileNode | null;
-};
-
-const isRecord = (value: unknown): value is Record<string, unknown> => typeof value === "object" && value !== null && !Array.isArray(value);
-
-export const surfaceEntityOf = (text: string): SurfaceEntity => {
-  const trimmed = text.trim();
-  if (trimmed.startsWith("@")) {
-    const handle = handleKey(trimmed);
-    if (!handle || /\s/.test(handle)) throw new Error(`Entity ${JSON.stringify(text)}: a handle is missing after the @`);
-    return { kind: "actor", handle };
-  }
-  const match = /^app:(.+)$/s.exec(trimmed);
-  if (!match) {
-    throw new Error(`Entity ${JSON.stringify(text)}: expected @handle or app:<id>`);
-  }
-  const id = match[1].trim();
-  if (!id) throw new Error(`Entity ${JSON.stringify(text)}: the ID after the colon is empty`);
-  return { kind: "app", id };
-};
-
-export const surfaceEntityKey = (entity: SurfaceEntity): string =>
-  entity.kind === "actor" ? `@${entity.handle}` : `app:${entity.id}`;
-
-const LEGACY_KEYS = ["nodes", "shapes", "lines", "mode"] as const;
-
-/** Parses and validates a tile layout; throws an error naming the first violation. */
-export const surfaceLayoutOf = (value: unknown): SurfaceLayout => {
-  if (!isRecord(value)) throw new Error("The arrangement must be an object with root");
-  const legacy = LEGACY_KEYS.filter((key) => key in value);
-  if (legacy.length > 0) {
-    throw new Error(`The program arrangement comes from the removed free surface (${legacy.join(", ")}); `
-      + "canvas_layout_replace with root sets it anew as a tile layout");
-  }
-  if (!("root" in value)) throw new Error("root is missing; expected a tile, a split or null");
-  return { root: value.root === null ? null : surfaceTileNodeOf(value.root) };
-};

package/plugins/ragents.orchestration/server/contract.ts

@@ -1,14 +0,0 @@
-import { serviceToken, type CommandContext, type ServiceToken } from "@ragents/engine";
-
-export interface SurfacePlacementRequest {
-  entity: string;
-  direction?: "horizontal" | "vertical";
-  weight?: number;
-}
-
-/** Places an entity next to a run's surface layout, as canvas_layout_place does; an entity the layout shows already stays. */
-export interface SurfacePlacement {
-  place: (context: CommandContext, runId: string, request: SurfacePlacementRequest) => { placed: boolean };
-}
-
-export const surfacePlacementToken: ServiceToken<SurfacePlacement> = serviceToken("ragents.orchestration.surface-placement");

package/plugins/ragents.orchestration/server/surface-tool.ts

@@ -1,198 +0,0 @@
-import { Type } from "typebox";
-import {
-  DomainError,
-  actorByHandle,
-  defineRunFunction,
-  defineToolAvailability,
-  holdsUsable,
-  type CommandContext,
-  type Orchestration,
-  type RunFunction,
-  type RunView,
-  type ToolContributor,
-} from "@ragents/engine";
-import { toolDescriptorFrom } from "@ragents/host/plugin-support/agent-tool.js";
-import { ACTOR_PROGRAMS_STATE_ID, resolveActorView, type ActorProgramState } from "@ragents/host/plugin-support/actor-programs/contract.js";
-import {
-  ORCHESTRATION_PLUGIN_ID,
-  surfaceEntityOf,
-  surfaceLayoutOf,
-  type SurfaceLayout,
-} from "../contract.js";
-import { surfaceTileEntities, mapSurfaceTileEntities } from "../tiled-layout.js";
-import type { SurfacePlacement, SurfacePlacementRequest } from "./contract.js";
-
-export const surfaceToolMetadata = {
-  name: "canvas_layout_replace",
-  label: "Replace Surface Layout",
-  description: "Arrange actors and mini-apps as tiles on the viewport-filling work surface, using a binary tree of weighted splits.",
-  longDescription: "root is the whole arrangement and replaces the stored one. A tile is {entity:'@helper'} or "
-    + "{entity:'app:@workspace/main'}; a split is {direction:'horizontal',weights:[1,1],children:[tile,tile]}. "
-    + "horizontal means left/right, vertical means top/bottom, and weights give the ratio of the two children. "
-    + "App left, chat right at 50:50: {root:{direction:'horizontal',weights:[1,1],children:["
-    + "{entity:'app:@workspace/main'},{entity:'@helper'}]}}. One tile above two tiles at 2:1: "
-    + "{root:{direction:'vertical',weights:[2,1],children:[{entity:'@lead'},"
-    + "{direction:'horizontal',weights:[1,1],children:[{entity:'@first'},{entity:'@second'}]}]}}. "
-    + "root:null clears the surface. Dividers are draggable, so do not resend a layout to fight a personal arrangement. "
-    + "Participants you do not place stay reachable through the run header.",
-} as const;
-
-export const placeToolMetadata = {
-  name: "canvas_layout_place",
-  label: "Place on Surface",
-  description: "Place one actor or mini-app next to the current surface layout instead of replacing it.",
-  longDescription: "entity is {entity} of a tile: '@helper' or 'app:@workspace/main'. The current arrangement becomes one side of a new split "
-    + "and the entity the other: direction 'horizontal' (default) puts it to the right, 'vertical' below. weight is its share against "
-    + "the existing arrangement's weight 1, default 1. An entity the layout already shows stays where it is; placed is then false. "
-    + "On an empty surface the entity becomes the only tile. Use it when you join a running run, such as a run script started with "
-    + "start.embedded, so that the tiles others arranged stay.",
-} as const;
-
-export const canDesignSurface = defineToolAvailability({
-  availability: "conditional",
-  availabilityDetail: "Only for agents and TypeScript actors with the capability plugin.state.write.",
-  requiredCapabilities: ["plugin.state.write"],
-}, (actor) => actor.kind !== "human" && holdsUsable(actor, "plugin.state.write"));
-
-const tileSchema = Type.Cyclic({
-  SurfaceTile: Type.Union([
-    Type.Object({
-      entity: Type.String({ minLength: 1, description: "Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key; the server resolves the view ID" }),
-      chatInput: Type.Optional(Type.Boolean({ description: "Actor tiles only: false hides the chat composer in the tile; default true. Does not change permissions or the inspector" })),
-    }, { additionalProperties: false }),
-    Type.Object({
-      direction: Type.Union([Type.Literal("horizontal"), Type.Literal("vertical")]),
-      weights: Type.Tuple([Type.Number({ exclusiveMinimum: 0 }), Type.Number({ exclusiveMinimum: 0 })]),
-      children: Type.Tuple([Type.Ref("SurfaceTile"), Type.Ref("SurfaceTile")]),
-    }, { additionalProperties: false }),
-  ]),
-}, "SurfaceTile");
-
-const surfaceLayoutSchema = Type.Object({
-  root: Type.Union([tileSchema, Type.Null()], { description: "The whole arrangement: a tile or a binary split. Maximum 64 unique tiles and 16 nested splits. null clears the surface" }),
-});
-
-const invalid = (message: string) => new DomainError("invalid-surface-layout", message, 400);
-
-const parsedLayout = (input: unknown): SurfaceLayout => {
-  try {
-    return surfaceLayoutOf(input);
-  } catch (caught) {
-    throw invalid(caught instanceof Error ? caught.message : String(caught));
-  }
-};
-
-const isStopped = (actor: RunView["actors"][number]) => actor.kind !== "human" && actor.lifecycle.kind === "stopped";
-
-const surfaceActorOf = (view: RunView, reference: string, where: string) => {
-  const entity = surfaceEntityOf(reference);
-  if (entity.kind !== "actor") throw invalid(`${where}: ${reference} is not an actor`);
-  const handle = entity.handle;
-  const found = actorByHandle(view.actors, handle);
-  if (!found) {
-    const known = view.actors.filter((actor) => actor.kind !== "human").map((actor) => `@${actor.handle}`);
-    throw invalid(`${where}: @${handle} is not an actor of this run. Present: ${known.join(", ") || "none"}`);
-  }
-  if (found.kind === "human") {
-    throw invalid(`${where}: @${handle} is the human in the chat; the chat is fixed to the left of the surface`);
-  }
-  return found;
-};
-
-const isActorReference = (reference: string) => surfaceEntityOf(reference).kind === "actor";
-
-const resolveAppReferences = (view: RunView, layout: SurfaceLayout): SurfaceLayout => {
-  const programs = view.pluginStates.flatMap((entry) => {
-    if (entry.pluginId !== ACTOR_PROGRAMS_STATE_ID || entry.scope.kind !== "actor") return [];
-    const actorId = entry.scope.actorId;
-    const actor = view.actors.find((candidate) => candidate.id === actorId);
-    if (!actor || actor.kind === "human" || isStopped(actor)) return [];
-    const { program } = entry.state as unknown as ActorProgramState;
-    return program ? [program] : [];
-  });
-  const resolve = (reference: string, where: string): string => {
-    const entity = surfaceEntityOf(reference);
-    if (entity.kind !== "app") return reference;
-    try {
-      return `app:${resolveActorView(programs, entity.id).view.id}`;
-    } catch (error) {
-      throw invalid(`${where}: ${reference}: ${error instanceof Error ? error.message : String(error)} Surface entities get the prefix app:.`);
-    }
-  };
-  return parsedLayout({ root: layout.root ? mapSurfaceTileEntities(layout.root, (entity) => resolve(entity, "root")) : null });
-};
-
-/** Resolve app names and validate the placed actors before any layout is stored. */
-export const checkLayoutAgainstRun = (view: RunView, input: SurfaceLayout): SurfaceLayout => {
-  const layout = resolveAppReferences(view, input);
-  for (const reference of surfaceTileEntities(layout.root)) {
-    if (isActorReference(reference)) surfaceActorOf(view, reference, "root");
-  }
-  return layout;
-};
-
-const currentLayout = (view: RunView): SurfaceLayout => {
-  const state = view.pluginStates.find((entry) => entry.pluginId === ORCHESTRATION_PLUGIN_ID && entry.scope.kind === "run")?.state;
-  return state === undefined || state === null ? { root: null } : surfaceLayoutOf(state);
-};
-
-/** Splits the root once: the existing arrangement keeps weight 1, the placed tile gets its own. */
-const placed = (view: RunView, request: SurfacePlacementRequest): SurfaceLayout | undefined => {
-  const current = currentLayout(view);
-  const [tile] = surfaceTileEntities(checkLayoutAgainstRun(view, parsedLayout({ root: { entity: request.entity } })).root);
-  if (surfaceTileEntities(current.root).includes(tile!)) return undefined;
-  const root = current.root === null ? { entity: tile! } : {
-    direction: request.direction ?? "horizontal",
-    weights: [1, request.weight ?? 1],
-    children: [current.root, { entity: tile! }],
-  };
-  return parsedLayout({ root });
-};
-
-export const placeOnSurface = (runtime: () => Orchestration): SurfacePlacement => ({
-  place: (context: CommandContext, runId: string, request: SurfacePlacementRequest) => {
-    const layout = placed(runtime().view(runId), request);
-    if (!layout) return { placed: false };
-    runtime().replacePluginState(context, runId, { pluginId: ORCHESTRATION_PLUGIN_ID, scope: { kind: "run" }, state: layout });
-    return { placed: true };
-  },
-});
-
-const placeSchema = Type.Object({
-  entity: Type.String({ minLength: 1, description: "Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key" }),
-  direction: Type.Optional(Type.Union([Type.Literal("horizontal"), Type.Literal("vertical")], { description: "horizontal: to the right of the current layout (default); vertical: below it" })),
-  weight: Type.Optional(Type.Number({ exclusiveMinimum: 0, description: "Share of the placed tile against the existing arrangement's weight 1; default 1" })),
-}, { additionalProperties: false });
-
-export const createPlaceTool = (): RunFunction =>
-  defineRunFunction({
-    ...placeToolMetadata,
-    schema: placeSchema,
-    resultSchema: Type.Object({ placed: Type.Boolean() }, { additionalProperties: false }),
-    available: canDesignSurface,
-    run: ({ runtime, caller, context }, toolCallId, input) => placeOnSurface(() => runtime).place(context(toolCallId), caller.runId, input),
-  });
-
-export const createSurfaceTool = (): RunFunction =>
-  defineRunFunction({
-    ...surfaceToolMetadata,
-    schema: surfaceLayoutSchema,
-    resultSchema: Type.Null(),
-    available: canDesignSurface,
-    run: ({ runtime, caller, context }, toolCallId, input) => {
-      const view = runtime.view(caller.runId);
-      const layout = checkLayoutAgainstRun(view, parsedLayout(input));
-      runtime.replacePluginState(context(toolCallId), caller.runId, {
-        pluginId: ORCHESTRATION_PLUGIN_ID,
-        scope: { kind: "run" },
-        state: layout,
-      });
-      return null;
-    },
-  });
-
-export const createSurfaceToolContributor = (): ToolContributor => ({
-  name: "ragents.orchestration.surface",
-  descriptors: [toolDescriptorFrom(surfaceToolMetadata, canDesignSurface), toolDescriptorFrom(placeToolMetadata, canDesignSurface)],
-  tools: () => [createSurfaceTool(), createPlaceTool()],
-});

package/plugins/ragents.orchestration/surface.hbs

@@ -1,39 +0,0 @@
-## Arranging the tiled work surface
-
-The work surface of a run is a grid of tiles that fills the viewport. Each tile shows one actor or
-one activated mini-app. There is no other arrangement and no pan, zoom or free placement. Use
-`context.functions.canvas_layout_replace` from TypeScript to set the arrangement, and read its exact
-input type with `typescript_api` before the first call.
-
-`root` is the whole arrangement and replaces the stored one; it is the only parameter. A tile is
-{entity:"@helper"} or {entity:"app:@workspace/main"}. A split is {direction, weights, children} with
-direction "horizontal" (left/right) or "vertical" (top/bottom), two positive weights and exactly two
-children, each of which may be a split again. `root:null` clears the surface.
-
-App left, chat right at 50:50:
-{root:{direction:"horizontal",weights:[1,1],children:[
-  {entity:"app:@workspace/main"},{entity:"@helper"}
-]}}. One tile above two tiles at 2:1:
-{root:{direction:"vertical",weights:[2,1],children:[{entity:"@lead"},
-  {direction:"horizontal",weights:[1,1],children:[{entity:"@first"},{entity:"@second"}]}
-]}}. Resolve the actual actor and app names before calling; the example names are not existing
-participants.
-
-To add one tile without replacing what is arranged, `context.functions.canvas_layout_place({ entity })`
-splits the current layout once and puts the entity to its right, or below with `direction: "vertical"`;
-`weight` is its share against the existing arrangement's weight 1. An entity the layout shows already
-stays where it is. A run script started inside a running run (`start.embedded`) uses place, not replace.
-
-An actor tile carries {entity:"@helper",chatInput:false} when its chat composer should stay hidden.
-That changes neither permissions nor the inspector. Mini-app tiles have no chatInput.
-
-Activate actor programs before placing their views. Reference a view as `app:@handle/view-key` or
-`app:program-name/view-key`, using the handle, program name and view key you chose. The server
-resolves the actual view ID and rejects unknown views before storing the layout. Do not invent or
-copy generated view IDs. `actor_view_set_visibility` uses the same names without the `app:` prefix.
-
-Place what the user needs to see side by side and update the arrangement when the work changes.
-Participants you do not place stay reachable through the run header and can be dragged onto a tile
-there. Users can move, resize and remove tiles themselves; their personal arrangement takes
-precedence until they reset it, so do not resend a layout to fight it. The user takes part through
-the chat and needs no tile of their own.

package/plugins/ragents.orchestration/tiled-layout.ts

@@ -1,55 +0,0 @@
-import { surfaceEntityKey, surfaceEntityOf, type SurfaceTileNode } from "./contract.js";
-
-export type { SurfaceTileNode } from "./contract.js";
-
-export const MAX_SURFACE_TILE_DEPTH = 16;
-export const MAX_SURFACE_TILES = 64;
-
-export const surfaceTileNodeOf = (input: unknown): SurfaceTileNode => {
-  const entities = new Set<string>();
-  const parse = (value: unknown, where: string, depth: number): SurfaceTileNode => {
-    if (depth > MAX_SURFACE_TILE_DEPTH) throw new Error(`${where}: at most ${MAX_SURFACE_TILE_DEPTH} nested splits are allowed`);
-    if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`${where} must be a tile or a split`);
-    const node = value as Record<string, unknown>;
-    if (Object.hasOwn(node, "entity")) {
-      if (Object.keys(node).some((key) => key !== "entity" && key !== "chatInput")) throw new Error(`${where}: a tile carries only entity and chatInput; a split direction, weights and children`);
-      if (typeof node.entity !== "string") throw new Error(`${where}.entity must be @handle or app:<name>/<view>`);
-      const entity = surfaceEntityOf(node.entity);
-      const key = surfaceEntityKey(entity);
-      if (node.chatInput !== undefined && (entity.kind !== "actor" || typeof node.chatInput !== "boolean")) {
-        throw new Error(`${where}.chatInput is only allowed for actors, as a boolean`);
-      }
-      if (entities.has(key)) throw new Error(`${where}: ${key} is placed as a tile more than once`);
-      entities.add(key);
-      if (entities.size > MAX_SURFACE_TILES) throw new Error(`At most ${MAX_SURFACE_TILES} tiles are allowed`);
-      return node.chatInput === undefined ? { entity: key } : { entity: key, chatInput: node.chatInput as boolean };
-    }
-    if (Object.keys(node).some((key) => !["direction", "weights", "children"].includes(key))) throw new Error(`${where}: a split carries only direction, weights and children`);
-    if (node.direction !== "horizontal" && node.direction !== "vertical") throw new Error(`${where}.direction must be horizontal or vertical`);
-    if (!Array.isArray(node.weights) || node.weights.length !== 2 || node.weights.some((weight) => typeof weight !== "number" || !Number.isFinite(weight) || weight <= 0)) {
-      throw new Error(`${where}.weights must contain exactly two finite positive numbers`);
-    }
-    if (!Array.isArray(node.children) || node.children.length !== 2) throw new Error(`${where}.children must contain exactly two tiles or splits`);
-    return {
-      direction: node.direction,
-      weights: [node.weights[0], node.weights[1]],
-      children: [parse(node.children[0], `${where}.children[0]`, depth + 1), parse(node.children[1], `${where}.children[1]`, depth + 1)],
-    };
-  };
-  return parse(input, "root", 0);
-};
-
-/** A tile hides the chat composer of its actor only when its leaf says chatInput: false. */
-export const surfaceTileChatInput = (root: SurfaceTileNode | null | undefined, entity: string): boolean =>
-  !root ? true : "entity" in root
-    ? root.entity !== entity || root.chatInput !== false
-    : surfaceTileChatInput(root.children[0], entity) && surfaceTileChatInput(root.children[1], entity);
-
-export const surfaceTileEntities = (root: SurfaceTileNode | null | undefined): string[] =>
-  !root ? [] : "entity" in root ? [root.entity] : root.children.flatMap(surfaceTileEntities);
-
-export const mapSurfaceTileEntities = (root: SurfaceTileNode, resolve: (entity: string) => string): SurfaceTileNode =>
-  "entity" in root ? { ...root, entity: resolve(root.entity) } : {
-    ...root,
-    children: [mapSurfaceTileEntities(root.children[0], resolve), mapSurfaceTileEntities(root.children[1], resolve)],
-  };

package/plugins/ragents.orchestration/web/ActorChatPreview.tsx

@@ -1,29 +0,0 @@
-import { ActorChat } from "./ActorChat";
-import { ActorChatControls } from "./ActorChatControls";
-import { ChatPanel, type Message } from "quassel";
-import { memo, useCallback } from "react";
-import type { FlowSelection } from "./FlowInspector";
-import type { RunActor, RunView } from "@ragents/web/run-view";
-
-export const ActorChatPreview = memo(function ActorChatPreview({ actor, view, primaryMessages, conversation, historyError, chatInput = true, running = false, onNavigate }: {
-  actor: RunActor;
-  view: RunView;
-  primaryMessages?: readonly Message[];
-  conversation?: readonly Message[];
-  historyError?: string;
-  chatInput?: boolean;
-  running?: boolean;
-  onNavigate: (selection: FlowSelection) => void;
-}) {
-  const focusableScroller = useCallback((element: HTMLDivElement | null) => {
-    if (!element) return;
-    element.tabIndex = 0;
-    element.setAttribute("role", "region");
-    element.setAttribute("aria-label", `Chat history of @${actor.handle}`);
-  }, [actor.handle]);
-  return <div className="flex min-h-[106px] w-full min-w-0 flex-1 flex-col overflow-hidden rounded-b-[16px] text-left" data-surface-scroll="true">
-    <ChatPanel className="flex-1" composer={<ActorChatControls actor={actor} view={view} composerVisible={chatInput} presentation="surface" running={running} />}>
-      <ActorChat actor={actor} view={view} presentation="surface" primaryMessages={primaryMessages} conversation={conversation} historyError={historyError} running={running} onNavigate={onNavigate} scrollerRef={focusableScroller} />
-    </ChatPanel>
-  </div>;
-});

package/plugins/ragents.orchestration/web/ActorShortcut.tsx

@@ -1,74 +0,0 @@
-import { useAccess } from "@ragents/web/AccessContext";
-import { useCallback, useId, useRef, useState } from "react";
-import { useSurfaceController, type SessionContext } from "@ragents/web/PluginRegistry";
-import { CodeIcon, UsersIcon } from "lucide-react";
-import { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from "@ragents/web/Toolbar";
-import { cn } from "@ragents/web/ui";
-import { FlowInspector, type FlowSelection } from "./FlowInspector";
-import { ActorPopout } from "./ActorPopout";
-import { actorTone, type RunActor, type RunView } from "@ragents/web/run-view";
-import { useSurfaceEntities } from "./surface-entities";
-import { SURFACE_TILE_DRAG_TYPE } from "./tile-docking";
-
-const shortcutIconClass = "grid size-[30px] flex-none place-items-center rounded-lg border border-foreground/15 text-foreground";
-
-const shortcutFillClass: Readonly<Record<string, string>> = {
-  agent: "bg-glass-agent",
-  primary: "bg-glass-primary",
-  script: "bg-glass-script",
-  app: "bg-glass-app",
-};
-
-export function ActorShortcut({ actor, view, session, open, onToggle, onClose, visible }: {
-  actor: RunActor;
-  view: RunView;
-  session: SessionContext;
-  open: boolean;
-  onToggle: () => void;
-  onClose: () => void;
-  visible: boolean;
-}) {
-  const staged = useSurfaceEntities(session.session.id).has(`@${actor.handle}`);
-  const technical = useAccess().can("runs.inspect");
-  const [visited, setVisited] = useState(false);
-  const buttonRef = useRef<HTMLButtonElement>(null);
-  const panelId = useId();
-  const surface = useSurfaceController();
-  const close = useCallback((restoreFocus = false) => {
-    onClose();
-    if (restoreFocus) buttonRef.current?.focus({ preventScroll: true });
-  }, [onClose]);
-
-  const inspect = (selection: FlowSelection) => {
-    if (!surface) throw new Error("The actor shortcut needs the surface controller.");
-    surface.acceptSelection(selection);
-    close();
-  };
-  const tone = actorTone(view, actor);
-  const label = actor.kind === "agent" ? `Chat with @${actor.handle}` : `Actor view of @${actor.handle}`;
-  const type = !technical ? "Agent" : actor.kind === "agent" ? "LLM agent" : "TypeScript actor";
-
-  return <div className="flex items-stretch [&[hidden]]:hidden" hidden={!visible}>
-    <ToolbarItem as="button" aria-controls={visited ? panelId : undefined} aria-expanded={open} aria-haspopup="dialog"
-      aria-label={`${actor.displayName || actor.handle}. ${type}: open ${label}`} className="font-bold"
-      data-tone={tone} data-staged={staged || undefined} onClick={() => { setVisited(true); onToggle(); }}
-      draggable={technical} onDragStart={(event) => {
-        if (!technical) { event.preventDefault(); return; }
-        event.dataTransfer.setData(SURFACE_TILE_DRAG_TYPE, `@${actor.handle}`);
-        event.dataTransfer.effectAllowed = "move";
-        close();
-      }}
-      ref={buttonRef} title={`${type}: open ${label}${technical ? ". Drag onto a tile to dock." : ""}`} type="button">
-      <span className={cn(shortcutIconClass, staged && shortcutFillClass[tone])}>{actor.kind === "agent" ? <UsersIcon size={20} /> : <CodeIcon size={20} />}</span>
-      <ToolbarCopy><ToolbarLabel>@{actor.handle}</ToolbarLabel><ToolbarText>{actor.displayName && actor.displayName !== actor.handle ? actor.displayName : type}</ToolbarText></ToolbarCopy>
-    </ToolbarItem>
-    {visited && <ActorPopout open={open} id={panelId} label={label} closeLabel={`Close ${label}`}
-      buttonRef={buttonRef} keepMounted onClose={close} width={actor.kind === "agent" ? 784 : 560} height={640} role="dialog">
-      <div className="min-h-0 min-w-0 flex-1 overflow-auto overscroll-contain">
-        <FlowInspector actorConversations={session.actorConversations} canGoBack={false} chatDisplay="popout" composerVisible
-          conversationError={session.conversationError} onBack={() => {}} onNavigate={inspect}
-          primaryMessages={session.messages} primaryRunning={session.running} selection={{ type: "actor", id: actor.id }} view={view} />
-      </div>
-    </ActorPopout>}
-  </div>;
-}

package/plugins/ragents.orchestration/web/ActorSurfaceControls.tsx

@@ -1,130 +0,0 @@
-import { useAccess } from "@ragents/web/AccessContext";
-import { useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
-import type { SessionContext, SessionHeaderContext } from "@ragents/web/PluginRegistry";
-import { UsersIcon } from "lucide-react";
-import { Input } from "@ragents/web/ui";
-import { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from "@ragents/web/Toolbar";
-import { actorVisibleOnSurface, type SurfaceViewPreferences } from "./surface-view-settings";
-import { chatPrimaryId, runViewFrom, type RunActor } from "@ragents/web/run-view";
-import { ActorPopout } from "./ActorPopout";
-import { ActorShortcut } from "./ActorShortcut";
-import { ACTOR_HEADER_MODES, ACTOR_HEADER_MODE_LABELS, actorOnStage, actorVisibleInHeader, saveActorHeaderMode, useActorHeaderMode, type ActorHeaderMode } from "./actor-header-settings";
-import { useSurfaceEntities } from "./surface-entities";
-
-export interface ActorSurfaceControlsProps {
-  session: SessionContext;
-  appActorIds: ReadonlySet<string>;
-  preferences: SurfaceViewPreferences;
-  onPreferencesChange: (preferences: SurfaceViewPreferences) => void;
-}
-
-const nameClass = "min-w-0 max-w-full text-left font-semibold [overflow-wrap:anywhere]";
-
-const actorType = (actor: RunActor) => actor.kind === "human" ? "User" : actor.kind === "agent" ? "LLM agent" : "TypeScript actor";
-const actorStatus = (actor: RunActor) => actor.lifecycle?.kind === "running" ? "Working" : actor.lifecycle?.kind === "stopped" ? "Stopped" : actor.lifecycle?.kind === "idle" ? "Ready" : "";
-
-export function filterSurfaceActors(actors: readonly RunActor[], appActorIds: ReadonlySet<string>, query: string): readonly RunActor[] {
-  const words = query.trim().toLocaleLowerCase("en-US").split(/\s+/).filter(Boolean);
-  return actors.filter((actor) => {
-    const text = [`@${actor.handle}`, actor.displayName, actor.kind, actorType(actor), actor.lifecycle?.kind, actorStatus(actor), appActorIds.has(actor.id) ? "Mini-app" : ""].join(" ").toLocaleLowerCase("en-US");
-    return words.every((word) => text.includes(word));
-  });
-}
-
-export function ActorShortcuts({ session }: SessionHeaderContext) {
-  const inspect = useAccess().can("runs.inspect");
-  const [openKey, setOpenKey] = useState<string>();
-  const close = useCallback(() => setOpenKey(undefined), []);
-  const mode = useActorHeaderMode(session.session.id);
-  const stage = useSurfaceEntities(session.session.id);
-  const view = runViewFrom(session.runView);
-  const actors = useMemo(() => view?.actors.filter((actor) => actor.kind !== "human" && (inspect || actor.kind === "agent")) ?? [], [inspect, view]);
-  const primaryId = view ? chatPrimaryId(view) : undefined;
-  const shown = useCallback((actor: RunActor) => actorVisibleInHeader(actor, mode, actorOnStage(actor, primaryId, stage)), [mode, stage, primaryId]);
-  useEffect(() => {
-    if (openKey && !actors.some((actor) => `${session.session.id}:${actor.id}` === openKey && shown(actor))) close();
-  }, [actors, close, openKey, session.session.id, shown]);
-  if (!view || actors.length === 0) return null;
-
-  return <nav aria-label="Actors of the run" className="flex min-w-0 flex-none items-stretch">
-    {actors.map((actor) => {
-      const key = `${session.session.id}:${actor.id}`;
-      return <ActorShortcut actor={actor} key={key} onClose={close}
-        onToggle={() => setOpenKey((current) => current === key ? undefined : key)}
-        open={openKey === key} session={session} view={view} visible={shown(actor)} />;
-    })}
-  </nav>;
-}
-
-const PUBLIC_ACTOR_HEADER_MODES: readonly ActorHeaderMode[] = ["active", "visible", "all"];
-
-export function ActorHeaderModeControl({ runId }: { runId: string }) {
-  const inspect = useAccess().can("runs.inspect");
-  const mode = useActorHeaderMode(runId);
-  const modes = inspect ? ACTOR_HEADER_MODES : PUBLIC_ACTOR_HEADER_MODES;
-  const next = modes[(modes.indexOf(mode) + 1) % modes.length];
-  const label = `Actor display: ${ACTOR_HEADER_MODE_LABELS[mode]}. Switch to ${ACTOR_HEADER_MODE_LABELS[next]}`;
-  return <ToolbarItem as="button" aria-label={label} className="w-[120px] max-w-[120px] min-w-[120px] flex-[0_0_120px]" onClick={() => saveActorHeaderMode(runId, next)} title={label} type="button">
-    <ToolbarCopy><ToolbarLabel>Display</ToolbarLabel><ToolbarText>{ACTOR_HEADER_MODE_LABELS[mode]}</ToolbarText></ToolbarCopy>
-  </ToolbarItem>;
-}
-
-export function ActorSurfaceControls({ session, appActorIds, preferences, onPreferencesChange }: ActorSurfaceControlsProps) {
-  const [open, setOpen] = useState(false);
-  const [query, setQuery] = useState("");
-  const buttonRef = useRef<HTMLButtonElement>(null);
-  const panelId = useId();
-  const runView = runViewFrom(session.runView);
-  const actors = runView?.actors;
-  const filtered = useMemo(() => filterSurfaceActors(actors ?? [], appActorIds, query), [actors, appActorIds, query]);
-  const close = useCallback((restoreFocus = false) => {
-    setOpen(false);
-    if (restoreFocus) buttonRef.current?.focus({ preventScroll: true });
-  }, []);
-
-  useEffect(() => { close(); setQuery(""); }, [session.session.id, close]);
-
-  const label = `Actors \u00b7 ${actors?.length ?? 0}`;
-  return <div className="flex h-full min-w-0 flex-none items-stretch">
-    <ToolbarItem as="button" ref={buttonRef} aria-controls={open ? panelId : undefined} aria-expanded={open}
-      aria-label={label} title={label} onClick={() => setOpen((value) => !value)} type="button">
-      <UsersIcon size={20} /><ToolbarText>Actors</ToolbarText>
-    </ToolbarItem>
-    {open && <ActorPopout open id={panelId} label="Actors of the run" closeLabel="Close actor list"
-      buttonRef={buttonRef} onClose={close} width={460} height={460}
-      placement="bottom" focusInput role="region">
-      <div className="flex flex-none items-center gap-2.5 p-2.5">
-        <Input className="flex-1" aria-label="Search actors" onChange={(event) => setQuery(event.target.value)} placeholder="Search handle, type or status ..." type="search" value={query} />
-        <span className="flex-none whitespace-nowrap text-[0.68rem] text-muted-foreground" role="status">{filtered.length} of {actors?.length ?? 0}</span>
-      </div>
-      <ActorSurfaceList actors={filtered} appActorIds={appActorIds} primaryActorId={runView?.primaryActorId} onPreferencesChange={onPreferencesChange} preferences={preferences} />
-      <p className="flex-none border-t border-border-soft px-2.5 py-2.5 text-[0.68rem] text-muted-foreground">Personal view of this run</p>
-    </ActorPopout>}
-  </div>;
-}
-
-export function ActorSurfaceList({ actors, appActorIds, primaryActorId, onPreferencesChange, preferences }: {
-  actors: readonly RunActor[];
-  appActorIds: ReadonlySet<string>;
-  primaryActorId?: string | null;
-  onPreferencesChange: (preferences: SurfaceViewPreferences) => void;
-  preferences: SurfaceViewPreferences;
-}) {
-  return <div className="min-h-0 flex-1 overflow-auto overscroll-contain px-2.5">
-    {actors.length === 0 ? <p className="text-muted-foreground">No matching actors.</p> : <ul className="list-none">{actors.map((actor) => <li className="grid grid-cols-[minmax(0,1fr)_auto] items-center gap-2.5 border-b border-border-soft py-1.5" key={actor.id}>
-      <div className="grid min-w-0 gap-0.5 leading-[1.3]">
-        <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5">
-          <span className={nameClass}>@{actor.handle}</span>
-          {actor.displayName !== actor.handle && <span className="min-w-0 max-w-full text-[0.7rem] [overflow-wrap:anywhere]">{actor.displayName}</span>}
-        </div>
-        <span className="flex flex-wrap items-center gap-x-2 gap-y-0.5 text-[0.66rem] text-muted-foreground">
-          <span>{actorType(actor)}</span>{actorStatus(actor) && <span>{actorStatus(actor)}</span>}{appActorIds.has(actor.id) && <span className="text-primary">Mini-app</span>}
-        </span>
-      </div>
-      {actor.kind !== "human" && <label className="flex cursor-pointer items-center gap-[5px] whitespace-nowrap text-[0.68rem]">
-        <input aria-label={`Show @${actor.handle} on the surface`} checked={actorVisibleOnSurface(actor, appActorIds, preferences, primaryActorId)} onChange={(event) => onPreferencesChange({ ...preferences, actorVisibility: { ...preferences.actorVisibility, [actor.id]: event.target.checked } })} type="checkbox" />
-        <span>Surface</span>
-      </label>}
-    </li>)}</ul>}
-  </div>;
-}

package/plugins/ragents.orchestration/web/ActorTile.tsx

@@ -1,23 +0,0 @@
-import type { CardSectionContribution, EntityReference, SessionContext, SessionNavigation } from "@ragents/web/PluginRegistry";
-import { ActorChatPreview } from "./ActorChatPreview";
-import { cardSectionsClass } from "./constants";
-import type { RunActor, RunView } from "@ragents/web/run-view";
-
-export function ActorTile({ actor, view, cardSections, chatInput, session, navigation, onSelect }: {
-  actor: RunActor;
-  view: RunView;
-  cardSections: readonly CardSectionContribution[];
-  chatInput?: boolean;
-  session: SessionContext;
-  navigation: SessionNavigation;
-  onSelect: (selection: EntityReference) => void;
-}) {
-  return <div className="flex flex-col overflow-hidden has-[>[data-slot=card-sections]:not(:empty)]:min-h-[260px] has-[[data-chat=actions]:not(:empty)]:min-h-[260px]">
-    <ActorChatPreview actor={actor} view={view} chatInput={chatInput} running={actor.lifecycle?.kind === "running"}
-      conversation={session.actorConversations?.[actor.id]} historyError={session.conversationError}
-      onNavigate={onSelect} primaryMessages={actor.id === view.primaryActorId ? session.messages : undefined} />
-    <div className={`${cardSectionsClass} max-h-[45%] flex-[0_1_auto] overflow-auto overscroll-contain`} data-slot="card-sections">
-      {cardSections.map(({ id, Section }) => <Section actor={actor} key={id} navigation={navigation} session={session} />)}
-    </div>
-  </div>;
-}