@schlenkr/ragents 0.1.5 → 0.1.7

package/apps/web/src/PluginRegistry.tsx

@@ -7,18 +7,15 @@ import {
   type ComponentType,
   type PropsWithChildren,
   type ReactNode,
-  type Ref,
-  type WheelEventHandler,
 } from "react";
 import { useAccess } from "./AccessContext";
 import { unrestrictedAccess, type AccessContext } from "../../../packages/ragents/src/access";
-import { DETAIL_MODES } from "./chat/DetailModeSwitch";
-import type { ChatAttachmentInput, DetailMode, Message, ToolInfo } from "./chat/types";
+import { DETAIL_MODES, type ChatAttachmentInput, type DetailMode, type Message, type PendingAction, type ToolInfo, type ChatStartupStatus } from "quassel";
 import type { SessionInfo } from "./api";
 import type { ChatUserLocation } from "../../server/src/chat-context";
-import type { ChatStartupStatus } from "../../server/src/chat-events";
 import { CHAT_STEP_SCOPES, type ChatStepScope } from "../../server/src/plugin-support/chat-display-contract";
 import type { StartOptionState } from "../../server/src/plugin-support/start-options-contract";
+import type { OfferedMachines } from "./offered-machines";
 import {
   type ScriptStartEntry,
   type SkillStartEntry,
@@ -53,6 +50,8 @@ export interface StartOptionControlContext {
   disabled: boolean;
   error: string | undefined;
   setValue: (value: unknown) => Promise<void>;
+  /** Welche Rechner der Host für neue Runs anbietet; eine Option mit Rechnerwahl zeigt nur diese. */
+  machines: OfferedMachines;
 }
 
 export interface StartOptionBadgeContext {
@@ -62,7 +61,7 @@ export interface StartOptionBadgeContext {
 
 export interface StartOptionContribution {
   id: string;
-  placement?: "surface" | "composer";
+  placement?: "page" | "composer";
   Control?: ComponentType<StartOptionControlContext>;
   Badge?: ComponentType<StartOptionBadgeContext>;
 }
@@ -82,7 +81,7 @@ export interface EntryGuideContribution {
   Guide: ComponentType<EntryGuideContext>;
 }
 
-export interface ExtensionEvent {
+export interface PluginEvent {
   pluginId: string;
   type: string;
   payload?: unknown;
@@ -90,21 +89,19 @@ export interface ExtensionEvent {
 }
 
 export interface SessionContext {
-  centerMode: "chat" | "workflow";
   connected: boolean;
-  extensionEvents: readonly ExtensionEvent[];
+  pluginEvents: readonly PluginEvent[];
   messages: Message[];
   actorConversations?: Readonly<Record<string, readonly Message[]>>;
   conversationError?: string;
-  respond: (callId: string, payload: unknown) => Promise<void>;
   runView: unknown;
   running: boolean;
   startup?: ChatStartupStatus;
-  send: (text: string, attachments?: ChatAttachmentInput[]) => Promise<void>;
+  /** Mit entryId startet die Nachricht den Run über diese Skill-Vorlage und die Startoptionen, die er festlegt. */
+  send: (text: string, attachments?: ChatAttachmentInput[], entryId?: string) => Promise<void>;
   session: SessionInfo;
   /** Starts the run through a run script entry, without a message; the value becomes the script's start input. */
   start: (entryId: string, input: JsonValue | null) => Promise<void>;
-  stop: () => Promise<void>;
 }
 
 export interface EntityReference {
@@ -112,43 +109,39 @@ export interface EntityReference {
   id: string;
 }
 
-export interface CanvasController {
+/** Die Auswahl auf der Fläche: Kacheln, Actor-Zugänge und Pop-outs melden sie, die Fläche zeigt sie, der Chat meldet sie als Standort. */
+export interface SurfaceController {
   acceptSelection: (selection: EntityReference | undefined) => void;
   selection: EntityReference | undefined;
-  selectionRevision: number;
-  tabId: string;
 }
 
-export interface ChatSurfaceOptions {
+export interface ChatDisplayOptions {
   chatElementClassName?: string;
   chatScrollerRef?: (element: HTMLDivElement | null) => void;
-  nodeRef?: Ref<HTMLDivElement>;
-  onComposerWheel?: WheelEventHandler<HTMLElement>;
   toolbarLeft?: ReactNode;
-  toolbarRight?: ReactNode;
+  /** Steht statt des Verlaufs, solange gesetzt; die Eingabe bleibt bedienbar. */
+  notice?: ReactNode;
 }
 
-export interface CanvasCenterContext {
+export interface SurfaceCenterContext {
   runToolbarContainer: HTMLElement | null;
   toolbarContainer: HTMLElement | null;
   statusContainer: HTMLElement | null;
   cardSections: readonly CardSectionContribution[];
-  canvasElements: readonly CanvasElementContribution[];
+  surfaceElements: readonly SurfaceElementContribution[];
   navigation: SessionNavigation;
-  onCenterModeChange: (mode: SessionContext["centerMode"]) => void;
-  renderChat: (options?: ChatSurfaceOptions) => ReactNode;
+  renderChat: (options?: ChatDisplayOptions) => ReactNode;
   session: SessionContext;
   tabIds: readonly string[];
 }
 
-export interface CanvasContribution {
-  Center: ComponentType<CanvasCenterContext>;
-  /** Schmales RAgents-Panel (column.html) mit demselben Kontext; ohne Beitrag zeigt das Panel nur den Chat. */
-  Column?: ComponentType<CanvasCenterContext>;
-  tabId: string;
+export interface SurfaceContribution {
+  Center: ComponentType<SurfaceCenterContext>;
+  /** Das Run-Panel (run-panel.html) mit demselben Kontext; ohne Beitrag zeigt es nur den Chat. */
+  RunPanel?: ComponentType<SurfaceCenterContext>;
 }
 
-export interface CanvasElementDefinition {
+export interface SurfaceElementDefinition {
   id: string;
   visible?: boolean;
   title?: string;
@@ -157,17 +150,17 @@ export interface CanvasElementDefinition {
   data?: unknown;
 }
 
-export interface CanvasElementContext {
-  definition: CanvasElementDefinition;
+export interface SurfaceElementContext {
+  definition: SurfaceElementDefinition;
   navigation: SessionNavigation;
   session: SessionContext;
 }
 
-export interface CanvasElementContribution {
+export interface SurfaceElementContribution {
   id: string;
   order: number;
-  select: (session: SessionContext) => readonly CanvasElementDefinition[];
-  Element: ComponentType<CanvasElementContext>;
+  select: (session: SessionContext) => readonly SurfaceElementDefinition[];
+  Element: ComponentType<SurfaceElementContext>;
 }
 
 export interface NavigationTarget {
@@ -210,6 +203,8 @@ export interface WorkspaceTabContribution {
   Panel: ComponentType<WorkspaceTabContext>;
   Badge?: ComponentType<WorkspaceTabContext>;
   available?: (session: SessionContext) => boolean;
+  /** Der Reiter braucht den Arbeitsbereich des Runs und fehlt, wo der Betrachter ihn nicht erreicht. */
+  requiresWorkspace?: boolean;
   keepMounted?: boolean;
 }
 
@@ -220,7 +215,9 @@ export interface SessionHeaderContext {
 
 export interface SessionHeaderContribution {
   readRight?: string;
-  placement?: "header" | "canvas";
+  /** Der Beitrag braucht den Arbeitsbereich des Runs und fehlt, wo der Betrachter ihn nicht erreicht. */
+  requiresWorkspace?: boolean;
+  placement?: "header" | "surface";
   id: string;
   order: number;
   Header: ComponentType<SessionHeaderContext>;
@@ -290,6 +287,18 @@ export interface SessionMetadataContribution {
   Metadata: ComponentType<SessionMetadataContext>;
 }
 
+/** Die Darstellung einer wartenden Aktion durch das Plugin, dem sie gehört. */
+export interface ActionViewContext {
+  action: PendingAction;
+  text: string;
+  session: SessionContext;
+}
+
+export interface ActionViewContribution {
+  owner: string;
+  View: ComponentType<ActionViewContext>;
+}
+
 export interface AttentionState {
   active: true;
   label: string;
@@ -313,8 +322,8 @@ export interface WebPlugin extends WebPluginDescriptor {
   activate?: (config: Readonly<Record<string, unknown>>) => WebPlugin;
   enabled?: (config: Readonly<Record<string, unknown>>) => boolean;
   brand?: ProductBrand;
-  canvas?: CanvasContribution;
-  canvasElements?: CanvasElementContribution[];
+  surface?: SurfaceContribution;
+  surfaceElements?: SurfaceElementContribution[];
   cardSections?: CardSectionContribution[];
   chatDisplayPolicy?: ChatDisplayPolicy;
   startOptions?: StartOptionContribution[];
@@ -330,7 +339,7 @@ export interface WebPlugin extends WebPluginDescriptor {
   entityPresenters?: EntityPresenterContribution[];
   guides?: EntryGuideContribution[];
   sessionMetadata?: SessionMetadataContribution[];
-  questionResponder?: (session: { id: string }, callId: string, payload: unknown) => Promise<void>;
+  actionViews?: ActionViewContribution[];
   attention?: AttentionContribution[];
 }
 
@@ -349,12 +358,17 @@ export interface ProductProfile {
   plugins: WebPlugin[];
   product: ProductDescriptor;
   startEntries: readonly StartEntry[];
+  /** Die Vorlage, die die Startauswahl statt Neuer Chat zuerst zeigt; der Server nennt sie nur, wenn er sie auch liefert. */
+  defaultStartEntry?: string;
 }
 
+/** Einen Run, den der Server noch nicht gelistet hat, zeigt die Oberfläche als erreichbar; jeden Zugriff prüft der Server selbst. */
+export const workspaceAccessible = (session: SessionInfo): boolean => session.workspaceAccessible !== false;
+
 export class PluginRegistry {
   readonly brand: ProductBrand;
-  readonly canvas: CanvasContribution | undefined;
-  readonly canvasElements: readonly CanvasElementContribution[];
+  readonly surface: SurfaceContribution | undefined;
+  readonly surfaceElements: readonly SurfaceElementContribution[];
   readonly cardSections: readonly CardSectionContribution[];
   readonly chatDisplayPolicy: ChatDisplayPolicy;
   readonly startOptions: ReadonlyMap<string, StartOptionContribution>;
@@ -366,6 +380,7 @@ export class PluginRegistry {
   readonly entityPresenters: readonly EntityPresenterContribution[];
   readonly needsRunView: boolean;
   readonly startEntries: readonly StartEntry[];
+  readonly defaultStartEntry: string | undefined;
   readonly skillEntries: readonly SkillStartEntry[];
   readonly scriptEntries: readonly ScriptStartEntry[];
   readonly guides: ReadonlyMap<string, EntryGuideContribution>;
@@ -374,7 +389,7 @@ export class PluginRegistry {
   readonly overviewPanels: readonly OverviewPanelContribution[];
   readonly settings: readonly (SettingsContribution & { owner: string })[];
   readonly sessionMetadata: readonly SessionMetadataContribution[];
-  readonly questionResponder: WebPlugin["questionResponder"];
+  readonly actionViews: ReadonlyMap<string, ActionViewContribution>;
   readonly attention: readonly AttentionContribution[];
 
   constructor(
@@ -392,28 +407,25 @@ export class PluginRegistry {
     if (brands.length === 0) {
       throw new Error("Kein aktives Plugin liefert ein Branding; die Plugin-Liste enthält kein Produkt-Plugin");
     }
-    if (brands.length > 1) throw new Error(`Das Produktprofil benötigt genau ein Branding, gefunden: ${brands.length}`);
+    if (brands.length > 1) throw new Error(`Das Profil benötigt genau ein Branding, gefunden: ${brands.length}`);
     this.brand = brands[0];
     this.workspaceTabs = this.activePlugins
       .flatMap((plugin) => plugin.workspaceTabs ?? [])
       .sort(byTabOrder);
-    assertUnique(this.workspaceTabs, (tab) => tab.id, "Arbeitsbereichs-Tab");
+    assertUnique(this.workspaceTabs, (tab) => tab.id, "Reiter der Leiste");
     this.workspaceTabFactories = this.activePlugins
       .flatMap((plugin) => plugin.workspaceTabsFor ? [plugin.workspaceTabsFor] : []);
-    const canvases = this.activePlugins.flatMap((plugin) => plugin.canvas ? [plugin.canvas] : []);
-    if (canvases.length > 1) throw new Error(`Mehrere Canvas-Beiträge registriert: ${canvases.length}`);
-    this.canvas = canvases[0];
-    this.canvasElements = this.activePlugins
-      .flatMap((plugin) => plugin.canvasElements ?? [])
+    const surfaces = this.activePlugins.flatMap((plugin) => plugin.surface ? [plugin.surface] : []);
+    if (surfaces.length > 1) throw new Error(`Mehrere Flächenbeiträge registriert: ${surfaces.length}`);
+    this.surface = surfaces[0];
+    this.surfaceElements = this.activePlugins
+      .flatMap((plugin) => plugin.surfaceElements ?? [])
       .sort((left, right) => left.order - right.order || left.id.localeCompare(right.id));
-    assertUnique(this.canvasElements, (element) => element.id, "Canvas-Element-Beitrag");
+    assertUnique(this.surfaceElements, (element) => element.id, "Flächenelement-Beitrag");
     this.cardSections = this.activePlugins
       .flatMap((plugin) => plugin.cardSections ?? [])
       .sort((left, right) => left.order - right.order || left.id.localeCompare(right.id));
     assertUnique(this.cardSections, (section) => section.id, "Karten-Abschnitt");
-    if (this.canvas && !this.workspaceTabs.some((tab) => tab.id === this.canvas?.tabId)) {
-      throw new Error(`Canvas-Tab ist nicht registriert: ${this.canvas.tabId}`);
-    }
     this.needsRunView = this.activePlugins.some((plugin) => plugin.needsRunView);
     const chatPolicies = this.activePlugins.flatMap((plugin) => plugin.chatDisplayPolicy ? [plugin.chatDisplayPolicy] : []);
     if (chatPolicies.length > 1) throw new Error(`Mehrere Chat-Display-Policies registriert: ${chatPolicies.length}`);
@@ -428,7 +440,11 @@ export class PluginRegistry {
     this.entityPresenters = this.activePlugins.flatMap((plugin) => plugin.entityPresenters ?? []);
     const active = new Set(this.activePlugins.map((plugin) => plugin.id));
     this.startEntries = profile.startEntries.filter((entry) => active.has(entry.owner));
-    assertUnique(this.startEntries, (entry) => entry.id, "Einstieg");
+    assertUnique(this.startEntries, (entry) => entry.id, "Vorlage");
+    if (profile.defaultStartEntry !== undefined && !this.startEntries.some((entry) => entry.id === profile.defaultStartEntry)) {
+      throw new Error(`Die Default-Vorlage ${profile.defaultStartEntry} ist keine Vorlage eines aktiven Plugins`);
+    }
+    this.defaultStartEntry = profile.defaultStartEntry;
     this.skillEntries = this.startEntries.filter((entry): entry is SkillStartEntry => entry.action === "skill");
     this.scriptEntries = this.startEntries.filter((entry): entry is ScriptStartEntry => entry.action === "script");
     const guides = this.activePlugins.flatMap((plugin) => plugin.guides ?? []);
@@ -436,7 +452,7 @@ export class PluginRegistry {
     this.guides = new Map(guides.map((guide) => [guide.id, guide]));
     for (const entry of this.startEntries) {
       if (entry.guide !== undefined && !this.guides.has(entry.guide)) {
-        throw new Error(`Einstieg ${entry.id} verlangt den Leitfaden ${entry.guide}, den kein aktives Plugin bereitstellt`);
+        throw new Error(`Vorlage ${entry.id} verlangt den Leitfaden ${entry.guide}, den kein aktives Plugin bereitstellt`);
       }
     }
     this.sessionHeaders = this.activePlugins
@@ -459,10 +475,9 @@ export class PluginRegistry {
       .flatMap((plugin) => plugin.sessionMetadata ?? [])
       .sort((left, right) => left.order - right.order || left.id.localeCompare(right.id));
     assertUnique(this.sessionMetadata, (metadata) => metadata.id, "Session-Metadaten");
-    const responders = this.activePlugins
-      .flatMap((plugin) => plugin.questionResponder ? [plugin.questionResponder] : []);
-    if (responders.length > 1) throw new Error(`Mehrere Question-Responder registriert: ${responders.length}`);
-    this.questionResponder = responders[0];
+    const actionViews = this.activePlugins.flatMap((plugin) => plugin.actionViews ?? []);
+    assertUnique(actionViews, (view) => view.owner, "Aktionsdarstellung");
+    this.actionViews = new Map(actionViews.map((view) => [view.owner, view]));
     this.attention = this.activePlugins.flatMap((plugin) => plugin.attention ?? []);
     assertUnique(this.attention, (contribution) => contribution.id, "Attention-Beitrag");
   }
@@ -471,12 +486,19 @@ export class PluginRegistry {
     if (this.workspaceTabFactories.length === 0) return this.workspaceTabs.filter((tab) => !tab.readRight || access.can(tab.readRight));
     const contributed = this.workspaceTabFactories.flatMap((factory) => factory(session));
     const tabs = [...this.workspaceTabs, ...contributed].sort(byTabOrder);
-    assertUnique(tabs, (tab) => tab.id, "Arbeitsbereichs-Tab");
+    assertUnique(tabs, (tab) => tab.id, "Reiter der Leiste");
     return tabs.filter((tab) => !tab.readRight || access.can(tab.readRight));
   }
 
   availableTabs(session: SessionContext, access: AccessContext = unrestrictedAccess): readonly WorkspaceTabContribution[] {
-    return this.registeredTabs(session, access).filter((tab) => tab.available?.(session) ?? true);
+    return this.registeredTabs(session, access)
+      .filter((tab) => (!tab.requiresWorkspace || workspaceAccessible(session.session)) && (tab.available?.(session) ?? true));
+  }
+
+  headersFor(session: SessionContext, access: AccessContext, placement: "header" | "surface"): readonly SessionHeaderContribution[] {
+    return this.sessionHeaders.filter((entry) => (entry.placement ?? "header") === placement
+      && (!entry.readRight || access.can(entry.readRight))
+      && (!entry.requiresWorkspace || workspaceAccessible(session.session)));
   }
 
   guideFor(entry: StartEntry): EntryGuideContribution | undefined {
@@ -487,6 +509,10 @@ export class PluginRegistry {
     return this.toolPresenters.get(tool.name);
   }
 
+  actionViewFor(owner: string | null): ActionViewContribution | undefined {
+    return owner === null ? undefined : this.actionViews.get(owner);
+  }
+
   targetForEntity(entity: EntityReference, session: SessionContext): NavigationTarget | undefined {
     return this.entityPresenters
       .map((presenter) => presenter.reveal(entity, session))
@@ -604,10 +630,10 @@ export function primaryChatActor(view: unknown): string {
   return view !== null && typeof view === "object" && "primaryActorId" in view && typeof view.primaryActorId === "string" ? view.primaryActorId : "primary";
 }
 
-/** surface unterscheidet Anzeigeflächen desselben Chats (Canvas, Inspector, Popout); jede merkt sich ihren Detailgrad. */
-export function useChatSteps(runId?: string, actorId = "primary", surface?: string): ChatStepsControl {
+/** display unterscheidet Anzeigeorte desselben Chats (Fläche, Inspector, Popout); jeder merkt sich seinen Detailgrad. */
+export function useChatSteps(runId?: string, actorId = "primary", display?: string): ChatStepsControl {
   const control = useContext(ChatStepsContext);
-  const identity = runId === undefined ? undefined : JSON.stringify(surface === undefined ? [runId, actorId] : [runId, actorId, surface]);
+  const identity = runId === undefined ? undefined : JSON.stringify(display === undefined ? [runId, actorId] : [runId, actorId, display]);
   return useMemo(() => ({
     selectable: control.selectable,
     stepsExpandable: control.stepsExpandable,
@@ -616,18 +642,22 @@ export function useChatSteps(runId?: string, actorId = "primary", surface?: stri
   }), [control, identity]);
 }
 
-const CanvasControllerContext = createContext<CanvasController | undefined>(undefined);
+const SurfaceControllerContext = createContext<SurfaceController | undefined>(undefined);
 
-export function CanvasControllerProvider({ children, value }: PropsWithChildren<{ value: CanvasController }>) {
-  return <CanvasControllerContext.Provider value={value}>{children}</CanvasControllerContext.Provider>;
+export function SurfaceControllerProvider({ children, value }: PropsWithChildren<{ value: SurfaceController }>) {
+  return <SurfaceControllerContext.Provider value={value}>{children}</SurfaceControllerContext.Provider>;
 }
 
-export const useCanvasController = () => useContext(CanvasControllerContext);
+export const useSurfaceController = () => useContext(SurfaceControllerContext);
 
 const ToolRendererContext = createContext<(tool: ToolInfo) => ReactNode>(() => undefined);
 
 export const useToolRenderer = () => useContext(ToolRendererContext);
 
+const ActionRendererContext = createContext<(action: PendingAction, text: string) => ReactNode>(() => undefined);
+
+export const useActionRenderer = () => useContext(ActionRendererContext);
+
 export function PluginSessionProviders({
   children,
   navigation,
@@ -642,11 +672,19 @@ export function PluginSessionProviders({
     const Inline = registry.presenterFor(tool)?.Inline;
     return Inline ? <Inline navigation={navigation} session={session} tool={tool} /> : undefined;
   }, [registry, navigation, session]);
+  const renderAction = useMemo(() => (action: PendingAction, text: string) => {
+    const View = registry.actionViewFor(action.owner)?.View;
+    return View ? <View action={action} session={session} text={text} /> : undefined;
+  }, [registry, session]);
   const content = registry.activePlugins.reduceRight<ReactNode>((content, plugin) => {
     if (!plugin.SessionProvider) return content;
     return createElement(plugin.SessionProvider, { key: plugin.id, navigation, session }, content);
   }, children);
-  return <ToolRendererContext.Provider value={renderTool}>{content}</ToolRendererContext.Provider>;
+  return (
+    <ToolRendererContext.Provider value={renderTool}>
+      <ActionRendererContext.Provider value={renderAction}>{content}</ActionRendererContext.Provider>
+    </ToolRendererContext.Provider>
+  );
 }
 
 const byTabOrder = (left: WorkspaceTabContribution, right: WorkspaceTabContribution): number =>

package/apps/web/src/RunPreparationChat.tsx

@@ -2,28 +2,32 @@ import { useEffect, useRef, useState, type RefObject } from "react";
 import { cn } from "cn";
 import type { RunPreparationMessage } from "../../server/src/run-preparation-contract";
 import { Button } from "./ui";
-import { ChatInputToolbar, type ChatInputHandle } from "./chat/ChatInputToolbar";
-import { ChatMessages } from "./chat/ChatMessages";
-import { ChatPanel } from "./chat/ChatPanel";
-import { DetailModeSwitch } from "./chat/DetailModeSwitch";
+import { ChatInputToolbar, type ChatInputHandle, ChatMessages, ChatPanel, type ChatAttachmentInput, type Message } from "quassel";
 import { useAttachmentCapabilities } from "./chat/useAttachmentCapabilities";
-import type { ChatAttachmentInput, Message } from "./chat/types";
-import { useChatSteps, type PluginRegistry, type SessionContext } from "./PluginRegistry";
-import { StartOptionControls, useStartOptions } from "./StartOptions";
+import type { PluginRegistry, SessionContext, SkillStartEntry } from "./PluginRegistry";
+import { ChatViewSwitches, useChatViewSettings } from "./chat-view-settings";
+import { StartOptionControls, conflictingStartOptions, useStartOptions } from "./StartOptions";
 import { discussRun, preparedRunInput } from "./run-preparation";
 
 const composerPlacement = "flex min-h-0 min-w-0 flex-1 *:flex-1 max-md:[&_[data-chat=composer]]:px-2 max-md:[&_[data-chat=composer]]:pb-2";
 /** Without a conversation the composer sits in the middle; a flat window puts it back at the bottom. */
 const emptyComposerPlacement = "[&_[data-chat=composer]]:top-1/2 [&_[data-chat=composer]]:bottom-auto [&_[data-chat=composer]]:-translate-y-1/2 [@media(max-height:600px)]:[&_[data-chat=composer]]:top-auto [@media(max-height:600px)]:[&_[data-chat=composer]]:bottom-0 [@media(max-height:600px)]:[&_[data-chat=composer]]:translate-y-0";
 
-export function RunPreparationChat({ initialPrompt, skillName, registry, sessionRef }: {
+type PreparationEntry = { message: RunPreparationMessage; at: string };
+
+const entryNow = (message: RunPreparationMessage): PreparationEntry => ({ message, at: new Date().toISOString() });
+
+/** Der Auftrag einer Skill-Vorlage entsteht hier; der Run startet über die Vorlage und mit dem, was sie festlegt. */
+export function RunPreparationChat({ initialPrompt, entry, registry, sessionRef }: {
   initialPrompt: string;
-  skillName?: string;
+  entry: SkillStartEntry;
   registry: PluginRegistry;
   sessionRef: RefObject<SessionContext>;
 }) {
-  const [history, setHistory] = useState<RunPreparationMessage[]>([]);
-  const [pendingMessage, setPendingMessage] = useState<RunPreparationMessage>();
+  const skillName = entry.skill;
+  const fixed = entry.fixedStartOptions;
+  const [history, setHistory] = useState<PreparationEntry[]>([]);
+  const [pendingEntry, setPendingEntry] = useState<PreparationEntry>();
   const [operation, setOperation] = useState<"preparing" | "starting">();
   const [draft, setDraft] = useState(initialPrompt);
   const [hasAttachments, setHasAttachments] = useState(false);
@@ -31,7 +35,7 @@ export function RunPreparationChat({ initialPrompt, skillName, registry, session
   const active = useRef<AbortController | null>(null);
   const mounted = useRef(false);
   const submitting = useRef(false);
-  const steps = useChatSteps(sessionRef.current.session.id, "preparation");
+  const chatView = useChatViewSettings(sessionRef.current.session.id, "preparation", "coordinator");
   const options = useStartOptions();
   const sessionId = sessionRef.current.session.id;
   const attachments = useAttachmentCapabilities(sessionId, "primary", JSON.stringify(options.options.map(({ id, value }) => [id, value])));
@@ -46,18 +50,18 @@ export function RunPreparationChat({ initialPrompt, skillName, registry, session
     submitting.current = true;
     const controller = new AbortController();
     active.current = controller;
-    const message: RunPreparationMessage = { role: "user", text, ...(files?.length ? { attachments: files } : {}) };
-    const next = [...history, message];
+    const question = entryNow({ role: "user", text, ...(files?.length ? { attachments: files } : {}) });
+    const next = [...history, question];
     setOperation("preparing");
-    setPendingMessage(message);
+    setPendingEntry(question);
     try {
-      const answer = await discussRun(sessionId, next, controller.signal, skillName);
+      const answer = await discussRun(sessionId, next.map(({ message }) => message), controller.signal, skillName);
       if (!mounted.current || controller.signal.aborted) return;
       if (answer.kind === "start") {
         setOperation("starting");
-        await sessionRef.current.send(answer.input.text, answer.input.attachments);
+        await sessionRef.current.send(answer.input.text, answer.input.attachments, entry.id);
       } else {
-        setHistory([...next, { role: "assistant", text: answer.text }]);
+        setHistory([...next, entryNow({ role: "assistant", text: answer.text })]);
       }
     } catch (cause) {
       if (controller.signal.aborted) throw new Error("Besprechung gestoppt. Deine Eingabe bleibt erhalten.");
@@ -65,7 +69,7 @@ export function RunPreparationChat({ initialPrompt, skillName, registry, session
     } finally {
       active.current = null;
       submitting.current = false;
-      if (mounted.current) { setOperation(undefined); setPendingMessage(undefined); }
+      if (mounted.current) { setOperation(undefined); setPendingEntry(undefined); }
     }
   };
   const createRun = async (text: string, files?: ChatAttachmentInput[]) => {
@@ -73,20 +77,24 @@ export function RunPreparationChat({ initialPrompt, skillName, registry, session
     submitting.current = true;
     setOperation("starting");
     try {
-      const input = preparedRunInput(history, text, files, skillName);
-      await sessionRef.current.send(input.text, input.attachments);
+      const input = preparedRunInput(history.map(({ message }) => message), text, files, skillName);
+      await sessionRef.current.send(input.text, input.attachments, entry.id);
     } finally {
       submitting.current = false;
       if (mounted.current) setOperation(undefined);
     }
   };
-  const messages: Message[] = [...history, ...(pendingMessage ? [pendingMessage] : [])].map((message, index) => ({
-    key: `preparation-${index}`, role: message.role, text: message.text, closed: true,
+  const messages: Message[] = [...history, ...(pendingEntry ? [pendingEntry] : [])].map(({ message, at }, index) => ({
+    key: `preparation-${index}`, role: message.role, text: message.text, closed: true, at,
     attachments: message.attachments?.map((file) => ({ name: file.name, mediaType: file.mediaType,
       size: Math.floor(file.data.length * 3 / 4) - (file.data.endsWith("==") ? 2 : file.data.endsWith("=") ? 1 : 0),
       url: `data:${file.mediaType};base64,${file.data}` })),
   }));
   const busy = operation !== undefined || options.pending;
+  const conflicts = conflictingStartOptions(options.options, fixed ?? {});
+  const adoptTemplate = async () => {
+    for (const option of conflicts) await options.set(option.id, fixed?.[option.id]);
+  };
 
   return <section aria-label="Auftrag besprechen" className={cn(composerPlacement, messages.length === 0 && emptyComposerPlacement)} data-preparation={messages.length === 0 ? "empty" : "active"}>
     <ChatPanel composer={<div>
@@ -94,18 +102,22 @@ export function RunPreparationChat({ initialPrompt, skillName, registry, session
         initialValue={initialPrompt} onDraftChange={setDraft} onAttachmentsChange={setHasAttachments} handleRef={composer}
         rows={3} maxRows={8} running={operation === "preparing"} onStop={() => active.current?.abort()} onSend={discuss}
         texts={{ placeholder: "Ergänzungen oder Fragen zum Auftrag ...", send: "Auftrag besprechen", stop: "Besprechung stoppen" }}
-        toolbarLeft={steps.selectable ? <DetailModeSwitch mode={steps.mode("coordinator")} onChange={(mode) => steps.setMode("coordinator", mode)} /> : undefined}
-        toolbarRight={<StartOptionControls disabled={busy} placement="composer" registry={registry} />} />
+        toolbarLeft={<ChatViewSwitches settings={chatView} />}
+        toolbarRight={<StartOptionControls disabled={busy} fixed={fixed} placement="composer" registry={registry} />} />
+      {conflicts.length > 0 && <div className="mt-3 flex flex-wrap items-center justify-between gap-2.5" data-start-option-conflicts="" role="alert">
+        <span className="text-[0.75rem] text-destructive">Vor dem Öffnen der Vorlage war bei {conflicts.length === 1 ? "einer Startoption" : `${conflicts.length} Startoptionen`} etwas anderes gewählt, als sie festlegt. So lässt sich der Run nicht erstellen.</span>
+        <Button disabled={busy} size="sm" variant="outline" onClick={() => { void adoptTemplate(); }}>Werte der Vorlage übernehmen</Button>
+      </div>}
       <div className="my-3 flex flex-wrap items-center justify-between gap-2.5">
         <span className="text-[0.75rem] text-muted-foreground">Gib im Chat Dein Go zum Starten oder wähle "Run erstellen".</span>
-        <Button disabled={busy || (!history.length && !draft.trim() && !hasAttachments)}
+        <Button disabled={busy || conflicts.length > 0 || (!history.length && !draft.trim() && !hasAttachments)}
           onClick={() => { void composer.current?.submit(createRun, { allowEmpty: history.length > 0 }); }}>
           {operation === "starting" ? "Run wird erstellt ..." : "Run erstellen"}
         </Button>
       </div>
-      <div aria-label="Startoptionen" className="flex flex-wrap items-center gap-x-3 gap-y-2 empty:hidden"><StartOptionControls disabled={busy} registry={registry} /></div>
+      <div aria-label="Startoptionen" className="flex flex-wrap items-center gap-x-3 gap-y-2 empty:hidden"><StartOptionControls disabled={busy} fixed={fixed} registry={registry} /></div>
     </div>}>
-      {messages.length > 0 && <ChatMessages detailMode={steps.mode("coordinator")} messages={messages} running={operation === "preparing"} stepsExpandable={steps.stepsExpandable} />}
+      {messages.length > 0 && <ChatMessages detailMode={chatView.detailMode} messages={messages} running={operation === "preparing"} showTimestamps={chatView.showTimestamps} stepsExpandable={chatView.stepsExpandable} />}
     </ChatPanel>
   </section>;
 }

package/apps/web/src/RunStore.ts

@@ -1,7 +1,7 @@
 import { useEffect, useState } from "react";
-import { coreContracts } from "@aicontainer/server/api/contracts";
+import { coreContracts } from "@ragents/host/api/contracts";
 import { getActorConversations, getRunView } from "./api";
-import type { Message } from "./chat/types";
+import type { Message } from "quassel/events";
 import { rpc } from "./rpc";
 
 export interface RunStoreState {

package/apps/web/src/SessionList.tsx

@@ -32,8 +32,13 @@ const formatTimestamp = (time: number): string => {
     : date.toLocaleDateString("de-DE", { day: "2-digit", month: "2-digit" });
 };
 
-/** Running, unread and resting runs differ only in their accent colour; the card layout stays the same. */
+/** Running, unread, locked and resting runs differ only in their accent colour; the card layout stays the same. */
 const tones = {
+  locked: {
+    card: "border-[color-mix(in_srgb,var(--destructive)_55%,var(--border))]",
+    head: "border-t-destructive bg-destructive/8",
+    text: "text-destructive",
+  },
   running: {
     card: "border-[color-mix(in_srgb,var(--info)_55%,var(--border))]",
     head: "border-t-info bg-info/8",
@@ -80,8 +85,8 @@ export function SessionList({
         <ul className={gridClass}>
           {index === 0 && createCard}
           {group.sessions.map((session) => {
-            const notice = runActivityNotice(session, seenRevisions[session.id]);
-            const tone = tones[session.running ? "running" : notice ? "unread" : "idle"];
+            const notice = session.locked === undefined ? runActivityNotice(session, seenRevisions[session.id]) : undefined;
+            const tone = tones[session.locked !== undefined ? "locked" : session.running ? "running" : notice ? "unread" : "idle"];
             const picked = session.id === activeId || (selectMode && selectedIds.has(session.id));
             return (
               <li
@@ -106,9 +111,10 @@ export function SessionList({
                   aria-current={session.id === activeId ? "true" : undefined}
                   aria-pressed={selectMode ? selectedIds.has(session.id) : undefined}
                   className={cn(
-                    "flex min-h-[148px] min-w-0 flex-1 cursor-pointer flex-col items-stretch gap-2.5 rounded-[11px] px-4 pb-4 text-left focus-visible:outline-2 focus-visible:outline-primary focus-visible:outline-offset-2",
+                    "flex min-h-[148px] min-w-0 flex-1 cursor-pointer flex-col items-stretch gap-2.5 rounded-[11px] px-4 pb-4 text-left focus-visible:outline-2 focus-visible:outline-primary focus-visible:outline-offset-2 disabled:cursor-default",
                     selectMode && "pl-9",
                   )}
+                  disabled={session.locked !== undefined && !selectMode}
                   onClick={() => (selectMode ? onToggleSelected(session.id) : onSelect(session.id))}
                   type="button"
                 >
@@ -117,16 +123,18 @@ export function SessionList({
                     <span className="flex min-h-[18px] flex-wrap items-center gap-x-3.5 gap-y-1.5">
                       <span className={cn("flex items-center gap-[7px] text-[0.75rem]", tone.text)}>
                         {session.running ? <Spinner aria-hidden className="size-3" /> : <span aria-hidden className="size-[7px] flex-none rounded-full bg-current" />}
-                        {session.running ? "Läuft" : session.id === activeId ? "Geöffnet" : "Ruhend"}
+                        {session.locked !== undefined ? "Locked" : session.running ? "Läuft" : session.id === activeId ? "Geöffnet" : "Ruhend"}
                       </span>
                       {notice && <span className="inline-flex items-center gap-1.5 text-[0.7rem] font-semibold text-primary" title={notice === "updated" ? "Neue Journal-Aktivität seit Deinem letzten Ansehen dieses Runs" : "In diesem Browser noch nicht angesehen"}>
                         <span aria-hidden className="size-[7px] flex-none rounded-full bg-current" />{notice === "updated" ? "Neue Aktivität" : "Nicht angesehen"}
                       </span>}
                     </span>
                   </span>
-                  {registry.sessionMetadata.map(({ id, Metadata }) => (
-                    <Metadata key={id} placement="list" session={session} />
-                  ))}
+                  {session.locked !== undefined
+                    ? <span className="text-[0.75rem] leading-[1.45] text-destructive [overflow-wrap:anywhere]">{session.locked}</span>
+                    : registry.sessionMetadata.map(({ id, Metadata }) => (
+                      <Metadata key={id} placement="list" session={session} />
+                    ))}
                   <span className="mt-auto grid gap-0.5 text-muted-foreground">
                     {session.createdAt !== undefined && <span className="text-[0.7rem] tabular-nums">Erstellt <time dateTime={new Date(session.createdAt).toISOString()}>
                       {new Date(session.createdAt).toLocaleString("de-DE", { day: "2-digit", month: "2-digit", year: "numeric", hour: "2-digit", minute: "2-digit" })}