Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.
Python agent-orchestrationaiai-agentschatopsdiscordlangchainmcpmicrosoft-teamsmulti-agentopen-sourceopenaiself-hostedslack
feat(gateway-ui): reference types management tab
raullopez-sandboxbcc36e57a1ff
diff --git a/gateway/src/pages/resources/CreateReferenceTypeDialog.tsx b/gateway/src/pages/resources/CreateReferenceTypeDialog.tsxnew file mode 100644index 000000000..fb2a513f6--- /dev/null+++ b/gateway/src/pages/resources/CreateReferenceTypeDialog.tsx@@ -0,0 +1,164 @@+import {+ Alert,+ Button,+ CircularProgress,+ Dialog,+ DialogActions,+ DialogContent,+ DialogTitle,+ Stack,+ TextField,+} from "@mui/material";+import { useState } from "react";+import { createReferenceType } from "../../data/api";+import { AccessSelect } from "../../components/AccessControls";+import { type AccessLevel, fromAccessLevel } from "../../data/visibility";+import { useReferenceTypes } from "../../data/hooks";++const SLUG_PATTERN = /^[a-z][a-z0-9_]{1,62}$/;++const SLUG_RULE =+ "^[a-z][a-z0-9_]{1,62}$ — lowercase letters, digits and underscores, starting with a letter, 2–63 characters. Stored on every reference of this type, so it cannot be changed later.";++export const INSTRUCTIONS_DISCLOSURE =+ "Sent to every agent in every room a reference of this type reaches, including agents owned by other people. A private type is hidden from other people's pickers; that does not hold these instructions back once a reference of it is in a room.";++interface Props {+ open: boolean;+ onClose: () => void;+ onCreated: () => void;+}++export default function CreateReferenceTypeDialog({+ open,+ onClose,+ onCreated,+}: Props) {+ const { data: types } = useReferenceTypes();+ const [slug, setSlug] = useState("");+ const [displayName, setDisplayName] = useState("");+ const [instructions, setInstructions] = useState("");+ const [valueHint, setValueHint] = useState("");+ const [access, setAccess] = useState<AccessLevel>("private");+ const [submitting, setSubmitting] = useState(false);+ const [error, setError] = useState<string | null>(null);++ const reset = () => {+ setSlug("");+ setDisplayName("");+ setInstructions("");+ setValueHint("");+ setAccess("private");+ setError(null);+ };++ const handleClose = () => {+ if (submitting) return;+ reset();+ onClose();+ };++ const handleSubmit = async () => {+ setSubmitting(true);+ setError(null);+ try {+ await createReferenceType({+ type: slug,+ display_name: displayName,+ instructions,+ value_hint: valueHint,+ ...fromAccessLevel(access),+ });+ reset();+ onCreated();+ } catch (e) {+ setError(e instanceof Error ? e.message : "Failed to create reference type");+ } finally {+ setSubmitting(false);+ }+ };++ // Only types this user can read are known here, so a collision with someone+ // else's private slug still comes back from the server as a 400.+ const clash = (types ?? []).find((t) => t.type === slug);+ const slugError =+ slug.length === 0+ ? null+ : !SLUG_PATTERN.test(slug)+ ? `"${slug}" is not a valid slug.`+ : clash+ ? clash.is_builtin+ ? `"${slug}" is a built-in reference type.`+ : `"${slug}" is already taken.`+ : null;++ const canSubmit =+ slugError === null &&+ SLUG_PATTERN.test(slug) &&+ displayName.trim().length > 0 &&+ instructions.trim().length > 0 &&+ valueHint.trim().length > 0 &&+ !submitting;++ return (+ <Dialog open={open} onClose={handleClose} fullWidth maxWidth="sm">+ <DialogTitle>New reference type</DialogTitle>+ <DialogContent>+ <Stack spacing={2} sx={{ mt: 1 }}>+ <TextField+ label="Slug"+ value={slug}+ onChange={(e) => setSlug(e.target.value.toLowerCase())}+ disabled={submitting}+ error={slugError !== null}+ helperText={slugError ? `${slugError} ${SLUG_RULE}` : SLUG_RULE}+ slotProps={{ input: { sx: { fontFamily: "monospace" } } }}+ />++ <TextField+ label="Display name"+ value={displayName}+ onChange={(e) => setDisplayName(e.target.value)}+ disabled={submitting}+ helperText="Shown wherever a reference of this type appears."+ />++ <TextField+ label="Instructions"+ value={instructions}+ onChange={(e) => setInstructions(e.target.value)}+ disabled={submitting}+ multiline+ minRows={4}+ helperText={INSTRUCTIONS_DISCLOSURE}+ />++ <TextField+ label="Value hint"+ value={valueHint}+ onChange={(e) => setValueHint(e.target.value)}+ disabled={submitting}+ helperText="Shown under the URL box when someone creates a reference of this type — say what those URLs should point at."+ />++ <AccessSelect value={access} onChange={setAccess} disabled={submitting} />++ {error && <Alert severity="error">{error}</Alert>}+ </Stack>+ </DialogContent>+ <DialogActions>+ <Button onClick={handleClose} disabled={submitting}>+ Cancel+ </Button>+ <Button+ variant="contained"+ onClick={handleSubmit}+ disabled={!canSubmit}+ startIcon={submitting ? <CircularProgress size={16} /> : undefined}+ >+ Create+ </Button>+ </DialogActions>+ </Dialog>+ );+}diff --git a/gateway/src/pages/resources/PackageMembersSection.tsx b/gateway/src/pages/resources/PackageMembersSection.tsxindex dafdaa56c..e0b7f5af9 100644--- a/gateway/src/pages/resources/PackageMembersSection.tsx+++ b/gateway/src/pages/resources/PackageMembersSection.tsx@@ -24,7 +24,6 @@ import {useDocuments,usePackageDocuments,usePackageReferences,- useReferenceTypes,useReferences,} from "../../data/hooks";@@ -35,7 +34,6 @@ interface Props {export default function PackageMembersSection({ packageId, canMutate }: Props) {const navigate = useNavigate();- const { data: types } = useReferenceTypes();const { data: pkgRefs, loading: refsLoading, refetch: refetchRefs } =usePackageReferences(packageId);const { data: pkgDocs, loading: docsLoading, refetch: refetchDocs } =@@ -48,12 +46,6 @@ export default function PackageMembersSection({ packageId, canMutate }: Props) {const [error, setError] = useState<string | null>(null);const [busy, setBusy] = useState(false);- const typeLabel = useMemo(() => {- const m: Record<string, string> = {};- for (const t of types ?? []) m[t.type] = t.display_name;- return m;- }, [types]);-const refIds = useMemo(() => new Set((pkgRefs ?? []).map((r) => r.id)),[pkgRefs],@@ -70,10 +62,10 @@ export default function PackageMembersSection({ packageId, canMutate }: Props) {.map((r) => ({id: r.id,primary: r.name || "(unnamed)",- secondary: typeLabel[r.type] ?? r.type,+ secondary: r.type_display_name ?? `${r.type} (unknown type)`,search: `${r.name} ${r.description} ${r.type}`.toLowerCase(),})),- [allRefs, refIds, typeLabel],+ [allRefs, refIds],);const docOptions = useMemo<PickerOption[]>(() =>@@ -193,7 +185,10 @@ export default function PackageMembersSection({ packageId, canMutate }: Props) {}}onClick={() => navigate(`/resources/references/${r.id}`)}>- <Chip label={typeLabel[r.type] ?? r.type} size="small" />+ <Chip+ label={r.type_display_name ?? `${r.type} (unknown type)`}+ size="small"+ /><Typography variant="body2" sx={{ flexGrow: 1 }}>{r.name || "(unnamed)"}</Typography>diff --git a/gateway/src/pages/resources/ReferenceTypesTab.tsx b/gateway/src/pages/resources/ReferenceTypesTab.tsxnew file mode 100644index 000000000..5d97e6a57--- /dev/null+++ b/gateway/src/pages/resources/ReferenceTypesTab.tsx@@ -0,0 +1,377 @@+import DeleteOutline from "@mui/icons-material/DeleteOutline";+import EditOutlined from "@mui/icons-material/EditOutlined";+import {+ Alert,+ Box,+ Button,+ Chip,+ CircularProgress,+ Dialog,+ DialogActions,+ DialogContent,+ DialogContentText,+ DialogTitle,+ IconButton,+ Stack,+ TextField,+} from "@mui/material";+import type { GridColDef } from "@mui/x-data-grid";+import { useEffect, useMemo, useState } from "react";+import DataTable from "../../components/DataTable";+import { AccessChip, AccessSelect } from "../../components/AccessControls";+import {+ deleteReferenceType,+ type ReferenceTypeDetail,+ updateReferenceType,+} from "../../data/api";+import { useOwnedReferenceTypes, useReferenceTypes } from "../../data/hooks";+import {+ type AccessLevel,+ fromAccessLevel,+ toAccessLevel,+} from "../../data/visibility";+import { INSTRUCTIONS_DISCLOSURE } from "./CreateReferenceTypeDialog";+import { formatDate } from "../../theme/hootFormat";++interface Props {+ refreshKey: number;+}++interface TypeRow {+ /** A row shadowed by a built-in shares its slug with the built-in entry, so+ * the grid key is namespaced rather than being the slug itself. */+ id: string;+ type: string;+ display_name: string;+ value_hint: string;+ owner: string;+ created_at: string | null;+ shadowed_by_builtin: boolean;+ /** Null for a built-in: it lives in Python, not in a row, so there is+ * nothing to edit or delete and no visibility pair to show. */+ detail: ReferenceTypeDetail | null;+}++export default function ReferenceTypesTab({ refreshKey }: Props) {+ const {+ data: visible,+ loading: visibleLoading,+ error: visibleError,+ refetch: refetchVisible,+ } = useReferenceTypes();+ const {+ data: owned,+ loading: ownedLoading,+ error: ownedError,+ refetch: refetchOwned,+ } = useOwnedReferenceTypes();+ const [editing, setEditing] = useState<ReferenceTypeDetail | null>(null);+ const [deleting, setDeleting] = useState<ReferenceTypeDetail | null>(null);++ useEffect(() => {+ refetchVisible();+ refetchOwned();+ // eslint-disable-next-line react-hooks/exhaustive-deps+ }, [refreshKey]);++ const refreshBoth = () => {+ refetchVisible();+ refetchOwned();+ };++ const rows = useMemo<TypeRow[]>(() => {+ const builtins: TypeRow[] = (visible ?? [])+ .filter((t) => t.is_builtin)+ .map((t) => ({+ id: `builtin:${t.type}`,+ type: t.type,+ display_name: t.display_name,+ value_hint: t.value_hint,+ owner: "Built-in",+ created_at: null,+ shadowed_by_builtin: false,+ detail: null,+ }));+ const mine: TypeRow[] = (owned ?? []).map((t) => ({+ id: `row:${t.type}`,+ type: t.type,+ display_name: t.display_name,+ value_hint: t.value_hint,+ owner: t.owner_name ?? t.owner_id,+ created_at: t.created_at,+ shadowed_by_builtin: t.shadowed_by_builtin,+ detail: t,+ }));+ return [...builtins, ...mine];+ }, [visible, owned]);++ const columns = useMemo<GridColDef<TypeRow>[]>(+ () => [+ {+ field: "type",+ headerName: "Slug",+ width: 200,+ renderCell: ({ row }) => (+ <Stack direction="row" alignItems="center" spacing={1}>+ <Box component="span" sx={{ fontFamily: "monospace" }}>+ {row.type}+ </Box>+ {row.shadowed_by_builtin && (+ <Chip label="shadowed by built-in" size="small" color="warning" />+ )}+ </Stack>+ ),+ },+ { field: "display_name", headerName: "Name", width: 180 },+ { field: "value_hint", headerName: "Value hint", flex: 1, minWidth: 240 },+ {+ field: "access",+ headerName: "Access",+ width: 110,+ sortable: false,+ filterable: false,+ renderCell: ({ row }) =>+ row.detail ? (+ <AccessChip pair={row.detail} />+ ) : (+ <Chip label="Built-in" size="small" />+ ),+ },+ { field: "owner", headerName: "Owner", width: 150 },+ {+ field: "created_at",+ headerName: "Created",+ width: 116,+ valueFormatter: (value) => (value ? formatDate(value as string) : "—"),+ },+ {+ field: "actions",+ headerName: "",+ width: 96,+ sortable: false,+ filterable: false,+ renderCell: ({ row }) =>+ row.detail ? (+ <Stack direction="row">+ <IconButton size="small" onClick={() => setEditing(row.detail)}>+ <EditOutlined fontSize="small" />+ </IconButton>+ <IconButton size="small" onClick={() => setDeleting(row.detail)}>+ <DeleteOutline fontSize="small" />+ </IconButton>+ </Stack>+ ) : null,+ },+ ],+ [],+ );++ const error = visibleError ?? ownedError;++ return (+ <Box sx={{ display: "flex", flexDirection: "column", flexGrow: 1, minHeight: 0 }}>+ {error && (+ <Alert severity="error" sx={{ mb: 2 }}>+ {error}+ </Alert>+ )}++ {visibleLoading || ownedLoading ? (+ <CircularProgress />+ ) : (+ <DataTable rows={rows} columns={columns} fillHeight />+ )}++ {editing && (+ <EditReferenceTypeDialog+ referenceType={editing}+ onClose={() => setEditing(null)}+ onSaved={() => {+ setEditing(null);+ refreshBoth();+ }}+ />+ )}+ {deleting && (+ <DeleteReferenceTypeDialog+ referenceType={deleting}+ onClose={() => setDeleting(null)}+ onDeleted={() => {+ setDeleting(null);+ refreshBoth();+ }}+ />+ )}+ </Box>+ );+}++function EditReferenceTypeDialog({+ referenceType,+ onClose,+ onSaved,+}: {+ referenceType: ReferenceTypeDetail;+ onClose: () => void;+ onSaved: () => void;+}) {+ const [displayName, setDisplayName] = useState(referenceType.display_name);+ const [instructions, setInstructions] = useState(referenceType.instructions);+ const [valueHint, setValueHint] = useState(referenceType.value_hint);+ const [access, setAccess] = useState<AccessLevel>(toAccessLevel(referenceType));+ const [submitting, setSubmitting] = useState(false);+ const [error, setError] = useState<string | null>(null);++ const handleClose = () => {+ if (submitting) return;+ onClose();+ };++ const handleSubmit = async () => {+ setSubmitting(true);+ setError(null);+ try {+ await updateReferenceType(referenceType.type, {+ display_name: displayName,+ instructions,+ value_hint: valueHint,+ ...fromAccessLevel(access),+ });+ onSaved();+ } catch (e) {+ setError(e instanceof Error ? e.message : "Failed to save reference type");+ } finally {+ setSubmitting(false);+ }+ };++ const canSubmit =+ displayName.trim().length > 0 &&+ instructions.trim().length > 0 &&+ valueHint.trim().length > 0 &&+ !submitting;++ return (+ <Dialog open onClose={handleClose} fullWidth maxWidth="sm">+ <DialogTitle>Edit reference type</DialogTitle>+ <DialogContent>+ <Stack spacing={2} sx={{ mt: 1 }}>+ <TextField+ label="Slug"+ value={referenceType.type}+ disabled+ helperText="Stored on every reference of this type and cannot be changed."+ slotProps={{ input: { sx: { fontFamily: "monospace" } } }}+ />+ <TextField+ label="Display name"+ value={displayName}+ onChange={(e) => setDisplayName(e.target.value)}+ disabled={submitting}+ helperText="Shown wherever a reference of this type appears."+ />+ <TextField+ label="Instructions"+ value={instructions}+ onChange={(e) => setInstructions(e.target.value)}+ disabled={submitting}+ multiline+ minRows={4}+ helperText={INSTRUCTIONS_DISCLOSURE}+ />+ <TextField+ label="Value hint"+ value={valueHint}+ onChange={(e) => setValueHint(e.target.value)}+ disabled={submitting}+ helperText="Shown under the URL box when someone creates a reference of this type — say what those URLs should point at."+ />+ <AccessSelect value={access} onChange={setAccess} disabled={submitting} />+ {referenceType.shadowed_by_builtin && (+ <Alert severity="warning">+ A built-in type now uses this slug, and the built-in wins: agents+ receive its display name and instructions, not the ones here.+ </Alert>+ )}+ {error && <Alert severity="error">{error}</Alert>}+ </Stack>+ </DialogContent>+ <DialogActions>+ <Button onClick={handleClose} disabled={submitting}>+ Cancel+ </Button>+ <Button+ variant="contained"+ onClick={handleSubmit}+ disabled={!canSubmit}+ startIcon={submitting ? <CircularProgress size={16} /> : undefined}+ >+ Save+ </Button>+ </DialogActions>+ </Dialog>+ );+}++function DeleteReferenceTypeDialog({+ referenceType,+ onClose,+ onDeleted,+}: {+ referenceType: ReferenceTypeDetail;+ onClose: () => void;+ onDeleted: () => void;+}) {+ const [submitting, setSubmitting] = useState(false);+ const [error, setError] = useState<string | null>(null);++ const handleClose = () => {+ if (submitting) return;+ onClose();+ };++ const handleDelete = async () => {+ setSubmitting(true);+ setError(null);+ try {+ await deleteReferenceType(referenceType.type);+ onDeleted();+ } catch (e) {+ setError(e instanceof Error ? e.message : "Failed to delete reference type");+ } finally {+ setSubmitting(false);+ }+ };++ return (+ <Dialog open onClose={handleClose} fullWidth maxWidth="xs">+ <DialogTitle>Delete reference type</DialogTitle>+ <DialogContent>+ <DialogContentText>+ Delete <b>{referenceType.display_name}</b> (<code>{referenceType.type}</code>+ )? This cannot be undone. A type still used by references cannot be+ deleted.+ </DialogContentText>+ {error && (+ <Alert severity="error" sx={{ mt: 2 }}>+ {error}+ </Alert>+ )}+ </DialogContent>+ <DialogActions>+ <Button onClick={handleClose} disabled={submitting}>+ Cancel+ </Button>+ <Button+ color="error"+ variant="contained"+ onClick={handleDelete}+ disabled={submitting}+ startIcon={submitting ? <CircularProgress size={16} /> : undefined}+ >+ Delete+ </Button>+ </DialogActions>+ </Dialog>+ );+}diff --git a/gateway/src/pages/resources/ReferencesTab.tsx b/gateway/src/pages/resources/ReferencesTab.tsxindex 58c0334d6..97ac9f21a 100644--- a/gateway/src/pages/resources/ReferencesTab.tsx+++ b/gateway/src/pages/resources/ReferencesTab.tsx@@ -26,12 +26,6 @@ export default function ReferencesTab({ refreshKey }: Props) {// eslint-disable-next-line react-hooks/exhaustive-deps}, [refreshKey]);- const displayNameByType = useMemo(() => {- const m: Record<string, string> = {};- for (const t of types ?? []) m[t.type] = t.display_name;- return m;- }, [types]);-const owners = useMemo(() => {const m = new Map<string, string>();for (const r of refs ?? []) {@@ -57,8 +51,11 @@ export default function ReferencesTab({ refreshKey }: Props) {field: "type",headerName: "Type",width: 150,- renderCell: ({ value }) => (- <Chip label={displayNameByType[value] ?? value} size="small" />+ renderCell: ({ row }) => (+ <Chip+ label={row.type_display_name ?? `${row.type} (unknown type)`}+ size="small"+ />),},{ field: "description", headerName: "Description", flex: 2, minWidth: 240 },@@ -87,7 +84,7 @@ export default function ReferencesTab({ refreshKey }: Props) {valueFormatter: (value) => formatDate(value as string),},],- [displayNameByType],+ [],);return (diff --git a/gateway/src/pages/resources/ResourcesPage.tsx b/gateway/src/pages/resources/ResourcesPage.tsxindex db324f4b9..2154720d2 100644--- a/gateway/src/pages/resources/ResourcesPage.tsx+++ b/gateway/src/pages/resources/ResourcesPage.tsx@@ -5,11 +5,20 @@ import { useNavigate, useSearchParams } from "react-router";import CreateDocumentDialog from "./CreateDocumentDialog";import CreatePackageDialog from "./CreatePackageDialog";import CreateReferenceDialog from "./CreateReferenceDialog";+import CreateReferenceTypeDialog from "./CreateReferenceTypeDialog";import DocumentsTab from "./DocumentsTab";import PackagesTab from "./PackagesTab";import ReferencesTab from "./ReferencesTab";+import ReferenceTypesTab from "./ReferenceTypesTab";-type ResourceTab = "references" | "documents" | "packages";+type ResourceTab = "references" | "types" | "documents" | "packages";++const NEW_LABELS: Record<ResourceTab, string> = {+ references: "New reference",+ types: "New reference type",+ documents: "New document",+ packages: "New package",+};export default function ResourcesPage() {const navigate = useNavigate();@@ -20,7 +29,9 @@ export default function ResourcesPage() {? "documents": tabParam === "packages"? "packages"- : "references";+ : tabParam === "types"+ ? "types"+ : "references";const [createOpen, setCreateOpen] = useState(false);const [refreshKey, setRefreshKey] = useState(0);@@ -48,12 +59,12 @@ export default function ResourcesPage() {navigate(`/resources/packages/${id}`);};- const newLabel =- tab === "references"- ? "New reference"- : tab === "documents"- ? "New document"- : "New package";+ const handleReferenceTypeCreated = () => {+ setCreateOpen(false);+ setRefreshKey((k) => k + 1);+ };++ const newLabel = NEW_LABELS[tab];return (<Box sx={{ display: "flex", flexDirection: "column", flexGrow: 1, minHeight: 0 }}>@@ -74,12 +85,14 @@ export default function ResourcesPage() {sx={{ mb: 2, borderBottom: 1, borderColor: "divider" }}><Tab label="References" value="references" />+ <Tab label="Reference types" value="types" /><Tab label="Documents" value="documents" /><Tab label="Packages" value="packages" /></Tabs><Box sx={{ display: "flex", flexDirection: "column", flexGrow: 1, minHeight: 0 }}>{tab === "references" && <ReferencesTab refreshKey={refreshKey} />}+ {tab === "types" && <ReferenceTypesTab refreshKey={refreshKey} />}{tab === "documents" && <DocumentsTab refreshKey={refreshKey} />}{tab === "packages" && <PackagesTab refreshKey={refreshKey} />}</Box>@@ -91,6 +104,13 @@ export default function ResourcesPage() {onCreated={handleReferenceCreated}/>)}+ {tab === "types" && (+ <CreateReferenceTypeDialog+ open={createOpen}+ onClose={() => setCreateOpen(false)}+ onCreated={handleReferenceTypeCreated}+ />+ )}{tab === "documents" && (<CreateDocumentDialogopen={createOpen}diff --git a/gateway/src/pages/rooms/RoomResourcesSection.tsx b/gateway/src/pages/rooms/RoomResourcesSection.tsxindex e3ef5fb9d..3a1d8fc1c 100644--- a/gateway/src/pages/rooms/RoomResourcesSection.tsx+++ b/gateway/src/pages/rooms/RoomResourcesSection.tsx@@ -25,7 +25,6 @@ import {import {useDocuments,usePackages,- useReferenceTypes,useReferences,useRoomDocuments,useRoomPackages,@@ -111,7 +110,6 @@ function RoomReferences({attachedPackageIds: Set<string>;packageDescriptions: Record<string, string>;}) {- const { data: types } = useReferenceTypes();const {data: attached,loading,@@ -127,11 +125,6 @@ function RoomReferences({() => new Set((attached ?? []).map((r) => r.id)),[attached],);- const displayNameByType = useMemo(() => {- const m: Record<string, string> = {};- for (const t of types ?? []) m[t.type] = t.display_name;- return m;- }, [types]);const options = useMemo<PickerOption[]>(() =>@@ -142,15 +135,15 @@ function RoomReferences({primary: (<Stack direction="row" alignItems="center" spacing={1}><Chip- label={displayNameByType[r.type] ?? r.type}+ label={r.type_display_name ?? `${r.type} (unknown type)`}size="small"/><span>{r.name || r.description}</span></Stack>),- search: `${r.name} ${r.description} ${r.type} ${displayNameByType[r.type] ?? ""}`.toLowerCase(),+ search: `${r.name} ${r.description} ${r.type} ${r.type_display_name ?? ""}`.toLowerCase(),})),- [allRefs, attachedIds, displayNameByType],+ [allRefs, attachedIds],);const handleAttach = async (ids: string[]) => {@@ -209,7 +202,7 @@ function RoomReferences({}}><Chip- label={displayNameByType[ref.type] ?? ref.type}+ label={ref.type_display_name ?? `${ref.type} (unknown type)`}size="small"/><Typography variant="body2" sx={{ flexGrow: 1 }}>