@schlenkr/ragents 0.1.5 → 0.1.7

package/apps/web/src/chat/texts.ts

@@ -1,61 +0,0 @@
-export interface ChatTexts {
-  working: string;
-  toolRunning: string;
-  toolStillRunning: string;
-  currentTool: string;
-  thinkingChip: string;
-  toolChip: string;
-  stepGroupOne: string;
-  stepGroupMany: string;
-  thinkingTitle: string;
-  toolTitle: string;
-  argumentsLabel: string;
-  resultLabel: string;
-  close: string;
-  jumpToEnd: string;
-  send: string;
-  sendIntoRun: string;
-  stop: string;
-  placeholder: string;
-  steeringPlaceholder: string;
-  inputHint: string;
-  detailModeTitle: string;
-  detailModeOff: string;
-  detailModeCurrent: string;
-  detailModeIcons: string;
-  detailModeChips: string;
-  detailModeGrouped: string;
-  detailModeCompact: string;
-  detailModeFull: string;
-}
-
-export const defaultTexts: ChatTexts = {
-  working: "Arbeitet ...",
-  toolRunning: "läuft ...",
-  toolStillRunning: "Werkzeug läuft ...",
-  currentTool: "Werkzeug läuft",
-  thinkingChip: "Denken",
-  toolChip: "Werkzeug",
-  stepGroupOne: "1 Schritt",
-  stepGroupMany: "{count} Schritte",
-  thinkingTitle: "Thinking-Trace",
-  toolTitle: "Tool-Call",
-  argumentsLabel: "Argumente",
-  resultLabel: "Ergebnis",
-  close: "Schließen",
-  jumpToEnd: "Zum Ende springen",
-  send: "Senden",
-  sendIntoRun: "In den laufenden Lauf schicken",
-  stop: "Arbeit stoppen",
-  placeholder: "Nachricht schreiben ...",
-  steeringPlaceholder: "Dazwischenfunken ...",
-  inputHint: "Enter zum Senden - Shift + Enter für eine neue Zeile",
-  detailModeTitle: "Detailgrad der Schritte",
-  detailModeOff: "nur Antworten",
-  detailModeCurrent: "aktuell",
-  detailModeIcons: "Symbole",
-  detailModeChips: "kompakt",
-  detailModeGrouped: "gruppiert",
-  detailModeCompact: "einzeilig",
-  detailModeFull: "alles",
-};

package/apps/web/src/chat/types.ts

@@ -1,26 +0,0 @@
-import type { Message } from "../../../server/src/chat-events";
-
-export type { Role, ToolInfo, Question, Message, ChatEvent, ChatTextCursor, ChatJournalCursor, ChatAttachment, ChatAttachmentInput } from "../../../server/src/chat-events";
-export { applyEvent, prettyJson, compactToolLine } from "../../../server/src/chat-events";
-
-/**
- * current = nur der laufende Schritt, off = nur Antworten, icons = Schritte als reine Symbole nebeneinander,
- * chips = Schritte als Symbol + Kurztext nebeneinander (mit Umbruch),
- * grouped = aufeinanderfolgende Schritte als eine aufklappbare Zeile, dahinter einzeilig,
- * compact = Denken und Werkzeuge einzeilig, full = alles ausgeklappt.
- */
-export type DetailMode = "off" | "current" | "icons" | "chips" | "grouped" | "compact" | "full";
-
-/** running = call still open, thinking = thought block still open, done = finished, error = failed. */
-export type StepState = "running" | "thinking" | "done" | "error";
-
-/** The single derivation of a step state, so chips, hosts and tests read the same signal. */
-export function stepState(message: Message): StepState {
-  if (message.tool?.isError) {
-    return "error";
-  }
-  if (message.role === "thinking") {
-    return message.closed ? "done" : "thinking";
-  }
-  return message.tool !== undefined && message.tool.result === undefined ? "running" : "done";
-}

package/apps/web/src/column/ColumnApp.tsx

