@schlenkr/ragents 0.1.5 → 0.1.7

package/plugins/ragents.actor-programs/web/ActorViewFrame.tsx

@@ -1,14 +1,15 @@
-import { useAccess } from "@aicontainer/web/AccessContext";
-import { cn } from "@aicontainer/web/ui";
-import { useResolvedTheme } from "@aicontainer/web/theme";
+import { hostInputEnabled, isRunPanelKeyboardMessage, relayFrameInput } from "@ragents/web/run-panel/input-bridge";
+import { useAccess } from "@ragents/web/AccessContext";
+import { cn } from "@ragents/web/ui";
+import { useResolvedTheme } from "@ragents/web/theme";
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import type { RunApp, RunAppInvocation, ActorProgramsApi } from "./api";
 import { latestInvocation } from "./invocations";
-import type { SessionContext } from "@aicontainer/web/PluginRegistry";
-import { sendActorMessage } from "@aicontainer/plugins/ragents.orchestration/web/api";
+import type { SessionContext } from "@ragents/web/PluginRegistry";
+import { sendActorMessage } from "@ragents/web/api";
 import { chatSnapshotOf, resolveChatActor } from "./chat-state";
-import { getAttachmentCapabilities } from "@aicontainer/web/chat/useAttachmentCapabilities";
-import type { ChatSnapshot } from "../client-ui/contracts";
+import { getAttachmentCapabilities } from "@ragents/web/chat/useAttachmentCapabilities";
+import type { ChatSnapshot } from "@ragents/web/actor-programs/client-ui/contracts";
 import {
   RUN_APP_BRIDGE_VERSION,
   RUN_APP_CHAT_ACK,
@@ -201,6 +202,9 @@ export function ActorViewFrame({
     installedApp: RunApp,
   ) => {
     if (generation !== bridgeGenerationRef.current || port !== portRef.current) return;
+    if (relayFrameInput(window, value, (message) => {
+      if (generation === bridgeGenerationRef.current && port === portRef.current) port.postMessage(message);
+    })) return;
     const message = value as { type?: unknown; version?: unknown } | null;
     if (message?.type === RUN_APP_CONNECTED && message.version === RUN_APP_BRIDGE_VERSION) {
       bridgeConnectedRef.current = true;
@@ -290,6 +294,7 @@ export function ActorViewFrame({
       type: RUN_APP_READY,
       version: RUN_APP_BRIDGE_VERSION,
       theme: themeRef.current,
+      hostInput: hostInputEnabled(window),
       app: {
         id: installedApp.id,
         actorId: installedApp.actorId,
@@ -319,11 +324,11 @@ export function ActorViewFrame({
       else pendingPort = port;
     };
     const receiveReady = (event: MessageEvent<unknown>) => {
-      const data = event.data as { type?: unknown; version?: unknown; token?: unknown } | null;
+      const data = event.data as { type?: unknown; version?: unknown; token?: unknown; keyboard?: unknown } | null;
       if (event.source === frame.contentWindow && event.origin === "null"
         && data?.type === "ragents.app.escape" && data.version === RUN_APP_BRIDGE_VERSION
         && data.token === bridgeToken) {
-        window.dispatchEvent(new KeyboardEvent("keydown", { key: "Escape", bubbles: true, cancelable: true }));
+        window.dispatchEvent(new KeyboardEvent("keydown", { ...(isRunPanelKeyboardMessage(data.keyboard) ? data.keyboard.event : { key: "Escape" }), bubbles: true, cancelable: true }));
         return;
       }
       if (event.source !== frame.contentWindow
@@ -453,7 +458,7 @@ export function ActorViewFrame({
           className={cn("absolute inset-0 h-full w-full min-h-0 min-w-0 border-0", compact ? "bg-transparent" : "bg-background")}
           ref={iframeRef}
           referrerPolicy="no-referrer"
-          sandbox="allow-scripts allow-downloads"
+          sandbox="allow-scripts allow-forms allow-downloads"
           aria-label={app.title}
           title=""
         />

package/plugins/ragents.actor-programs/web/AppsPanel.tsx

@@ -1,7 +1,7 @@
-import { useAccess } from "@aicontainer/web/AccessContext";
+import { useAccess } from "@ragents/web/AccessContext";
 import { ArrowLeftIcon, LayoutGridIcon } from "lucide-react";
-import { Alert, Badge, Button, cn, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, Spinner } from "@aicontainer/web/ui";
-import { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from "@aicontainer/web/Toolbar";
+import { Alert, Badge, Button, cn, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, Spinner } from "@ragents/web/ui";
+import { ToolbarCopy, ToolbarItem, ToolbarLabel, ToolbarText } from "@ragents/web/Toolbar";
 import {
   useCallback,
   useEffect,
@@ -10,16 +10,20 @@ import {
   useState,
   type PropsWithChildren,
 } from "react";
-import { QuestionCard } from "@aicontainer/web/chat/QuestionCard";
-import { ACTOR_PROGRAMS_STATE_ID } from "../contract";
-import type {
-  SessionContext,
-  SessionHeaderContext,
-  WorkspaceTabContext,
-} from "@aicontainer/web/PluginRegistry";
-import { runViewFrom, type RunAction } from "@aicontainer/plugins/ragents.orchestration/web/contract";
-import { useStageEntities } from "@aicontainer/plugins/ragents.orchestration/web/canvas-stage";
-import { CANVAS_TILE_DRAG_TYPE } from "@aicontainer/plugins/ragents.orchestration/web/tile-docking";
+import { askPayloadOf, ASK_PLUGIN_ID } from "@ragents/plugins/ragents.ask/ask-payload";
+import { answerQuestion } from "@ragents/plugins/ragents.ask/web/api";
+import { QuestionCard } from "@ragents/plugins/ragents.ask/web/QuestionCard";
+import { ACTOR_PROGRAMS_STATE_ID } from "@ragents/host/plugin-support/actor-programs/contract";
+import {
+  useSurfaceController,
+  type SessionContext,
+  type SessionHeaderContext,
+  type WorkspaceTabContext,
+} from "@ragents/web/PluginRegistry";
+import { runViewFrom, type RunAction } from "@ragents/web/run-view";
+import { useSurfaceEntities } from "@ragents/plugins/ragents.orchestration/web/surface-entities";
+import { SURFACE_TILE_DRAG_TYPE } from "@ragents/plugins/ragents.orchestration/web/tile-docking";
+import { ProgramSlotContext, type ProgramSlot } from "@ragents/plugins/ragents.orchestration/web/program-slot";
 import {
   type RunApp,
   type RunAppInvocation,
@@ -28,7 +32,7 @@ import {
   type RunScriptTool,
 } from "./api";
 import type { JsonValue } from "./bridge";
-import { ProgramSource } from "./ProgramSource";
+import { actorProgramSourceView, ProgramSource } from "./ProgramSource";
 import { FunctionForm } from "./FunctionForm";
 import { ExpandIcon } from "./ExpandIcon";
 import { actorProgramsRevision } from "./state-revision";
@@ -82,7 +86,7 @@ export function ActorProgramsProvider({
   const closeFullscreen = useCallback(() => setFullscreen(undefined), []);
   const openFullscreen = useCallback((appId: string) => {
     if (!actorProgramApps(session).some((app) => app.id === appId && app.app.visible !== false)) {
-      throw new Error("Die Actor-Ansicht ist nicht auf dem Canvas verfügbar.");
+      throw new Error("Die Actor-Ansicht ist nicht auf der Fläche verfügbar.");
     }
     setFullscreen({ runId, appId });
   }, [runId, session]);
@@ -176,7 +180,18 @@ export function ActorProgramsProvider({
     refresh,
     runId,
   }), [api, error, fullscreenAppId, invoke, listing, openFullscreen, closeFullscreen, refresh, runId]);
-  return <ActorProgramsContext.Provider value={value}>{children}</ActorProgramsContext.Provider>;
+  const slot = useMemo<ProgramSlot>(() => ({
+    runId,
+    needsAnswer: (session, appId) => {
+      const app = listing?.apps.find((candidate) => candidate.id === appId);
+      return app !== undefined && pendingConfirmationFor(session, app) !== undefined;
+    },
+    openFullscreen,
+    source: (view, actorId) => actorProgramSourceView(api, view, actorId),
+  }), [api, listing, openFullscreen, runId]);
+  return <ActorProgramsContext.Provider value={value}>
+    <ProgramSlotContext.Provider value={slot}>{children}</ProgramSlotContext.Provider>
+  </ActorProgramsContext.Provider>;
 }
 
 export const actorProgramApps = (session: SessionContext) => actorProgramViews(session.runView);
@@ -190,7 +205,7 @@ export const pendingConfirmationFor = (
   const invocationIds = new Set(app.invocations
     .filter((invocation) => ACTIVE_STATUSES.has(invocation.status))
     .map((invocation) => invocation.id));
-  return view.actions.find((action) => action.kind === "question"
+  return view.actions.find((action) => action.owner === ASK_PLUGIN_ID
     && action.status === "pending"
     && action.askedBy === view.ownerId
     && action.parameters.source === ACTOR_PROGRAMS_STATE_ID
@@ -207,7 +222,7 @@ export function HostConfirmation({ action, session }: { action: RunAction; sessi
     setBusy(true);
     setError(undefined);
     try {
-      await session.respond(action.id, text);
+      await answerQuestion(session.session.id, action.id, text);
     } catch (caught) {
       setError(caught instanceof Error ? caught.message : String(caught));
       setBusy(false);
@@ -224,12 +239,8 @@ export function HostConfirmation({ action, session }: { action: RunAction; sessi
         ? <p className="text-xs text-muted-foreground">Antwort wird verarbeitet</p>
         : (
           <QuestionCard
-            onAnswer={access.can("runs.write") ? (text) => void answer(text) : undefined}
-            question={{
-              callId: action.id,
-              options: action.question?.options ?? [],
-              multi: action.question?.multi ?? false,
-            }}
+            onAnswer={access.can("runs.write") ? (text: string) => void answer(text) : undefined}
+            question={askPayloadOf(action.payload) ?? { question: action.title, options: [], multi: false }}
             text={action.title}
           />
         )}
@@ -274,7 +285,7 @@ export function ToolsPanel({ active, navigation, selection, session }: Workspace
         <EmptyHeader>
           <EmptyMedia><IconTools /></EmptyMedia>
           <EmptyTitle>Funktion nicht mehr verfügbar</EmptyTitle>
-          <EmptyDescription>Das ausgewählte Actor-Funktion ist in diesem Lauf nicht mehr installiert.</EmptyDescription>
+          <EmptyDescription>Das ausgewählte Actor-Funktion ist in diesem Run nicht mehr installiert.</EmptyDescription>
         </EmptyHeader>
         <EmptyContent>
           <Button onClick={() => navigation.openTab(RUN_TOOLS_TAB_ID, null)} variant="outline">
@@ -334,7 +345,7 @@ export function ToolsPanel({ active, navigation, selection, session }: Workspace
         <EmptyHeader>
           <EmptyMedia><IconTools /></EmptyMedia>
           <EmptyTitle>Noch keine Funktionen</EmptyTitle>
-          <EmptyDescription>Von Agenten erstellte Actor-Funktionen dieses Laufs erscheinen hier.</EmptyDescription>
+          <EmptyDescription>Von Agenten erstellte Actor-Funktionen dieses Runs erscheinen hier.</EmptyDescription>
         </EmptyHeader>
       </Empty>
     );
@@ -365,9 +376,11 @@ export function ToolsPanel({ active, navigation, selection, session }: Workspace
   );
 }
 
-export function ActorProgramsHeader({ navigation, session }: SessionHeaderContext) {
+/** Ein Klick auf eine Mini-App wählt ihre Kachel auf der Fläche; die Fläche ist der Flächen-Controller des Orchestrierungs-Plugins. */
+export function ActorProgramsHeader({ session }: SessionHeaderContext) {
   const canArrange = useAccess().can("runs.inspect");
-  const stage = useStageEntities(session.session.id);
+  const surface = useSurfaceController();
+  const stage = useSurfaceEntities(session.session.id);
   const { closeFullscreen, fullscreenAppId, openFullscreen } = useActorPrograms();
   const apps = actorProgramApps(session).filter((app) => app.app.visible !== false);
   if (apps.length === 0) return null;
@@ -384,11 +397,15 @@ export function ActorProgramsHeader({ navigation, session }: SessionHeaderContex
           draggable={canArrange}
           onDragStart={(event) => {
             if (!canArrange) { event.preventDefault(); return; }
-            event.dataTransfer.setData(CANVAS_TILE_DRAG_TYPE, `app:${app.id}`);
+            event.dataTransfer.setData(SURFACE_TILE_DRAG_TYPE, `app:${app.id}`);
             event.dataTransfer.effectAllowed = "move";
             closeFullscreen();
           }}
-          onClick={() => { closeFullscreen(); navigation.revealEntity({ type: "run-app", id: app.id }); }}
+          onClick={() => {
+            if (!surface) throw new Error("Die App-Zugänge brauchen den Flächen-Controller des Orchestrierungs-Plugins.");
+            closeFullscreen();
+            surface.acceptSelection({ type: "run-app", id: app.id });
+          }}
           aria-label={`Mini-App: ${app.title} von @${app.actorHandle}`}
           title={`Mini-App: ${app.title} von @${app.actorHandle}${canArrange ? ". Zum Andocken auf eine Kachel ziehen." : ""}`}
           type="button"

package/plugins/ragents.actor-programs/web/EmbeddedApps.tsx

@@ -1,19 +1,17 @@
-import { useAccess } from "@aicontainer/web/AccessContext";
-import { cn, Spinner } from "@aicontainer/web/ui";
-import { isRecord } from "@aicontainer/web/lib/guards";
-import { runActorFrom } from "@aicontainer/plugins/ragents.orchestration/web/contract";
+import { useAccess } from "@ragents/web/AccessContext";
+import { Spinner } from "@ragents/web/ui";
+import { isRecord } from "@ragents/web/lib/guards";
+import { runActorFrom } from "@ragents/web/run-view";
 import type {
-  CanvasElementContext,
-  CanvasElementDefinition,
+  SurfaceElementContext,
+  SurfaceElementDefinition,
   CardSectionContext,
   SessionContext,
-} from "@aicontainer/web/PluginRegistry";
+} from "@ragents/web/PluginRegistry";
 import { HostConfirmation, pendingConfirmationFor, actorProgramApps, useActorPrograms } from "./AppsPanel";
 import { ActorViewFrame } from "./ActorViewFrame";
 import { FunctionForm } from "./FunctionForm";
 
-const cardClass = "flex h-full min-h-0 min-w-0 flex-col overflow-hidden rounded-panel border border-glass-edge bg-glass-app shadow-card backdrop-blur-[8px] in-data-[surface=material]:rounded-[inherit] in-data-[surface=material]:border-0 in-data-[surface=material]:bg-transparent in-data-[surface=material]:shadow-none in-data-[surface=material]:backdrop-filter-none";
-
 export function ActorProgramToolCardSection({ actor, session }: CardSectionContext) {
   const inspect = useAccess().can("runs.inspect");
   const { listing } = useActorPrograms();
@@ -33,15 +31,15 @@ export function ActorProgramToolCardSection({ actor, session }: CardSectionConte
   );
 }
 
-export const actorProgramCanvasElements = (session: SessionContext): readonly CanvasElementDefinition[] =>
-  actorProgramApps(session).flatMap((module): CanvasElementDefinition[] => {
+export const actorProgramSurfaceElements = (session: SessionContext): readonly SurfaceElementDefinition[] =>
+  actorProgramApps(session).flatMap((module): SurfaceElementDefinition[] => {
     const rawPlacements = module.app.placements;
     const placement = Array.isArray(rawPlacements) ? rawPlacements.find((entry) => isRecord(entry) && entry.kind === "canvas") : undefined;
-    const canvas = isRecord(placement) ? placement : undefined;
-    if (canvas && typeof canvas.anchorActorId !== "string") {
-      throw new Error(`Die Canvas-Platzierung der Actor-Ansicht ${module.title} ist ungültig`);
+    const surface = isRecord(placement) ? placement : undefined;
+    if (surface && typeof surface.anchorActorId !== "string") {
+      throw new Error(`Die Flächenplatzierung der Actor-Ansicht ${module.title} ist ungültig`);
     }
-    if (canvas && canvas.anchorActorId !== module.actorId) throw new Error(`Die Ansicht ${module.title} gehört zu @${module.actorHandle}.`);
+    if (surface && surface.anchorActorId !== module.actorId) throw new Error(`Die Ansicht ${module.title} gehört zu @${module.actorHandle}.`);
     return [{
       id: module.id,
       title: module.title,
@@ -52,7 +50,7 @@ export const actorProgramCanvasElements = (session: SessionContext): readonly Ca
     }];
   });
 
-export function ActorProgramCanvasElement({ definition, session }: CanvasElementContext) {
+export function ActorProgramSurfaceElement({ definition, session }: SurfaceElementContext) {
   const { api, invoke, listing, runId } = useActorPrograms();
   const app = listing?.apps.find((candidate) => candidate.id === definition.id);
   const confirmation = app ? pendingConfirmationFor(session, app) : undefined;
@@ -74,7 +72,7 @@ export function ActorProgramCanvasElement({ definition, session }: CanvasElement
     </div>
   );
   return (
-    <article aria-label={title} className={cn(cardClass, "w-full rounded-none border-0 bg-transparent shadow-none backdrop-filter-none")}>
+    <article aria-label={title} className="flex h-full min-h-0 w-full min-w-0 flex-col overflow-hidden">
       <div className="flex min-h-0 flex-1 flex-col overflow-hidden [&>[data-slot=host-confirmation]]:max-h-[65%] [&>[data-slot=host-confirmation]]:flex-[0_1_auto] [&>[data-slot=host-confirmation]]:overflow-auto">
         {confirmation && <HostConfirmation action={confirmation} key={confirmation.id} session={session} />}
         {frame}

package/plugins/ragents.actor-programs/web/FullscreenHost.tsx

@@ -1,7 +1,7 @@
 import { useRef } from "react";
 import { XIcon } from "lucide-react";
-import type { SessionContext } from "@aicontainer/web/PluginRegistry";
-import { Button, Dialog, DialogContent, DialogTitle } from "@aicontainer/web/ui";
+import type { SessionContext } from "@ragents/web/PluginRegistry";
+import { Button, Dialog, DialogContent, DialogTitle } from "@ragents/web/ui";
 import { HostConfirmation, pendingConfirmationFor, actorProgramApps, useActorPrograms } from "./AppsPanel";
 import { ActorViewFrame } from "./ActorViewFrame";
 
@@ -15,7 +15,7 @@ export function FullscreenHost({ session }: { session: SessionContext }) {
   const title = entry.title;
   const confirmation = app ? pendingConfirmationFor(session, app) : undefined;
   return <Dialog key={`${runId}:${fullscreenAppId}`} open onOpenChange={(open) => { if (!open) closeFullscreen(); }}>
-    <DialogContent className="h-[calc(100%-2*clamp(16px,2vw,24px))] w-[calc(100%-2*clamp(16px,2vw,24px))] gap-0 bg-background p-0" initialFocus={closeRef} scope="canvas" showCloseButton={false} size="full">
+    <DialogContent className="h-[calc(100%-2*clamp(16px,2vw,24px))] w-[calc(100%-2*clamp(16px,2vw,24px))] gap-0 bg-background p-0" initialFocus={closeRef} scope="surface" showCloseButton={false} size="full">
     <header className="flex flex-none items-center gap-3 border-b border-border bg-card py-2 pr-3 pl-4">
       <DialogTitle className="min-w-0 flex-1 truncate text-[0.9rem]" render={<h2 />}>{title}</DialogTitle>
       <Button aria-label={`${title} Vollansicht schließen`} className="rounded-full" onClick={closeFullscreen} ref={closeRef} size="icon" title={`${title} Vollansicht schließen`} variant="outline"><XIcon /></Button>

package/plugins/ragents.actor-programs/web/FunctionForm.tsx

@@ -1,7 +1,7 @@
 import { useEffect, useRef, useState, type FormEvent } from "react";
-import { useAccess } from "@aicontainer/web/AccessContext";
-import { Button, cn, Input, Textarea } from "@aicontainer/web/ui";
-import type { SessionContext } from "@aicontainer/web/PluginRegistry";
+import { useAccess } from "@ragents/web/AccessContext";
+import { Button, cn, Input, Textarea } from "@ragents/web/ui";
+import type { SessionContext } from "@ragents/web/PluginRegistry";
 import type { RunAppInvocation, RunScriptTool } from "./api";
 import { HostConfirmation, pendingConfirmationFor, useActorPrograms } from "./AppsPanel";
 import { invokeActorFunction } from "./function-call";

package/plugins/ragents.actor-programs/web/ProgramSource.tsx

@@ -1,7 +1,9 @@
-import { useEffect, useState } from "react";
-import { SourceCode } from "@aicontainer/web/SourceCode";
-import { Alert, Button, cn, Spinner } from "@aicontainer/web/ui";
+import { useEffect, useState, type ReactNode } from "react";
+import { SourceCode } from "@ragents/web/SourceCode";
+import { Alert, Button, cn, Spinner } from "@ragents/web/ui";
+import type { RunView } from "@ragents/web/run-view";
 import type { ActorProgramSourceFile, ActorProgramsApi } from "./api";
+import { actorProgramSourceReference } from "./program-state";
 
 type SourceState =
   | { kind: "loading" }
@@ -79,3 +81,10 @@ export function ProgramSource({ api, moduleId, runId, revision, expandedByDefaul
     </section>
   );
 }
+
+/** The installed source of the actor's program, or nothing if the actor runs none. */
+export const actorProgramSourceView = (api: ActorProgramsApi, view: RunView, actorId: string): ReactNode => {
+  const program = actorProgramSourceReference(view, actorId);
+  return program && <ProgramSource api={api} expandedByDefault key={`${view.id}:${actorId}:${program.revision}`}
+    moduleId={program.name} revision={program.revision} runId={view.id} />;
+};

package/plugins/ragents.actor-programs/web/api.ts

@@ -1,7 +1,7 @@
-import { isRecord } from "@aicontainer/web/lib/guards";
-import { rpc } from "@aicontainer/web/rpc";
-import { withAccessToken } from "@aicontainer/web/access-token";
-import { actorProgramContracts } from "../contract";
+import { isRecord } from "@ragents/web/lib/guards";
+import { rpc } from "@ragents/web/rpc";
+import { withAccessToken } from "@ragents/web/access-token";
+import { actorProgramContracts } from "@ragents/host/plugin-support/actor-programs/contract";
 import {
   actorFunctionParameterTypes,
   type ActorFunctionParameterType,
@@ -313,7 +313,7 @@ export const actorProgramSourceFrom = (value: unknown): ActorProgramSourceFile[]
 
 export const actorProgramsListingFrom = (value: unknown): ActorProgramsListing => {
   if (!isRecord(value) || !Array.isArray(value.apps) || !Array.isArray(value.tools)) {
-    throw new Error("Die Run-Modul-Liste entspricht nicht dem Vertrag");
+    throw new Error("Die Liste der Actor-Programme entspricht nicht dem Vertrag");
   }
   return {
     apps: unique(value.apps.map(runAppFrom), (app) => app.id, "apps"),

package/plugins/ragents.actor-programs/web/bridge.ts

@@ -1,6 +1,5 @@
-import { isRecord } from "@aicontainer/web/lib/guards";
-import type { ChatAttachmentInput } from "@aicontainer/server/chat-events";
-import { parseChatAttachments } from "@aicontainer/server/chat-attachments";
+import { isRecord } from "@ragents/web/lib/guards";
+import { parseChatAttachments, type ChatAttachmentInput } from "quassel/events";
 
 export const RUN_APP_BRIDGE_VERSION = 1;
 

package/plugins/ragents.actor-programs/web/chat-state.ts

@@ -1,15 +1,16 @@
-import type { SessionContext } from "@aicontainer/web/PluginRegistry";
-import type { ChatSnapshot } from "../client-ui/contracts";
-import { actorChatMessages } from "@aicontainer/plugins/ragents.orchestration/web/actor-conversation";
-import { runViewFrom } from "@aicontainer/plugins/ragents.orchestration/web/run-view";
-import { programChatNotice } from "@aicontainer/web/chat/chat-target";
+import { actorByHandle } from "@ragents/engine/src/http/contracts";
+import type { SessionContext } from "@ragents/web/PluginRegistry";
+import type { ChatSnapshot } from "@ragents/web/actor-programs/client-ui/contracts";
+import { actorChatMessages } from "@ragents/web/actor-conversation";
+import { runViewFrom } from "@ragents/web/run-view";
+import { programChatNotice } from "@ragents/web/chat/chat-target";
 
 export const resolveChatActor = (session: SessionContext, target: string) => {
   const view = runViewFrom(session.runView);
-  if (!view || view.id !== session.session.id) throw new Error("Die Laufansicht für diesen Chat ist noch nicht verfügbar");
+  if (!view || view.id !== session.session.id) throw new Error("Die Run-Ansicht für diesen Chat ist noch nicht verfügbar");
   const actor = target === "primary"
     ? view.actors.find((entry) => entry.id === view.primaryActorId)
-    : view.actors.find((entry) => entry.handle === target.replace(/^@/, ""));
+    : actorByHandle(view.actors, target);
   if (!actor || actor.kind === "human") {
     const names = view.actors.filter((entry) => entry.kind !== "human").map((entry) => `@${entry.handle}`).join(", ");
     throw new Error(`Das Chat-Ziel ist nicht verfügbar. Erlaubt sind primary und: ${names || "noch keine Actors"}`);
@@ -23,7 +24,7 @@ export const chatSnapshotOf = (session: SessionContext, target: string): ChatSna
     const primary = actor.id === view.primaryActorId;
     const error = actor.kind === "script" ? programChatNotice : session.conversationError ?? (!session.connected
       ? "Die Verbindung zum Run ist unterbrochen"
-      : actor.lifecycle?.kind === "stopped" ? "Dieser Actor ist gestoppt und nimmt keine Eingaben mehr an" : undefined);
+      : actor.lifecycle?.kind === "stopped" ? `@${actor.handle} gestoppt: ${actor.lifecycle.reason}. Er nimmt keine Eingaben an, bis er neu gestartet wird` : undefined);
     return {
       owner: actor.id,
       messages: actorChatMessages(view, actor, session.messages, session.actorConversations?.[actor.id]),

package/plugins/ragents.actor-programs/web/index.tsx

@@ -3,11 +3,9 @@ import {
   type SessionProviderProps,
   type WebPlugin,
   type WebPluginDescriptor,
-} from "@aicontainer/web/PluginRegistry";
+} from "@ragents/web/PluginRegistry";
 import { createActorProgramsApi } from "./api";
-import { ORCHESTRATION_TAB_ID } from "@aicontainer/plugins/ragents.orchestration/web/constants";
 import {
-  actorProgramApps,
   RUN_TOOLS_TAB_ID,
   ActorProgramsHeader,
   ActorProgramsProvider,
@@ -16,9 +14,9 @@ import {
 } from "./AppsPanel";
 import { FullscreenHost } from "./FullscreenHost";
 import {
-  ActorProgramCanvasElement,
+  ActorProgramSurfaceElement,
   ActorProgramToolCardSection,
-  actorProgramCanvasElements,
+  actorProgramSurfaceElements,
 } from "./EmbeddedApps";
 
 export const ACTOR_PROGRAMS_PLUGIN_ID = "ragents.actor-programs";
@@ -51,7 +49,7 @@ const configuredPlugin = (descriptor: WebPluginDescriptor, routePrefix: string):
     SessionProvider: Provider,
     sessionHeaders: [{
       id: "ragents.actor-programs.quick-list",
-      placement: "canvas",
+      placement: "surface",
       order: 250,
       Header: ActorProgramsHeader,
     }],
@@ -60,19 +58,11 @@ const configuredPlugin = (descriptor: WebPluginDescriptor, routePrefix: string):
       order: 400,
       Section: ActorProgramToolCardSection,
     }],
-    canvasElements: [{
+    surfaceElements: [{
       id: "ragents.actor-programs.apps",
       order: 400,
-      select: actorProgramCanvasElements,
-      Element: ActorProgramCanvasElement,
-    }],
-    entityPresenters: [{
-      reveal: (entity, session) => {
-        if (entity.type !== "run-app") return undefined;
-        const entry = actorProgramApps(session).find((app) => app.id === entity.id);
-        if (!entry || entry.app.visible === false) return undefined;
-        return { tabId: ORCHESTRATION_TAB_ID, selection: entity };
-      },
+      select: actorProgramSurfaceElements,
+      Element: ActorProgramSurfaceElement,
     }],
     workspaceTabs: [
       {

package/plugins/ragents.actor-programs/web/program-state.ts

@@ -1,6 +1,6 @@
-import { ACTOR_PROGRAMS_STATE_ID, ACTOR_STATE_ID } from "../contract";
-import { isRecord } from "@aicontainer/web/lib/guards";
-import { runViewFrom } from "@aicontainer/plugins/ragents.orchestration/web/contract";
+import { ACTOR_PROGRAMS_STATE_ID, ACTOR_STATE_ID } from "@ragents/host/plugin-support/actor-programs/contract";
+import { isRecord } from "@ragents/web/lib/guards";
+import { runViewFrom } from "@ragents/web/run-view";
 import type { ActorProgramsListing } from "./api";
 import { isJsonValue } from "./bridge";
 

package/plugins/ragents.actor-programs/web/state-revision.ts

@@ -1,5 +1,5 @@
-import { ACTOR_PROGRAMS_STATE_ID, ACTOR_INVOCATIONS_STATE_ID, ACTOR_STATE_ID } from "../contract";
-import { runViewFrom } from "@aicontainer/plugins/ragents.orchestration/web/contract";
+import { ACTOR_PROGRAMS_STATE_ID, ACTOR_INVOCATIONS_STATE_ID, ACTOR_STATE_ID } from "@ragents/host/plugin-support/actor-programs/contract";
+import { runViewFrom } from "@ragents/web/run-view";
 
 export const actorProgramsRevision = (runView: unknown): string => {
   const view = runViewFrom(runView);

package/plugins/ragents.ask/ask-payload.ts

@@ -0,0 +1,25 @@
+export const ASK_PLUGIN_ID = "ragents.ask";
+
+export interface AskPayload {
+  question: string;
+  options: string[];
+  multi: boolean;
+  /** Der Actor, für den die Frage steht, wenn der Eigentümer des Runs sie außerhalb eines Turns stellt. */
+  recipient?: string;
+}
+
+const stringArrayOf = (value: unknown): string[] | undefined =>
+  Array.isArray(value) && value.every((entry) => typeof entry === "string") ? [...value] : undefined;
+
+export const askPayloadOf = (payload: unknown): AskPayload | undefined => {
+  if (typeof payload !== "object" || payload === null) return undefined;
+  const candidate = payload as Partial<AskPayload>;
+  const options = stringArrayOf(candidate.options);
+  if (typeof candidate.question !== "string" || !options) return undefined;
+  return {
+    question: candidate.question,
+    options,
+    multi: candidate.multi === true,
+    ...(typeof candidate.recipient === "string" ? { recipient: candidate.recipient } : {}),
+  };
+};

package/plugins/ragents.ask/contract.ts

@@ -1,10 +1,10 @@
 import { Type } from "typebox";
-import { defineOperation } from "@aicontainer/ragents/src/rpc/contract";
+import { defineOperation } from "@ragents/engine/src/rpc/contract";
 
 export const askContracts = {
   answer: defineOperation({
     id: "ragents.ask.answer",
-    description: "Eine Rückfrage des Laufs beantworten oder verwerfen. Rechte: runs.read und runs.write.",
+    description: "Eine Rückfrage des Runs beantworten oder verwerfen. Rechte: runs.read und runs.write.",
     rights: ["runs.read", "runs.write"],
     input: Type.Object({
       runId: Type.String({ minLength: 1, maxLength: 64, description: "Kennung des Runs" }),

package/plugins/ragents.ask/ragents-plugin.json

@@ -0,0 +1,7 @@
+{
+  "id": "ragents.ask",
+  "exports": {
+    "server": ["server/contract"],
+    "web": ["ask-payload", "web/QuestionCard", "web/api"]
+  }
+}

package/plugins/ragents.ask/server/answer-method.ts

@@ -1,4 +1,4 @@
-import { DomainError, implement, type MethodContribution } from "@aicontainer/ragents";
+import { DomainError, implement, type MethodContribution } from "@ragents/engine";
 import { askContracts } from "../contract.js";
 import type { RuntimeAskService } from "./ask-service.js";