@@ -1,234 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from "react";
-import { ChevronDownIcon, ChevronUpIcon, LayoutGridIcon } from "lucide-react";
-import { canStartEntry, type AccessContext } from "../../../../packages/ragents/src/access";
-import { getStartOptions, setStartOption } from "../api";
-import { sendChatMessage, startChatEntry } from "../chat/requests";
-import { preparedRunInput } from "../run-preparation";
-import { initialStartOptionUpdates } from "../StartOptions";
-import { AccessScreen, useAccess } from "../AccessContext";
-import type { SessionInfo } from "../api";
-import { PluginChat } from "../PluginChat";
-import type { PluginRegistry } from "../PluginRegistry";
-import { usePluginActivation } from "../PluginActivation";
-import { useRunReadState } from "../run-read-state";
-import { SessionList } from "../SessionList";
-import { SettingsModal } from "../SettingsModal";
-import { Alert, Button, Spinner } from "../ui";
-import type { ColumnLocation } from "./column-location";
-import { ColumnMenu } from "./ColumnMenu";
-import { useColumnHost } from "./host";
-import { useSessionList } from "./use-session-list";
-
-const headerClass = "relative z-[80] flex h-header flex-none items-stretch border-b border-border bg-shell shadow-bar";
-const listHeaderClass = "relative z-[80] flex h-header flex-none items-center gap-2 border-b border-border bg-shell px-3 shadow-bar";
-const noticeClass = "m-auto max-w-[420px] p-6 text-center text-muted-foreground";
-const noSelection: ReadonlySet<string> = new Set();
-const newDraft = (): SessionInfo => ({ id: crypto.randomUUID(), title: "Neuer Run", updatedAt: Date.now() });
-const placeholderSession = (id: string): SessionInfo => ({ id, title: "Run", updatedAt: Date.now() });
-
-/** Die Arbeitsspalte: ein Run mit Chat und Mini-Apps, ohne Run die Run-Liste; layout=app zeigt genau ein Canvas-Element. */
-export function ColumnApp({ location }: { location: ColumnLocation }) {
-  const activation = usePluginActivation();
-  if (activation.status === "loading") return <div className={noticeClass}>Produktprofil wird geladen.</div>;
-  if (activation.status === "failed") return (
-    <Alert className="m-auto max-w-[420px] gap-3 p-6" variant="destructive">
-      <p>{activation.error}</p>
-      <Button onClick={() => window.location.reload()} variant="outline">Neu laden</Button>
-    </Alert>
-  );
-  return location.layout === "app"
-    ? <ElementPage elementId={location.elementId} registry={activation.registry} runId={location.runId} />
-    : <ColumnPage initialRunId={location.runId} registry={activation.registry} />;
-}
-
-function ColumnPage({ initialRunId, registry }: { initialRunId: string | undefined; registry: PluginRegistry }) {
-  const host = useColumnHost();
-  const access = useAccess();
-  const readRuns = access.can("runs.read");
-  const writeRuns = readRuns && access.can("runs.write");
-  const canCreate = writeRuns && (access.can("runs.create") || registry.scriptEntries.some((entry) => canStartEntry(access, entry.id)));
-  const runReadState = useRunReadState(access.user?.id);
-  const [runId, setRunId] = useState(initialRunId);
-  const [runStartOptions, setRunStartOptions] = useState<Readonly<Record<string, unknown>>>();
-  const [draft, setDraft] = useState<{ session: SessionInfo; startOptions?: Readonly<Record<string, unknown>>; entryId?: string }>();
-  const [launch, setLaunch] = useState<Launch>();
-  const [settingsOpen, setSettingsOpen] = useState(false);
-  const [listOpen, setListOpen] = useState(false);
-  const openSettings = useCallback(() => setSettingsOpen(true), []);
-  const { sessions, unreachable, refresh } = useSessionList(readRuns && !draft && !launch);
-  const [headerContainer, setHeaderContainer] = useState<HTMLDivElement | null>(null);
-  const [toolsContainer, setToolsContainer] = useState<HTMLDivElement | null>(null);
-  const startDraft = useCallback((startOptions?: Readonly<Record<string, unknown>>, entryId?: string) => { setListOpen(false); setDraft({ session: newDraft(), startOptions, entryId }); }, []);
-  const createRun = useCallback(() => startDraft(), [startDraft]);
-  const openRun = useCallback((id: string, startOptions?: Readonly<Record<string, unknown>>) => {
-    setListOpen(false);
-    setDraft(undefined);
-    setLaunch(undefined);
-    setRunStartOptions(startOptions);
-    setRunId(id);
-  }, []);
-  const selectRun = useCallback((id: string) => { setListOpen(false); setRunId(id); }, []);
-
-  useEffect(() => host.onCommand((message) => {
-    if (message.type === "selectRun") {
-      setDraft(undefined);
-      setLaunch(undefined);
-      setListOpen(false);
-      setRunStartOptions(undefined);
-      setRunId(message.runId ?? undefined);
-    }
-    if (message.type !== "newRun" || !canCreate) return;
-    // Im Panel ist ein Klick ein Klick: die Vorlage startet sofort, der freie Auftrag entsteht im Chat des neuen Runs.
-    if (host.kind !== "vscode") startDraft(message.startOptions, message.entryId);
-    else if (message.entryId === undefined) openRun(crypto.randomUUID(), message.startOptions);
-    else setLaunch({ runId: crypto.randomUUID(), entryId: message.entryId, startOptions: message.startOptions });
-  }), [canCreate, host, openRun, startDraft]);
-  useEffect(() => { host.notify({ type: "ready" }); }, [host]);
-  useEffect(() => { host.notify({ type: "runChanged", runId: runId ?? null }); }, [host, runId]);
-  useEffect(() => {
-    if (!listOpen) return;
-    const onKeyDown = (event: KeyboardEvent) => { if (event.key === "Escape") setListOpen(false); };
-    window.addEventListener("keydown", onKeyDown);
-    return () => window.removeEventListener("keydown", onKeyDown);
-  }, [listOpen]);
-
-  if (launch) return <RunLaunch access={access} launch={launch} onCancel={() => setLaunch(undefined)} onOpenSettings={openSettings}
-    onStarted={openRun} registry={registry} />;
-
-  const session = sessions.find((entry) => entry.id === runId);
-  const list = readRuns
-    ? <SessionList activeId={runId} onCreate={canCreate ? createRun : undefined} onSelect={selectRun} onToggleSelected={() => undefined} registry={registry} seenRevisions={runReadState.revisions} selectMode={false} selectedIds={noSelection} sessions={sessions} />
-    : <p className={noticeClass}>Für dieses Benutzerkonto sind keine Runs freigegeben.</p>;
-  return (
-    <div className="flex h-full flex-col bg-[image:var(--canvas-backdrop)]">
-      {readRuns && runId
-        ? (
-          <>
-            <header className={headerClass}>
-              <Button aria-expanded={listOpen} aria-label={listOpen ? "Run-Liste schließen" : "Run-Liste aufklappen"} className="self-center" onClick={() => setListOpen((value) => !value)} size="icon-lg" title={listOpen ? "Run-Liste schließen (Escape)" : "Run-Liste aufklappen"} variant="ghost">{listOpen ? <ChevronUpIcon /> : <ChevronDownIcon />}</Button>
-              <div aria-label="Run-Titelleiste" className="flex min-w-0 flex-1 items-stretch overflow-x-auto no-scrollbar" ref={setHeaderContainer} role="region" />
-              <div aria-label="Werkzeuge des Panels" className="flex flex-none items-center empty:hidden" ref={setToolsContainer} role="toolbar" />
-              <ColumnMenu onOpenSettings={openSettings} />
-            </header>
-            <main className="relative z-1 flex min-h-0 min-w-0 flex-1 @container/chat-content">
-              <PluginChat
-                toolbarContainer={toolsContainer}
-                headerContainer={headerContainer}
-                initialStartOptions={runStartOptions}
-                key={runId}
-                layout="column"
-                onViewed={runReadState.markViewed}
-                registry={registry}
-                session={session ?? placeholderSession(runId)}
-                viewing={!draft && !settingsOpen && !listOpen}
-              />
-              {listOpen && <div aria-label="Run-Liste" className="absolute inset-0 z-[70] overflow-auto bg-background p-3" role="dialog">
-                {unreachable && <Alert className="mb-3" variant="destructive">Der Server ist nicht erreichbar.</Alert>}
-                {list}
-              </div>}
-            </main>
-          </>
-        )
-        : (
-          <>
-            <header className={listHeaderClass}>
-              <LayoutGridIcon aria-hidden className="size-4 flex-none text-muted-foreground" />
-              <strong className="min-w-0 flex-1 truncate text-[0.82rem] font-semibold">{registry.brand.title}</strong>
-              <ColumnMenu onOpenSettings={openSettings} />
-            </header>
-            <div className="min-h-0 flex-1 overflow-auto p-3">
-              {unreachable && <Alert className="mb-3" variant="destructive">Der Server ist nicht erreichbar.</Alert>}
-              {list}
-            </div>
-          </>
-        )}
-      {settingsOpen && <SettingsModal onClose={() => setSettingsOpen(false)} registry={registry} />}
-      {draft && (
-        <PluginChat
-          initialStartOptions={draft.startOptions}
-          key={draft.session.id}
-          onStarted={() => { setRunId(draft.session.id); setDraft(undefined); void refresh(); }}
-          registry={registry}
-          session={draft.session}
-          startDialog={{ onClose: () => setDraft(undefined), initialEntryId: draft.entryId }}
-        />
-      )}
-    </div>
-  );
-}
-
-interface Launch {
-  readonly runId: string;
-  readonly entryId: string;
-  readonly startOptions?: Readonly<Record<string, unknown>>;
-}
-
-/** Ein Klick auf eine Kachel der Übersicht: Startoptionen setzen, den Einstieg starten, fertig. */
-async function launchRun(launch: Launch, registry: PluginRegistry, access: AccessContext): Promise<void> {
-  const entry = registry.startEntries.find((candidate) => candidate.id === launch.entryId);
-  if (!entry) throw new Error("Diese Startvorlage gibt es in diesem Profil nicht.");
-  if (!canStartEntry(access, entry.id)) throw new Error(`${entry.title} ist für dieses Benutzerkonto nicht freigegeben.`);
-  if (launch.startOptions) {
-    const options = await getStartOptions(launch.runId);
-    for (const [id, value] of initialStartOptionUpdates(options, launch.startOptions)) await setStartOption(launch.runId, id, value);
-  }
-  if (entry.action === "script") await startChatEntry(launch.runId, entry.id, null);
-  else await sendChatMessage(launch.runId, preparedRunInput([], entry.prompt, undefined, entry.skill).text);
-}
-
-function RunLaunch({ launch, registry, access, onStarted, onCancel, onOpenSettings }: {
-  launch: Launch;
-  registry: PluginRegistry;
-  access: AccessContext;
-  onStarted: (runId: string) => void;
-  onCancel: () => void;
-  onOpenSettings: () => void;
-}) {
-  const [error, setError] = useState<string>();
-  const running = useRef(false);
-  useEffect(() => {
-    if (running.current) return;
-    running.current = true;
-    void launchRun(launch, registry, access).then(
-      () => onStarted(launch.runId),
-      (cause: unknown) => setError(cause instanceof Error ? cause.message : String(cause)),
-    );
-  }, [access, launch, onStarted, registry]);
-  return (
-    <div className="flex h-full flex-col bg-[image:var(--canvas-backdrop)]">
-      <header className={listHeaderClass}>
-        <LayoutGridIcon aria-hidden className="size-4 flex-none text-muted-foreground" />
-        <strong className="min-w-0 flex-1 truncate text-[0.82rem] font-semibold">{registry.brand.title}</strong>
-        <ColumnMenu onOpenSettings={onOpenSettings} />
-      </header>
-      <div className="flex min-h-0 flex-1 items-center justify-center p-6">
-        {error
-          ? <Alert className="max-w-[420px] gap-3" variant="destructive"><p>{error}</p><Button onClick={onCancel} variant="outline">Zurück</Button></Alert>
-          : <p className="flex items-center gap-2 text-muted-foreground" role="status"><Spinner />Run wird gestartet ...</p>}
-      </div>
-    </div>
-  );
-}
-
-function ElementPage({ elementId, registry, runId }: { elementId: string; registry: PluginRegistry; runId: string }) {
-  const host = useColumnHost();
-  const readRuns = useAccess().can("runs.read");
-  const { sessions } = useSessionList(readRuns);
-  useEffect(() => { host.notify({ type: "ready" }); }, [host]);
-  if (!readRuns) return <p className={noticeClass}>Für dieses Benutzerkonto sind keine Runs freigegeben.</p>;
-  return (
-    <main className="relative flex h-full min-h-0 min-w-0 flex-1 bg-background @container/chat-content">
-      <PluginChat key={runId} layout={{ element: elementId }} registry={registry} session={sessions.find((entry) => entry.id === runId) ?? placeholderSession(runId)} />
-    </main>
-  );
-}
-
-/** Im VS-Code-Webview führt die Erweiterung die Anmeldung; das Panel bittet nur darum. */
-export function HostLogin() {
-  const host = useColumnHost();
-  return <AccessScreen>
-    <h1 className="my-3 text-[1.5rem]">Anmeldung erforderlich</h1>
-    <p className="mb-6 leading-normal text-muted-foreground">Die Anmeldung läuft über VS Code. Danach lädt das Panel neu.</p>
-    <Button className="w-full" onClick={() => host.requestLogin()}>In VS Code anmelden</Button>
-  </AccessScreen>;
-}

package/apps/web/src/column/column-location.ts

@@ -1,30 +0,0 @@
-import { ACCESS_TOKEN_QUERY } from "../../../../packages/ragents/src/access";
-import { isColumnTheme, type ColumnTheme } from "./host-contract";
-
-export type ColumnLocation =
-  | { layout: "column"; runId: string | undefined; host: ColumnHostKind; theme: ColumnTheme | undefined; access: string | undefined }
-  | { layout: "app"; runId: string; elementId: string; host: ColumnHostKind; theme: ColumnTheme | undefined; access: string | undefined };
-
-export type ColumnHostKind = "browser" | "vscode";
-
-const text = (value: string | null): string | undefined => value?.trim() ? value.trim() : undefined;
-
-const hostKind = (value: string): ColumnHostKind => {
-  if (value === "browser" || value === "vscode") return value;
-  throw new Error(`Unbekannter Host ${JSON.stringify(value)}. Erlaubt sind browser und vscode.`);
-};
-
-/** Liest die Adresse des Panels; unbekannte Werte sind ein harter Fehler statt einer stillen Standardansicht. */
-export function parseColumnLocation(search: string): ColumnLocation {
-  const query = new URLSearchParams(search);
-  const layout = text(query.get("layout")) ?? "column";
-  if (layout !== "column" && layout !== "app") throw new Error(`Unbekanntes Layout ${JSON.stringify(layout)}. Erlaubt sind column und app.`);
-  const themeValue = text(query.get("theme"));
-  if (themeValue !== undefined && !isColumnTheme(themeValue)) throw new Error(`Unbekannte Darstellung ${JSON.stringify(themeValue)}. Erlaubt sind light und dark.`);
-  const common = { host: hostKind(text(query.get("host")) ?? "browser"), theme: themeValue, access: text(query.get(ACCESS_TOKEN_QUERY)) };
-  const runId = text(query.get("run"));
-  if (layout === "column") return { layout, runId, ...common };
-  const elementId = text(query.get("element"));
-  if (!runId || !elementId) throw new Error("Das Layout app braucht run und element.");
-  return { layout, runId, elementId, ...common };
-}

package/apps/web/src/column/host-contract.ts

@@ -1,93 +0,0 @@
-/** Vertrag zwischen der Arbeitsspalte (column.html) und einem Host, der sie in einem iframe zeigt; importfrei, die VS-Code-Erweiterung bündelt ihn mit. */
-
-export const COLUMN_PAGE = "column.html";
-
-export type ColumnLayout = "column" | "app";
-export type ColumnTheme = "light" | "dark";
-
-export interface ColumnPageQuery {
-  layout?: ColumnLayout;
-  run?: string;
-  element?: string;
-  host?: "vscode";
-  theme?: ColumnTheme;
-  access?: string;
-}
-
-export const columnPageUrl = (serverUrl: string, query: ColumnPageQuery): string => {
-  const url = new URL(COLUMN_PAGE, serverUrl.endsWith("/") ? serverUrl : `${serverUrl}/`);
-  for (const [key, value] of Object.entries(query)) if (value !== undefined) url.searchParams.set(key, value);
-  return url.toString();
-};
-
-/** Nachrichten des Panels an seinen Host. */
-export type ColumnHostMessage =
-  | { type: "ready" }
-  | { type: "runChanged"; runId: string | null }
-  | { type: "openInCenter"; runId: string; elementId: string; title: string }
-  | { type: "returnToColumn"; runId: string; elementId: string }
-  | { type: "login" }
-  | { type: "logout" }
-  | { type: "openExternal"; url: string }
-  | { type: "openPage"; url: string; title: string };
-
-/** Der Text der Zwischenablage: ein iframe fremder Herkunft darf sie im Webview nicht lesen, die Hülle darüber schon. */
-export type ColumnClipboardMessage = { type: "clipboardRead"; id: string };
-export type ClipboardColumnMessage = { type: "clipboardText"; id: string; text: string };
-
-/** Nachrichten des Hosts an das Panel. */
-export type HostColumnMessage =
-  | { type: "selectRun"; runId: string | null }
-  | { type: "newRun"; startOptions?: Record<string, unknown>; entryId?: string }
-  | { type: "placements"; runId: string; center: string[] }
-  | { type: "theme"; theme: ColumnTheme };
-
-const isObject = (value: unknown): value is Record<string, unknown> => typeof value === "object" && value !== null;
-const isText = (value: unknown): value is string => typeof value === "string" && value.length > 0;
-
-export const isColumnTheme = (value: unknown): value is ColumnTheme => value === "light" || value === "dark";
-
-export const isColumnHostMessage = (value: unknown): value is ColumnHostMessage => {
-  if (!isObject(value)) return false;
-  switch (value.type) {
-    case "ready":
-    case "login":
-    case "logout":
-      return true;
-    case "runChanged":
-      return value.runId === null || isText(value.runId);
-    case "openInCenter":
-      return isText(value.runId) && isText(value.elementId) && typeof value.title === "string";
-    case "returnToColumn":
-      return isText(value.runId) && isText(value.elementId);
-    case "openExternal":
-      return isText(value.url);
-    case "openPage":
-      return isText(value.url) && typeof value.title === "string";
-    default:
-      return false;
-  }
-};
-
-export const isColumnClipboardMessage = (value: unknown): value is ColumnClipboardMessage =>
-  isObject(value) && value.type === "clipboardRead" && isText(value.id);
-
-export const isClipboardColumnMessage = (value: unknown): value is ClipboardColumnMessage =>
-  isObject(value) && value.type === "clipboardText" && isText(value.id) && typeof value.text === "string";
-
-export const isHostColumnMessage = (value: unknown): value is HostColumnMessage => {
-  if (!isObject(value)) return false;
-  switch (value.type) {
-    case "selectRun":
-      return value.runId === null || isText(value.runId);
-    case "newRun":
-      return (value.startOptions === undefined || (isObject(value.startOptions) && !Array.isArray(value.startOptions)))
-        && (value.entryId === undefined || isText(value.entryId));
-    case "placements":
-      return isText(value.runId) && Array.isArray(value.center) && value.center.every(isText);
-    case "theme":
-      return isColumnTheme(value.theme);
-    default:
-      return false;
-  }
-};