Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

feat: user permissions (#677)

harshil-2096f8b5eebda302
diff --git a/.changeset/user-permissions-v2.md b/.changeset/user-permissions-v2.md
new file mode 100644
index 000000000..531393034
--- /dev/null
+++ b/.changeset/user-permissions-v2.md
@@ -0,0 +1,5 @@
+---
+'@truefoundry/trueforge-ui': minor
+---
+
+Add optional resource permissions and gate agent, schedule, and session mutations.
diff --git a/packages/trueforge-ui/README.md b/packages/trueforge-ui/README.md
index a2c278e0a..c6a64ba06 100644
--- a/packages/trueforge-ui/README.md
+++ b/packages/trueforge-ui/README.md
@@ -535,6 +535,7 @@ type TrueForgeServerConfig =
apiKey: string;
controlPlaneURL: string;
gatewayPlaneURL?: string;
+ permissions?: PermissionsServer;
}
| {
type: 'trueforge';
@@ -542,6 +543,7 @@ type TrueForgeServerConfig =
token?: string;
fetch?: typeof fetch;
catalog?: CatalogServer;
+ permissions?: PermissionsServer;
}
| AgentUIServer;
@@ -551,6 +553,7 @@ type AgentUIServer = AgentChatServer &
sessions?: AgentSessionsServer;
metrics?: AgentMetricsServer;
schedules?: ScheduleServer;
+ permissions?: PermissionsServer;
};
```
@@ -562,9 +565,14 @@ type AgentUIServer = AgentChatServer &
| `sessions` | Agent details + sessions browser (`/sessions`, `/library/:agentId`) |
| `schedules` | Schedules page (`/schedules`) |
| `AgentMetricsServer` | Agent meter aggregates, chart definitions, and chart data |
+| `PermissionsServer` | Per-resource `USE`, `MANAGE`, and `DELETE` grants |
-Omit an optional port to hide its chrome and unregister its routes (same gate as the
-Settings button for `catalog`).
+Omit a chrome port such as `catalog` or `schedules` to hide and unregister its routes.
+
+When `permissions` is omitted from a custom or TrueFoundry server, actions remain enabled for backward compatibility.
+When provided, denied mutation controls stay visible but disabled with an explanatory tooltip. The built-in
+`type: "trueforge"` server enables checks automatically through the Harness permissions endpoint; an explicit
+`PermissionsServer` overrides that default.
**Zero-config TrueFoundry** — see [Getting started](#getting-started). The SDK calls `createTrueFoundryAgentUIServer` for you.
diff --git a/packages/trueforge-ui/docs/api.md b/packages/trueforge-ui/docs/api.md
index 7224ed438..eb9584eb0 100644
--- a/packages/trueforge-ui/docs/api.md
+++ b/packages/trueforge-ui/docs/api.md
@@ -51,6 +51,12 @@ agent-detail Metrics tab. Custom servers can provide `metrics` with
surface is split across the `AgentMetrics`, `AgentMetricsView`,
`AgentMetricsTimeRangeFilter`, `AgentMetricCard`, and `AgentMetricChart` slots.
+The built-in TrueForge config enables permissions automatically through the
+Harness endpoint and accepts an explicit `PermissionsServer` override.
+TrueFoundry and custom servers remain permissive unless they provide the optional
+port. `useResourcePermissions` reads `USE`, `MANAGE`, and `DELETE` grants, while
+`PermissionGuard` keeps denied actions visible and explained.
+
## Compose
| Export | Notes |
diff --git a/packages/trueforge-ui/package.json b/packages/trueforge-ui/package.json
index f475898fe..53978a804 100644
--- a/packages/trueforge-ui/package.json
+++ b/packages/trueforge-ui/package.json
@@ -95,7 +95,7 @@
"@openuidev/react-headless": "^0.9.4",
"@openuidev/react-lang": "^0.2.9",
"@openuidev/react-ui": "^0.13.2",
- "@truefoundry/assistant-ui-runtime": "0.1.34",
+ "@truefoundry/assistant-ui-runtime": "0.1.35",
"@truefoundry/trueforge-sdk": "workspace:*",
"chart.js": "^4.5.1",
"clsx": "^2.1.1",
diff --git a/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx b/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx
index c8d567a7e..c58d8352e 100644
--- a/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx
+++ b/packages/trueforge-ui/src/atoms/AgentOverflowMenu.tsx
@@ -7,6 +7,7 @@ import { Icon } from '../icons/Icon.js';
import { useOptionalServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
import type { AgentSpec } from '../server/types.js';
+import { useSlot } from '../theme/SlotsProvider.js';
import { auiButtonClass } from './lib/buttonClasses.js';
import { Button } from './primitives/Button.js';
import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from './primitives/Dialog.js';
@@ -22,6 +23,9 @@ export type AgentOverflowMenuProps = {
agentSpec?: AgentSpec;
/** Edit / Clone / Delete when composer is enabled. */
canMutate: boolean;
+ canUse?: boolean;
+ canManage?: boolean;
+ canDelete?: boolean;
canManageSchedules: boolean;
onEdit: () => void;
onManageSchedules?: () => void;
@@ -35,6 +39,9 @@ export function AgentOverflowMenu({
agentName,
agentSpec,
canMutate,
+ canUse = true,
+ canManage = true,
+ canDelete = true,
canManageSchedules,
onEdit,
onManageSchedules,
@@ -43,6 +50,7 @@ export function AgentOverflowMenu({
const builder = useOptionalServer();
const shell = useOptionalShellMode();
const toaster = useToasterOptional();
+ const PermissionGuard = useSlot('PermissionGuard');
const [pending, setPending] = useState<PendingAction>(null);
const [busy, setBusy] = useState(false);
@@ -59,7 +67,7 @@ export function AgentOverflowMenu({
};
const handleClone = async () => {
- if (builder == null || agentSpec == null) return;
+ if (!canUse || builder == null || agentSpec == null) return;
setBusy(true);
try {
await builder.saveAgent({
@@ -81,7 +89,7 @@ export function AgentOverflowMenu({
};
const handleDelete = async () => {
- if (builder == null || typeof builder.deleteAgent !== 'function') return;
+ if (!canDelete || builder == null || typeof builder.deleteAgent !== 'function') return;
setBusy(true);
try {
await builder.deleteAgent({ agentName });
@@ -115,33 +123,58 @@ export function AgentOverflowMenu({
}
>
{canEditOrClone ? (
- <DropdownMenuItem className="whitespace-nowrap" onClick={onEdit}>
- <Icon name="pencil" className="size-3.5" />
- Edit
- </DropdownMenuItem>
+ <PermissionGuard allowed={canManage}>
+ <DropdownMenuItem
+ className="whitespace-nowrap"
+ onClick={() => {
+ if (canManage) onEdit();
+ }}
+ >
+ <Icon name="pencil" className="size-3.5" />
+ Edit
+ </DropdownMenuItem>
+ </PermissionGuard>
) : null}
{canEditOrClone ? (
- <DropdownMenuItem className="whitespace-nowrap" onClick={() => setPending('clone')}>
- <Icon name="clone" className="size-3.5" />
- Clone
- </DropdownMenuItem>
+ <PermissionGuard allowed={canUse}>
+ <DropdownMenuItem
+ className="whitespace-nowrap"
+ onClick={() => {
+ if (canUse) setPending('clone');
+ }}
+ >
+ <Icon name="clone" className="size-3.5" />
+ Clone
+ </DropdownMenuItem>
+ </PermissionGuard>
) : null}
{showManageSchedules ? (
- <DropdownMenuItem className="whitespace-nowrap" onClick={onManageSchedules}>
- <Icon name="calendar-clock" className="size-3.5" />
- Manage Schedules
- </DropdownMenuItem>
+ <PermissionGuard allowed={canUse}>
+ <DropdownMenuItem
+ className="whitespace-nowrap"
+ onClick={() => {
+ if (canUse) onManageSchedules?.();
+ }}
+ >
+ <Icon name="calendar-clock" className="size-3.5" />
+ Manage Schedules
+ </DropdownMenuItem>
+ </PermissionGuard>
) : null}
{canMutate ? (
<>
{canEditOrClone || showManageSchedules ? <DropdownMenuSeparator /> : null}
- <DropdownMenuItem
- className="whitespace-nowrap text-failure-bg focus-visible:text-failure-bg"
- onClick={() => setPending('delete')}
- >
- <Icon name="trash" className="size-3.5" />
- Delete
- </DropdownMenuItem>
+ <PermissionGuard allowed={canDelete}>
+ <DropdownMenuItem
+ className="whitespace-nowrap text-failure-bg focus-visible:text-failure-bg"
+ onClick={() => {
+ if (canDelete) setPending('delete');
+ }}
+ >
+ <Icon name="trash" className="size-3.5" />
+ Delete
+ </DropdownMenuItem>
+ </PermissionGuard>
</>
) : null}
</DropdownMenu>
@@ -160,7 +193,11 @@ export function AgentOverflowMenu({
<Button.Secondary type="button" disabled={busy} onClick={closePending}>
Cancel
</Button.Secondary>
- <Button.Primary type="button" disabled={busy || builder == null} onClick={() => void handleClone()}>
+ <Button.Primary
+ type="button"
+ disabled={busy || !canUse || builder == null}
+ onClick={() => void handleClone()}
+ >
Clone
</Button.Primary>
</DialogFooter>
@@ -183,7 +220,7 @@ export function AgentOverflowMenu({
</Button.Secondary>
<Button.Destructive
type="button"
- disabled={busy || builder == null || typeof builder.deleteAgent !== 'function'}
+ disabled={busy || !canDelete || builder == null || typeof builder.deleteAgent !== 'function'}
onClick={() => void handleDelete()}
>
Delete
diff --git a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
index ab3045d9a..edf7ea494 100644
--- a/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
+++ b/packages/trueforge-ui/src/atoms/AgentsLibrary.tsx
@@ -2,6 +2,7 @@
import { useCallback, useEffect, useState } from 'react';
+import { useResourcePermissions } from '../hooks/useResourcePermissions.js';
import { useSessionShareSearch } from '../hooks/useSessionShareSearch.js';
import { Icon } from '../icons/Icon.js';
import { isSchedulesChromeEnabled, isSessionsChromeEnabled } from '../server/serverChrome.js';
@@ -33,6 +34,9 @@ export type AgentScheduleSummary = {
export type AgentLibraryRowProps = {
agent: AgentLibraryEntry;
canMutate: boolean;
+ canUseAgent?: boolean;
+ canManageAgent?: boolean;
+ canDeleteAgent?: boolean;
canManageSchedules: boolean;
scheduleSummary?: AgentScheduleSummary | null;
onOpenSchedules?: () => void;
@@ -49,7 +53,15 @@ function displayModelLabel(modelName: string): string {
return slash >= 0 ? modelName.slice(slash + 1) : modelName;
}
-function AgentSchedulesEmptyState({ agentName, onOpen }: { agentName: string; onOpen?: () => void }) {
+function AgentSchedulesEmptyState({
+ agentName,
+ onOpen,
+ disabled,
+}: {
+ agentName: string;
+ onOpen?: () => void;
+ disabled: boolean;
+}) {
return (
<>
<span aria-hidden className="text-text-secondary text-sm md:group-hover:hidden">
@@ -58,6 +70,7 @@ function AgentSchedulesEmptyState({ agentName, onOpen }: { agentName: string; on
<Button.Ghost
type="button"
size="small"
+ disabled={disabled}
aria-label={`Add schedule for ${agentName}`}
className="hidden md:group-hover:inline-flex"
onClick={onOpen}
@@ -73,10 +86,12 @@ function AgentSchedulesBadge({
summary,
agentName,
onOpen,
+ disabled,
}: {
summary: AgentScheduleSummary;
agentName: string;
onOpen?: () => void;
+ disabled: boolean;
}) {
const pausedCount = summary.pausedCount;
const activeCount = summary.count - pausedCount;
@@ -87,6 +102,7 @@ function AgentSchedulesBadge({
return (
<button
type="button"
+ disabled={disabled}
aria-label={`${ariaParts.join(', ')} schedules for ${agentName}`}
className="inline-flex cursor-pointer items-center gap-1.5"
onClick={onOpen}
@@ -111,6 +127,9 @@ function AgentSchedulesBadge({
export function AgentLibraryRow({
agent,
canMutate,
+ canUseAgent = true,
+ canManageAgent = true,
+ canDeleteAgent = true,
canManageSchedules,
scheduleSummary,
onOpenSchedules,
@@ -120,6 +139,7 @@ export function AgentLibraryRow({
onEdit,
onManageSchedules,
}: AgentLibraryRowProps) {
+ const PermissionGuard = useSlot('PermissionGuard');
const spec = agent.agentSpec;
const modelName = spec?.model.name;
const skillsCount = spec?.skills?.length ?? 0;
@@ -191,9 +211,14 @@ export function AgentLibraryRow({
{scheduleSummary !== undefined ? (
<TableCell>
{scheduleSummary != null && scheduleSummary.count > 0 ? (
- <AgentSchedulesBadge summary={scheduleSummary} agentName={agent.name} onOpen={onOpenSchedules} />
+ <AgentSchedulesBadge
+ summary={scheduleSummary}
+ agentName={agent.name}
+ onOpen={onOpenSchedules}
+ disabled={!canUseAgent}
+ />
) : scheduleSummary != null ? (
- <AgentSchedulesEmptyState agentName={agent.name} onOpen={onCreateSchedule} />
+ <AgentSchedulesEmptyState agentName={agent.name} onOpen={onCreateSchedule} disabled={!canUseAgent} />
) : (
<span className="text-text-secondary text-sm" aria-label={`Schedule count unavailable for ${agent.name}`}>
—
@@ -203,14 +228,19 @@ export function AgentLibraryRow({
) : null}
<TableCell className="w-px">
<div className="flex items-center justify-end gap-1.5">
- <Button.Secondary type="button" aria-label={`Try agent ${agent.name}`} size="large" onClick={onTry}>
- <Icon name="play" className="size-3.5" />
- Try
- </Button.Secondary>
+ <PermissionGuard allowed={canUseAgent}>
+ <Button.Secondary type="button" aria-label={`Try agent ${agent.name}`} size="large" onClick={onTry}>
+ <Icon name="play" className="size-3.5" />
+ Try
+ </Button.Secondary>
+ </PermissionGuard>
<AgentOverflowMenu
agentName={agent.name}
{...(spec != null ? { agentSpec: spec } : {})}
canMutate={canMutate}
+ canUse={canUseAgent}
+ canManage={canManageAgent}
+ canDelete={canDeleteAgent}
canManageSchedules={canManageSchedules}
onEdit={onEdit}
{...(onManageSchedules != null ? { onManageSchedules } : {})}
@@ -302,6 +332,11 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {
query,
refreshKey: agentsListEpoch,
});
+ const permissionAgentIds = open ? agents.map(libraryAgentId) : [];
+ const { allows } = useResourcePermissions({
+ resourceType: 'agent',
+ resourceIds: permissionAgentIds,
+ });
useEffect(() => {
if (!open || scheduleServer == null || agents.length === 0) {
@@ -432,6 +467,9 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {
key={id}
agent={agent}
canMutate={canMutate}
+ canUseAgent={allows(id, 'USE')}
+ canManageAgent={allows(id, 'MANAGE')}
+ canDeleteAgent={allows(id, 'DELETE')}
canManageSchedules={canOpenAgentSchedules}
{...(summary !== undefined ? { scheduleSummary: summary } : {})}
{...(canOpenAgentSchedules && agentId != null
@@ -455,9 +493,11 @@ export function AgentsLibrary({ onSelectAgent }: AgentsLibraryProps) {
},
}
: {})}
- onTry={() => handleTry(agent)}
+ onTry={() => {
+ if (allows(id, 'USE')) handleTry(agent);
+ }}
onEdit={() => {
- if (agentSpec != null) handleEdit(agent, agentSpec);
+ if (agentSpec != null && allows(id, 'MANAGE')) handleEdit(agent, agentSpec);
}}
/>
);
diff --git a/packages/trueforge-ui/src/atoms/ClearChatButton.tsx b/packages/trueforge-ui/src/atoms/ClearChatButton.tsx
index 5bdc35ab3..20a09088d 100644
--- a/packages/trueforge-ui/src/atoms/ClearChatButton.tsx
+++ b/packages/trueforge-ui/src/atoms/ClearChatButton.tsx
@@ -1,8 +1,10 @@
'use client';
import { useChatChromeActionsVisible } from '../hooks/useChatChromeActionsVisible.js';
+import { useActiveSessionCanManage } from '../hooks/useResourcePermissions.js';
import { Icon } from '../icons/Icon.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
+import { useSlot } from '../theme/SlotsProvider.js';
import { auiButtonClass } from './lib/buttonClasses.js';
// Resets the current chat / draft (Try Agent, New Chat, New Agent, Edit).
@@ -10,19 +12,25 @@ import { auiButtonClass } from './lib/buttonClasses.js';
export function ClearChatButton() {
const shell = useOptionalShellMode();
const visible = useChatChromeActionsVisible();
+ const canManageSession = useActiveSessionCanManage();
+ const PermissionGuard = useSlot('PermissionGuard');
if (!visible || shell == null) return null;
return (
- <button
- type="button"
- title="Clear chat"
- className={auiButtonClass({ variant: 'ghost', size: 'large' })}
- onClick={() => shell.clearChat()}
- >
- <Icon name="broom" size="0.875rem" />
- Clear chat
- </button>
+ <PermissionGuard allowed={canManageSession}>
+ <button
+ type="button"
+ title="Clear chat"
+ className={auiButtonClass({ variant: 'ghost', size: 'large' })}
+ onClick={() => {
+ if (canManageSession) shell.clearChat();
+ }}
+ >
+ <Icon name="broom" size="0.875rem" />
+ Clear chat
+ </button>
+ </PermissionGuard>
);
}
diff --git a/packages/trueforge-ui/src/atoms/PermissionGuard.tsx b/packages/trueforge-ui/src/atoms/PermissionGuard.tsx
new file mode 100644
index 000000000..86a4fa51a
--- /dev/null
+++ b/packages/trueforge-ui/src/atoms/PermissionGuard.tsx
@@ -0,0 +1,38 @@
+'use client';
+
+import { cloneElement, type ReactElement } from 'react';
+
+import { Tooltip } from './primitives/Tooltip.js';
+
+export type PermissionGuardProps = {
+ allowed: boolean;
+ children: ReactElement<{ disabled?: boolean }>;
+ deniedMessage?: string;
+};
+
+export const PERMISSION_DENIED_MESSAGE = 'You do not have permission to perform this action.';
+
+export function PermissionGuard({
+ allowed,
+ children,
+ deniedMessage = PERMISSION_DENIED_MESSAGE,
+}: PermissionGuardProps) {
+ const guardedChild = cloneElement(children, {
+ disabled: children.props.disabled === true || !allowed,
+ });
+ if (allowed) return guardedChild;
+
+ return (
+ <Tooltip content={deniedMessage}>
+ <span aria-disabled="true" className="inline-flex w-full cursor-not-allowed *:pointer-events-none">
+ {guardedChild}
+ </span>
+ </Tooltip>
+ );
+}
+
+declare module '../theme/SlotsProvider.js' {
+ interface AtomSlots {
+ PermissionGuard: typeof PermissionGuard;
+ }
+}
diff --git a/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx b/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx
index 90cf84bc2..e9c5c4fe8 100644
--- a/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx
+++ b/packages/trueforge-ui/src/atoms/SaveAgentButton.tsx
@@ -8,6 +8,7 @@ import {
import { useRef, useState } from 'react';
import { useSaveAgentVisible } from '../hooks/useChatChromeActionsVisible.js';
+import { useResourcePermissions } from '../hooks/useResourcePermissions.js';
import { Icon } from '../icons/Icon.js';
import { useOptionalServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
@@ -72,8 +73,15 @@ function SaveAgentButtonContent({
const adoptAgentSpec = useTrueFoundryAdoptAgentSpec();
const builder = useOptionalServer();
const shell = useOptionalShellMode();
+ const agentId = shell?.mode.status === 'active' ? shell.mode.agentId : undefined;
+ const { allows } = useResourcePermissions({
+ resourceType: 'agent',
+ resourceIds: agentId == null ? [] : [agentId],
+ });
+ const canManageAgent = allows(agentId, 'MANAGE');
const configInstructions = useOptionalAgentConfigInstructions();
const SaveAgentForm = useSlot('SaveAgentForm');
+ const PermissionGuard = useSlot('PermissionGuard');
const visible = useSaveAgentVisible();
const [open, setOpen] = useState(false);
const [intent, setIntent] = useState<SaveIntent>('create');
@@ -91,6 +99,7 @@ function SaveAgentButtonContent({
const show = async () => {
if (agentSpecRef.current === null || builder === null) return;
+ if (agentId != null && !canManageAgent) return;
setError(null);
configInstructions?.flush();
await flushAgentSpec();
@@ -108,6 +117,7 @@ function SaveAgentButtonContent({
const save = async () => {
if (builder === null || draftSpec === null) return;
+ if (intent === 'update' && !canManageAgent) return;
const normalizedName = name.trim();
if (!normalizedName || !draftSpec.model.name.trim()) return;
setSaving(true);
@@ -145,16 +155,18 @@ function SaveAgentButtonContent({
return (
<>
- <Button.Primary
- type="button"
- size="large"
- disabled={disabled || builder === null || agentSpec === null}
- className={className}
- onClick={() => void show()}
- >
- <Icon name="save" className="size-3.5" />
- {triggerLabel}
- </Button.Primary>
+ <PermissionGuard allowed={canManageAgent}>
+ <Button.Primary
+ type="button"
+ size="large"
+ disabled={disabled || builder === null || agentSpec === null}
+ className={className}
+ onClick={() => void show()}
+ >
+ <Icon name="save" className="size-3.5" />
+ {triggerLabel}
+ </Button.Primary>
+ </PermissionGuard>
<SideDrawer
open={open}
diff --git a/packages/trueforge-ui/src/atoms/UserMessageActionBar.tsx b/packages/trueforge-ui/src/atoms/UserMessageActionBar.tsx
index 40e13eaa4..c98251caf 100644
--- a/packages/trueforge-ui/src/atoms/UserMessageActionBar.tsx
+++ b/packages/trueforge-ui/src/atoms/UserMessageActionBar.tsx
@@ -8,6 +8,7 @@ import { IconButton } from './primitives/IconButton.js';
export type UserMessageActionBarProps = {
isCopied: boolean;
editDisabled?: boolean;
+ retryDisabled?: boolean;
createdAt?: Date | string;
onCopy: () => void;
onEdit: () => void;
@@ -20,6 +21,7 @@ const actionBtnClass = 'h-6 w-6 text-text-secondary hover:text-text-primary [&_s
export function UserMessageActionBar({
isCopied,
editDisabled,
+ retryDisabled,
createdAt,
onCopy,
onEdit,
@@ -36,6 +38,7 @@ export function UserMessageActionBar({
tooltip="Try again"
variant="ghost"
className={actionBtnClass}
+ disabled={retryDisabled}
onClick={onRetry}
>
<Icon name="rotate-right" size="0.875em" />
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
index 6b2d5378b..617070bb2 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentDetailsHeader.tsx
@@ -1,8 +1,10 @@
'use client';
+import { useResourcePermissions } from '../../hooks/useResourcePermissions.js';
import { Icon } from '../../icons/Icon.js';
import { useOptionalServer } from '../../server/ServerContext.js';
import { useShellMode } from '../../server/ShellModeContext.js';
+import { useSlot } from '../../theme/SlotsProvider.js';
import { AgentOverflowMenu } from '../AgentOverflowMenu.js';
import { auiButtonClass } from '../lib/buttonClasses.js';
import { cn } from '../lib/cn.js';
@@ -13,10 +15,15 @@ import type { AgentDetailsHeaderProps } from './types.js';
export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHeaderProps) {
const shell = useShellMode();
const builder = useOptionalServer();
+ const { allows } = useResourcePermissions({ resourceType: 'agent', resourceIds: [agentId] });
const canMutate = shell.isComposerEnabled && detail != null && builder != null;
+ const canUse = allows(agentId, 'USE');
+ const canManage = allows(agentId, 'MANAGE');
+ const canDelete = allows(agentId, 'DELETE');
+ const PermissionGuard = useSlot('PermissionGuard');
const handleTry = () => {
- if (detail == null) return;
+ if (!canUse || detail == null) return;
shell.selectLibraryAgent({
isMutable: false,
agentId: detail.agentId,
@@ -25,7 +32,7 @@ export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHead
};
const handleEdit = () => {
- if (detail == null) return;
+ if (!canManage || detail == null) return;
shell.selectLibraryAgent({
isMutable: true,
isCreateAgent: true,
@@ -60,21 +67,26 @@ export function AgentDetailsHeader({ agentId, detail, onBack }: AgentDetailsHead
}
end={
<>
- <Button.Primary
- type="button"
- aria-label="Try agent"
- size="large"
- disabled={detail == null}
- onClick={handleTry}
- >
- <Icon name="play" className="size-3.5" />
- Try
- </Button.Primary>
+ <PermissionGuard allowed={canUse}>
+ <Button.Primary
+ type="button"
+ aria-label="Try agent"
+ size="large"
+ disabled={detail == null}
+ onClick={handleTry}
+ >
+ <Icon name="play" className="size-3.5" />
+ Try
+ </Button.Primary>
+ </PermissionGuard>
{detail != null ? (
<AgentOverflowMenu
agentName={detail.name}
agentSpec={detail.agentSpec}
canMutate={canMutate}
+ canUse={canUse}
+ canManage={canManage}
+ canDelete={canDelete}
canManageSchedules={false}
onEdit={handleEdit}
onDeleted={onBack}
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
index 202c2c548..bbdd97144 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessionDetailHeader.tsx
@@ -3,6 +3,7 @@
import { useEffect, useState } from 'react';
import { Icon } from '../../icons/Icon.js';
+import { useSlot } from '../../theme/SlotsProvider.js';
import { buildAgentSessionShareUrl } from '../../utils/sessionShareUrl.js';
import { auiButtonClass } from '../lib/buttonClasses.js';
import { cn } from '../lib/cn.js';
@@ -22,8 +23,10 @@ export function AgentSessionDetailHeader({
resumeHref,
onResume,
resumeLabel,
+ canResume = true,
}: AgentSessionDetailHeaderProps) {
const [copied, setCopied] = useState(false);
+ const PermissionGuard = useSlot('PermissionGuard');
useEffect(() => {
if (!copied) return undefined;
@@ -59,7 +62,7 @@ export function AgentSessionDetailHeader({
</button>
</LightTooltip>
</div>
- {resumeLabel != null && resumeHref != null ? (
+ {resumeLabel != null && resumeHref != null && canResume ? (
<a
href={resumeHref}
target="_blank"
@@ -69,10 +72,25 @@ export function AgentSessionDetailHeader({
{resumeLabel}
<Icon name="square-arrow-out-up-right" className="shrink-0" />
</a>
+ ) : resumeLabel != null && resumeHref != null ? (
+ <PermissionGuard allowed={false}>
+ <Button.Secondary type="button" size="large">
+ {resumeLabel}
+ <Icon name="square-arrow-out-up-right" className="shrink-0" />
+ </Button.Secondary>
+ </PermissionGuard>
) : resumeLabel != null && onResume != null ? (
- <Button.Secondary type="button" size="large" onClick={onResume}>
- {resumeLabel}
- </Button.Secondary>
+ <PermissionGuard allowed={canResume}>
+ <Button.Secondary
+ type="button"
+ size="large"
+ onClick={() => {
+ if (canResume) onResume();
+ }}
+ >
+ {resumeLabel}
+ </Button.Secondary>
+ </PermissionGuard>
) : null}
<button
type="button"
diff --git a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
index 129b51ed5..504d1514e 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
+++ b/packages/trueforge-ui/src/atoms/agent-details/AgentSessions.tsx
@@ -3,6 +3,7 @@
import { useCallback, useEffect, useMemo, useRef, useState, type ComponentType } from 'react';
import { Group, Panel, Separator } from 'react-resizable-panels';
+import { useResourcePermissions } from '../../hooks/useResourcePermissions.js';
import { useSessionShareSearch } from '../../hooks/useSessionShareSearch.js';
import { Icon } from '../../icons/Icon.js';
import { buildSessionResumeHref } from '../../routing/paths.js';
@@ -41,6 +42,11 @@ export function AgentSessions({ agentId, startTimestamp, endTimestamp, shareView
const shell = useOptionalShellMode();
const routes = useOptionalResolvedRoutes();
const { sessionId: selectedSessionId, updateShareSearch } = useSessionShareSearch();
+ const { allows } = useResourcePermissions({
+ resourceType: 'session',
+ resourceIds: selectedSessionId == null ? [] : [selectedSessionId],
+ });
+ const canResume = allows(selectedSessionId, 'MANAGE');
const AgentSessionListRow = useSlot('AgentSessionListRow');
const AgentSessionDetailHeader = useSlot('AgentSessionDetailHeader');
@@ -193,7 +199,7 @@ export function AgentSessions({ agentId, startTimestamp, endTimestamp, shareView
: null;
const handleResume = () => {
- if (selectedSessionId == null || shell == null) return;
+ if (!canResume || selectedSessionId == null || shell == null) return;
const agentName = detailSession?.agentName ?? selectedEntry?.agentName;
shell.openHistorySession({
sessionId: selectedSessionId,
@@ -312,6 +318,7 @@ export function AgentSessions({ agentId, startTimestamp, endTimestamp, shareView
createdAt={detailSession?.createdAt ?? selectedEntry?.createdAt}
view={shareView}
onClose={clearSelectedSession}
+ canResume={canResume}
{...resumeProps}
/>
{detailLoading || detailEvents === undefined ? (
diff --git a/packages/trueforge-ui/src/atoms/agent-details/types.ts b/packages/trueforge-ui/src/atoms/agent-details/types.ts
index 1005ae4cb..bea0ccb54 100644
--- a/packages/trueforge-ui/src/atoms/agent-details/types.ts
+++ b/packages/trueforge-ui/src/atoms/agent-details/types.ts
@@ -50,6 +50,8 @@ export type AgentSessionDetailHeaderProps = {
onResume?: () => void;
/** Label for the resume action. */
resumeLabel?: string;
+ /** Whether the current user may resume this session. */
+ canResume?: boolean;
};
export type AgentSessionTurnHeaderProps = {
diff --git a/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx b/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
index 11688e843..93c06251c 100644
--- a/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
+++ b/packages/trueforge-ui/src/atoms/draft/AgentConfigPanel.tsx
@@ -38,6 +38,7 @@ export type AgentConfigPanelProps = {
onOpenEditor: (editor: AgentConfigEditor) => void;
onChange?: (spec: AgentSpec) => void;
onClose?: () => void;
+ disabled?: boolean;
};
function formatTokens(value: number): string {
@@ -286,6 +287,7 @@ export function AgentConfigPanel({
onOpenEditor,
onChange,
onClose,
+ disabled = false,
}: AgentConfigPanelProps) {
const Section = useSlot('AgentConfigSection');
const AgentModelEditorContent = useSlot('AgentModelEditorContent');
@@ -349,6 +351,7 @@ export function AgentConfigPanel({
type="button"
aria-label="Edit Model"
title="Edit Model"
+ disabled={disabled}
className="flex w-full cursor-pointer items-center gap-2 rounded-md py-1 text-left transition-colors"
>
<ProviderMark
@@ -397,6 +400,7 @@ export function AgentConfigPanel({
type="button"
aria-label="Model settings"
title="Model settings"
+ disabled={disabled}
className={auiButtonClass({
variant: 'ghost',
size: 'icon',
@@ -428,6 +432,7 @@ export function AgentConfigPanel({
<button
type="button"
aria-label="Edit Instructions"
+ disabled={disabled}
className="border-border hover:bg-ghost-button-hover flex w-full items-center gap-3 rounded-lg border p-3 text-left transition-colors"
onClick={() => onOpenEditor('instructions')}
>
@@ -454,7 +459,7 @@ export function AgentConfigPanel({
title="Runtime Config"
description="Control execution and context behavior."
actionIcon="sliders"
- onEdit={() => onOpenEditor('runtime')}
+ onEdit={disabled ? undefined : () => onOpenEditor('runtime')}
>
<dl className="text-text-secondary flex flex-wrap gap-x-3 gap-y-1 text-xs leading-relaxed">
{runtimeConfig.map(entry => (
@@ -471,7 +476,7 @@ export function AgentConfigPanel({
icon="mcp-server"
actionIcon="plus"
actionLabel="Add MCP server"
- onEdit={() => onOpenEditor('mcp')}
+ onEdit={disabled ? undefined : () => onOpenEditor('mcp')}
>
{mcp.length ? (
<div className="flex flex-wrap gap-1.5">
@@ -480,7 +485,7 @@ export function AgentConfigPanel({
key={item.id}
item={item}
onRemove={
- onChange
+ onChange && !disabled
? () =>
onChange({
...spec,
@@ -489,7 +494,7 @@ export function AgentConfigPanel({
: undefined
}
onTogglePreload={
- onChange
+ onChange && !disabled
? () =>
onChange({
...spec,
@@ -507,7 +512,12 @@ export function AgentConfigPanel({
) : null}
</Section>
- <Section title="Skills" actionIcon="plus" actionLabel="Add skill" onEdit={() => onOpenEditor('skills')}>
+ <Section
+ title="Skills"
+ actionIcon="plus"
+ actionLabel="Add skill"
+ onEdit={disabled ? undefined : () => onOpenEditor('skills')}
+ >
{!skillsAvailable ? (
<p className="text-text-secondary text-xs">Skills require an available sandbox.</p>
) : skillMounts.length ? (
@@ -522,7 +532,7 @@ export function AgentConfigPanel({
item={item}
preloadAvailable={preloadAvailable}
onRemove={
- onChange
+ onChange && !disabled
? () =>
onChange({
...spec,
@@ -531,7 +541,7 @@ export function AgentConfigPanel({
: undefined
}
onTogglePreload={
- preloadAvailable && onChange
+ preloadAvailable && onChange && !disabled
? () =>
onChange({
...spec,
diff --git a/packages/trueforge-ui/src/atoms/primitives/DropdownMenu.tsx b/packages/trueforge-ui/src/atoms/primitives/DropdownMenu.tsx
index 69cf0292f..31b939ae5 100644
--- a/packages/trueforge-ui/src/atoms/primitives/DropdownMenu.tsx
+++ b/packages/trueforge-ui/src/atoms/primitives/DropdownMenu.tsx
@@ -161,7 +161,7 @@ export function DropdownMenu({
.join(' ') || undefined,
}}
className={cn(
- 'fixed z-[200] min-w-[8rem] rounded-md border border-border bg-card-bg p-1',
+ 'fixed z-[200] flex min-w-[8rem] flex-col rounded-md border border-border bg-card-bg p-1',
'text-text-primary shadow-md',
className,
)}
diff --git a/packages/trueforge-ui/src/atoms/schedules/ScheduleFormDrawer.tsx b/packages/trueforge-ui/src/atoms/schedules/ScheduleFormDrawer.tsx
index 73394f67a..aebff6962 100644
--- a/packages/trueforge-ui/src/atoms/schedules/ScheduleFormDrawer.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/ScheduleFormDrawer.tsx
@@ -3,6 +3,7 @@
import { useEffect, useMemo, useState, type FormEvent, type ReactNode } from 'react';
import { useToasterOptional } from '../../containers/ToasterContainer.js';
+import { useResourcePermissions } from '../../hooks/useResourcePermissions.js';
import { Icon } from '../../icons/Icon.js';
import { useScheduleServer, useServer } from '../../server/ServerContext.js';
import { libraryAgentId, useOptionalShellMode } from '../../server/ShellModeContext.js';
@@ -57,6 +58,11 @@ function ScheduleFormDrawerBody({
const savedFromCreate = view.kind === 'form' ? view.saved : view.schedule;
const isExternalEdit = mode === 'edit' && view.kind === 'form' && view.saved == null && schedule != null;
const isCreatedEdit = view.kind === 'form' && view.saved != null;
+ const isInitialCreate = mode === 'create' && view.kind === 'form' && view.saved == null;
+ const { allows: allowsAgent } = useResourcePermissions({
+ resourceType: 'agent',
+ resourceIds: agentId.length === 0 ? [] : [agentId],
+ });
useEffect(() => {
if (!open) return;
@@ -128,8 +134,14 @@ function ScheduleFormDrawerBody({
const canSubmit = useMemo(() => {
const cron = valuesToCron(form);
- return form.name.trim().length > 0 && form.task.trim().length > 0 && cron.length > 0 && agentId.length > 0;
- }, [form, agentId]);
+ return (
+ form.name.trim().length > 0 &&
+ form.task.trim().length > 0 &&
+ cron.length > 0 &&
+ agentId.length > 0 &&
+ (!isInitialCreate || allowsAgent(agentId, 'USE'))
+ );
+ }, [agentId, allowsAgent, form, isInitialCreate]);
const enterTestView = (saved: Schedule) => {
setView({ kind: 'test', schedule: saved });
diff --git a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
index 0718738ce..9016f0a15 100644
--- a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
@@ -3,10 +3,12 @@
import { useCallback, useEffect, useMemo, useRef, useState, type ComponentType } from 'react';
import { useToasterOptional } from '../../containers/ToasterContainer.js';
+import { useResourcePermissions } from '../../hooks/useResourcePermissions.js';
import { Icon } from '../../icons/Icon.js';
import { useScheduleServer, useServer } from '../../server/ServerContext.js';
import { libraryAgentId } from '../../server/ShellModeContext.js';
import type { Schedule, ScheduleRun, ScheduleStatus } from '../../server/types.js';
+import { useSlot } from '../../theme/SlotsProvider.js';
import { readScheduleShareSearch, replaceScheduleShareSearch } from '../../utils/scheduleShareUrl.js';
import { EmptyScreen } from '../EmptyScreen.js';
import { auiButtonClass } from '../lib/buttonClasses.js';
@@ -82,6 +84,8 @@ function initialDrawerState(agentId?: string): DrawerState {
function ScheduleRowActions({
schedule,
running,
+ canManage,
+ canDelete,
onRunNow,
onEdit,
onTogglePause,
@@ -89,23 +93,28 @@ function ScheduleRowActions({
}: {
schedule: Schedule;
running: boolean;
+ canManage: boolean;
+ canDelete: boolean;
onRunNow: () => void;
onEdit: () => void;
onTogglePause: () => void;
onDelete: () => void;
}) {
+ const PermissionGuard = useSlot('PermissionGuard');
return (
<div className="inline-flex items-center justify-end gap-1.5">
- <Button.Secondary
- type="button"
- disabled={running}
- aria-label={`Run now ${schedule.name}`}
- size="large"
- onClick={onRunNow}
- >
- <Icon name={running ? 'loader' : 'play'} className={cn('size-3.5', running && 'animate-spin')} />
- Run now
- </Button.Secondary>
+ <PermissionGuard allowed={canManage}>
+ <Button.Secondary
+ type="button"
+ disabled={running}
+ aria-label={`Run now ${schedule.name}`}
+ size="large"
+ onClick={onRunNow}
+ >
+ <Icon name={running ? 'loader' : 'play'} className={cn('size-3.5', running && 'animate-spin')} />
+ Run now
+ </Button.Secondary>
+ </PermissionGuard>
<DropdownMenu
align="end"
trigger={
@@ -118,18 +127,24 @@ function ScheduleRowActions({
</button>
}
>
- <DropdownMenuItem onClick={onEdit}>
- <Icon name="pencil" className="size-3.5" />
- Edit
- </DropdownMenuItem>
- <DropdownMenuItem onClick={onTogglePause}>
- <Icon name={schedule.status === 'active' ? 'pause' : 'play'} className="size-3.5" />
- {schedule.status === 'active' ? 'Pause' : 'Resume'}
- </DropdownMenuItem>
- <DropdownMenuItem className="text-failure-bg focus:text-failure-bg" onClick={onDelete}>
- <Icon name="trash" className="size-3.5" />
- Delete
- </DropdownMenuItem>
+ <PermissionGuard allowed={canManage}>
+ <DropdownMenuItem onClick={onEdit}>
+ <Icon name="pencil" className="size-3.5" />
+ Edit
+ </DropdownMenuItem>
+ </PermissionGuard>
+ <PermissionGuard allowed={canManage}>
+ <DropdownMenuItem onClick={onTogglePause}>
+ <Icon name={schedule.status === 'active' ? 'pause' : 'play'} className="size-3.5" />
+ {schedule.status === 'active' ? 'Pause' : 'Resume'}
+ </DropdownMenuItem>
+ </PermissionGuard>
+ <PermissionGuard allowed={canDelete}>
+ <DropdownMenuItem className="text-failure-bg focus:text-failure-bg" onClick={onDelete}>
+ <Icon name="trash" className="size-3.5" />
+ Delete
+ </DropdownMenuItem>
+ </PermissionGuard>
</DropdownMenu>
</div>
);
@@ -141,6 +156,10 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
const toaster = useToasterOptional();
const [schedules, setSchedules] = useState<Schedule[]>([]);
+ const { allows } = useResourcePermissions({
+ resourceType: 'schedule',
+ resourceIds: schedules.map(schedule => schedule.id),
+ });
const [runsByScheduleId, setRunsByScheduleId] = useState<Record<string, ScheduleRun[]>>({});
const [runsLoading, setRunsLoading] = useState(false);
const [runningScheduleIds, setRunningScheduleIds] = useState<ReadonlySet<string>>(() => new Set());
@@ -154,6 +173,20 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
const [agentFilter, setAgentFilter] = useState(
() => agentId ?? filtersFromSearch(window.location.search).agentFilter,
);
+ const permissionAgentId = agentId ?? (agentFilter === 'all' ? null : agentFilter);
+ const permissionAgentIds = useMemo(
+ () => (permissionAgentId == null ? agentOptions.map(option => option.agentId) : [permissionAgentId]),
+ [agentOptions, permissionAgentId],
+ );
+ const { allows: allowsAgent } = useResourcePermissions({
+ resourceType: 'agent',
+ resourceIds: permissionAgentIds,
+ });
+ const canCreateSchedule =
+ server.permissions == null ||
+ (permissionAgentId == null
+ ? agentOptions.some(option => allowsAgent(option.agentId, 'USE'))
+ : allowsAgent(permissionAgentId, 'USE'));
const [drawer, setDrawer] = useState<DrawerState>(() => initialDrawerState(agentId));
const [pendingDelete, setPendingDelete] = useState<Schedule | null>(null);
const [pageSize, setPageSize] = useState(() => clampPageSize(DEFAULT_TABLE_PAGE_SIZE));
@@ -316,6 +349,7 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
const hasPageNav = prevTokenStack.length > 0 || nextPageToken != null;
const handleTogglePause = async (schedule: Schedule) => {
+ if (!allows(schedule.id, 'MANAGE')) return;
const nextStatus: ScheduleStatus = schedule.status === 'active' ? 'paused' : 'active';
try {
await scheduleServer.updateSchedule({ ...schedule, status: nextStatus });
@@ -326,6 +360,7 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
};
const handleRunNow = async (schedule: Schedule) => {
+ if (!allows(schedule.id, 'MANAGE')) return;
setRunningScheduleIds(prev => new Set(prev).add(schedule.id));
try {
await scheduleServer.createScheduleRun({ scheduleId: schedule.id });
@@ -344,6 +379,7 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
};
const handleDelete = async (schedule: Schedule) => {
+ if (!allows(schedule.id, 'DELETE')) return;
setPendingDelete(null);
try {
await scheduleServer.deleteSchedule({ id: schedule.id });
@@ -401,7 +437,9 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
) : null}
<Button.Primary
type="button"
+ disabled={!canCreateSchedule}
onClick={() =>
+ canCreateSchedule &&
setDrawer({
kind: 'create',
agentId: agentFilter !== 'all' ? agentFilter : undefined,
@@ -487,10 +525,16 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
<ScheduleRowActions
schedule={schedule}
running={runningScheduleIds.has(schedule.id)}
+ canManage={allows(schedule.id, 'MANAGE')}
+ canDelete={allows(schedule.id, 'DELETE')}
onRunNow={() => void handleRunNow(schedule)}
- onEdit={() => setDrawer({ kind: 'edit', schedule })}
+ onEdit={() => {
+ if (allows(schedule.id, 'MANAGE')) setDrawer({ kind: 'edit', schedule });
+ }}
onTogglePause={() => void handleTogglePause(schedule)}
- onDelete={() => setPendingDelete(schedule)}
+ onDelete={() => {
+ if (allows(schedule.id, 'DELETE')) setPendingDelete(schedule);
+ }}
/>
</TableCell>
</TableRow>
@@ -562,7 +606,11 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
<Button.Secondary type="button" onClick={() => setPendingDelete(null)}>
Cancel
</Button.Secondary>
- <Button.Destructive type="button" onClick={() => void handleDelete(pendingDelete)}>
+ <Button.Destructive
+ type="button"
+ disabled={!allows(pendingDelete.id, 'DELETE')}
+ onClick={() => void handleDelete(pendingDelete)}
+ >
Delete
</Button.Destructive>
</DialogFooter>
diff --git a/packages/trueforge-ui/src/containers/AgentConfigDrawerContainer.tsx b/packages/trueforge-ui/src/containers/AgentConfigDrawerContainer.tsx
index 8026f5b8c..92e6f1229 100644
--- a/packages/trueforge-ui/src/containers/AgentConfigDrawerContainer.tsx
+++ b/packages/trueforge-ui/src/containers/AgentConfigDrawerContainer.tsx
@@ -12,6 +12,7 @@ import { useAgentConfigInstructions } from '../atoms/draft/AgentConfigInstructio
import type { AgentInstructionsDraft } from '../atoms/draft/AgentInstructionsDrawer.js';
import { useDraftCatalog } from '../atoms/draft/DraftCatalogProvider.js';
import { withInitialUserMessages } from '../atoms/draft/agentConfigMessages.js';
+import { useResourcePermissions } from '../hooks/useResourcePermissions.js';
import { useOptionalServer, useServerCapabilities } from '../server/ServerContext.js';
import { shellIsCreateAgent, useShellMode } from '../server/ShellModeContext.js';
import type { AgentSpec, ConnectorState, McpToolSelection } from '../server/types.js';
@@ -22,6 +23,12 @@ export function AgentConfigDrawerContainer({ showClose = false }: { showClose?:
const updateAgentSpec = useTrueFoundryUpdateAgentSpec();
const flushAgentSpec = useTrueFoundryFlushAgentSpec();
const shell = useShellMode();
+ const agentId = shell.mode.status === 'active' ? shell.mode.agentId : undefined;
+ const { allows } = useResourcePermissions({
+ resourceType: 'agent',
+ resourceIds: agentId == null ? [] : [agentId],
+ });
+ const canManageAgent = allows(agentId, 'MANAGE');
const server = useOptionalServer();
const capabilities = useServerCapabilities();
const catalog = useDraftCatalog();
@@ -40,6 +47,10 @@ export function AgentConfigDrawerContainer({ showClose = false }: { showClose?:
if (isBuilder) catalog.ensureLoaded();
}, [catalog, isBuilder]);
+ useEffect(() => {
+ if (!canManageAgent) setEditor(null);
+ }, [canManageAgent]);
+
useEffect(() => {
if (!showClose || !shell.agentConfigOpen) return;
const onKeyDown = (event: KeyboardEvent) => {
@@ -72,6 +83,7 @@ export function AgentConfigDrawerContainer({ showClose = false }: { showClose?:
const commitSpec = useCallback(
({ next, instructions }: { next: AgentSpec; instructions: string }) => {
+ if (!canManageAgent) return;
if (next.skills && next.skills.length > 0 && capabilities?.sandbox.enabled === true) {
updateAgentSpec?.({
...next,
@@ -85,7 +97,7 @@ export function AgentConfigDrawerContainer({ showClose = false }: { showClose?:
}
updateAgentSpec?.({ ...next, instructions: instructions || undefined });
},
- [capabilities?.sandbox.enabled, updateAgentSpec],
+ [canManageAgent, capabilities?.sandbox.enabled, updateAgentSpec],
);
const updateSpec = useCallback(
@@ -137,8 +149,11 @@ export function AgentConfigDrawerContainer({ showClose = false }: { showClose?:
skills={catalog.skills}
skillsAvailable={capabilities?.skill.enabled === true}
instructions={instructionDraft}
- onOpenEditor={setEditor}
+ onOpenEditor={nextEditor => {
+ if (canManageAgent) setEditor(nextEditor);
+ }}
onChange={updateSpec}
+ disabled={!canManageAgent}
onClose={showClose ? closeDrawer : undefined}
/>
<AgentConfigEditors
diff --git a/packages/trueforge-ui/src/containers/AskUserContainer.tsx b/packages/trueforge-ui/src/containers/AskUserContainer.tsx
index 5847e111f..eaa41b6f4 100644
--- a/packages/trueforge-ui/src/containers/AskUserContainer.tsx
+++ b/packages/trueforge-ui/src/containers/AskUserContainer.tsx
@@ -13,7 +13,7 @@ import { useSlot } from '../theme/SlotsProvider.js';
const EMPTY_ANSWER: AskUserAnswerDraft = { radioValue: '', custom: '' };
-export function AskUserContainer() {
+export function AskUserContainer({ disabled = false }: { disabled?: boolean }) {
const AskUserPrompt = useSlot('AskUserPrompt');
const { pending, respond } = useTrueFoundryToolResponses();
const isRunning = useThreadIsRunning();
@@ -56,7 +56,7 @@ export function AskUserContainer() {
);
const selectedResponse =
currentAnswer.radioValue === ASK_USER_CUSTOM_OPTION ? currentAnswer.custom.trim() : currentAnswer.radioValue.trim();
- const isSubmitDisabled = isRunning || currentQuestion == null || selectedResponse.length === 0;
+ const isSubmitDisabled = isRunning || disabled || currentQuestion == null || selectedResponse.length === 0;
const isSubmitAllDisabled = isSubmitDisabled || !allQuestionsAnswered;
const onCurrentAnswerChange = useCallback((questionId: string, update: Partial<AskUserAnswerDraft>) => {
@@ -70,18 +70,18 @@ export function AskUserContainer() {
}, []);
const onSubmit = useCallback(() => {
- if (item == null || !allQuestionsAnswered) return;
+ if (disabled || item == null || !allQuestionsAnswered) return;
const content = getResponseForQuestion(item.toolCallId);
if (!content) return;
respond({ toolCallId: item.toolCallId, content });
- }, [allQuestionsAnswered, getResponseForQuestion, item, respond]);
+ }, [allQuestionsAnswered, disabled, getResponseForQuestion, item, respond]);
if (item == null || currentQuestion == null) return null;
return (
<AskUserPrompt
questions={questions}
- readOnly={isRunning}
+ readOnly={isRunning || disabled}
currentQuestion={currentQuestion}
currentQuestionIndex={safeIndex}
currentAnswer={currentAnswer}
diff --git a/packages/trueforge-ui/src/containers/ComposerContainer.tsx b/packages/trueforge-ui/src/containers/ComposerContainer.tsx
index fc15c1f76..437664e20 100644
--- a/packages/trueforge-ui/src/containers/ComposerContainer.tsx
+++ b/packages/trueforge-ui/src/containers/ComposerContainer.tsx
@@ -7,6 +7,7 @@ import { useRef } from 'react';
import { DraftCatalogProvider } from '../atoms/draft/DraftCatalogProvider.js';
import { useComposerBusyState } from '../hooks/useComposerBusyState.js';
import { useComposerPauseView } from '../hooks/useComposerPauseView.js';
+import { useActiveSessionCanManage } from '../hooks/useResourcePermissions.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
import { SlotsProvider, useSlot, useSlotIsDefault } from '../theme/SlotsProvider.js';
import { ApprovalNavContainer } from './ApprovalNavContainer.js';
@@ -55,9 +56,10 @@ function ComposerBody({
const requiresModel = shell == null || (shell.mode.status === 'active' && shell.mode.isMutable);
const hasModel = Boolean(agentSpec?.model?.name?.trim());
const { isBusy, send, resetBusy } = useComposerBusyState();
+ const canManageSession = useActiveSessionCanManage();
const cancel = useTrueFoundryCancel();
const fileInputRef = useRef<HTMLInputElement>(null);
- const disabled = isBusy || forceDisabled;
+ const disabled = isBusy || forceDisabled || !canManageSession;
const canSubmit = canSubmitComposer({ disabled, hasText, hasAttachments, requiresModel, hasModel });
const submit = () => {
if (!canSubmit) return;
@@ -117,11 +119,15 @@ function ComposerBody({
canSubmit={canSubmit}
isRunning={isBusy && !forceDisabled}
onSubmit={submit}
- onCancel={() => {
- resetBusy();
- void cancel();
- }}
- onAttach={() => fileInputRef.current?.click()}
+ onCancel={
+ canManageSession
+ ? () => {
+ resetBusy();
+ void cancel();
+ }
+ : undefined
+ }
+ onAttach={canManageSession ? () => fileInputRef.current?.click() : undefined}
/>
</ComposerPrimitive.Root>
</ComposerPrimitive.AttachmentDropzone>
@@ -169,15 +175,16 @@ export function ComposerContainer({
placeholder = 'Ask anything... (Shift+Enter for new line)',
}: ComposerContainerProps) {
const pauseView = useComposerPauseView();
+ const canManageSession = useActiveSessionCanManage();
if (pauseView.kind === 'mcp') {
- return <McpAuthContainer />;
+ return <McpAuthContainer disabled={!canManageSession} />;
}
if (pauseView.kind === 'custom') {
- return <CustomActionContainer />;
+ return <CustomActionContainer disabled={!canManageSession} />;
}
if (pauseView.kind === 'ask-user') {
- return <AskUserContainer />;
+ return <AskUserContainer disabled={!canManageSession} />;
}
if (pauseView.kind === 'approval') {
return (
diff --git a/packages/trueforge-ui/src/containers/CustomActionContainer.tsx b/packages/trueforge-ui/src/containers/CustomActionContainer.tsx
index a757eed3e..a243324ec 100644
--- a/packages/trueforge-ui/src/containers/CustomActionContainer.tsx
+++ b/packages/trueforge-ui/src/containers/CustomActionContainer.tsx
@@ -7,7 +7,7 @@ import { useCallback } from 'react';
import { useOptionalCustomActionRenderers } from '../server/CustomActionRenderersContext.js';
/** Host custom-action UI for a pending client-side tool response. */
-export function CustomActionContainer() {
+export function CustomActionContainer({ disabled = false }: { disabled?: boolean }) {
const renderers = useOptionalCustomActionRenderers();
const { pending, respond } = useTrueFoundryToolResponses();
const isRunning = useThreadIsRunning();
@@ -15,17 +15,17 @@ export function CustomActionContainer() {
const onSubmit = useCallback(
(content: string) => {
- if (item == null) return;
+ if (disabled || item == null) return;
const trimmed = content.trim();
if (!trimmed) return;
respond({ toolCallId: item.toolCallId, content: trimmed });
},
- [item, respond],
+ [disabled, item, respond],
);
if (item == null || item.toolName == null) return null;
const Renderer = renderers?.[item.toolName];
if (Renderer == null) return null;
- return <Renderer args={item.args ?? {}} disabled={isRunning} onSubmit={onSubmit} />;
+ return <Renderer args={item.args ?? {}} disabled={isRunning || disabled} onSubmit={onSubmit} />;
}
diff --git a/packages/trueforge-ui/src/containers/McpAuthContainer.tsx b/packages/trueforge-ui/src/containers/McpAuthContainer.tsx
index c79f03daa..0ea6bc7c6 100644
--- a/packages/trueforge-ui/src/containers/McpAuthContainer.tsx
+++ b/packages/trueforge-ui/src/containers/McpAuthContainer.tsx
@@ -30,7 +30,7 @@ function CatalogMcpAuthPrompt({ servers, onContinue, readOnly }: McpAuthPromptPr
return <McpAuthPrompt servers={servers} onConnect={handleConnect} onContinue={onContinue} readOnly={readOnly} />;
}
-export function McpAuthContainer() {
+export function McpAuthContainer({ disabled = false }: { disabled?: boolean }) {
const McpAuthPrompt = useSlot('McpAuthPrompt');
const { pending, resume } = useTrueFoundryMcpAuth();
const isRunning = useThreadIsRunning();
@@ -39,7 +39,15 @@ export function McpAuthContainer() {
if (!pending) return null;
if (catalog) {
- return <CatalogMcpAuthPrompt servers={pending.mcpServers} onContinue={() => void resume()} readOnly={isRunning} />;
+ return (
+ <CatalogMcpAuthPrompt
+ servers={pending.mcpServers}
+ onContinue={() => {
+ if (!disabled) void resume();
+ }}
+ readOnly={isRunning || disabled}
+ />
+ );
}
const handleConnect = (serverId: string) => {
@@ -53,8 +61,10 @@ export function McpAuthContainer() {
<McpAuthPrompt
servers={pending.mcpServers}
onConnect={handleConnect}
- onContinue={() => void resume()}
- readOnly={isRunning}
+ onContinue={() => {
+ if (!disabled) void resume();
+ }}
+ readOnly={isRunning || disabled}
/>
);
}
diff --git a/packages/trueforge-ui/src/containers/ThreadListContainer.tsx b/packages/trueforge-ui/src/containers/ThreadListContainer.tsx
index f9ac4e641..3f98b4f57 100644
--- a/packages/trueforge-ui/src/containers/ThreadListContainer.tsx
+++ b/packages/trueforge-ui/src/containers/ThreadListContainer.tsx
@@ -22,6 +22,7 @@ import {
} from '../atoms/lib/threadListMeta.js';
import { useIsMobile } from '../atoms/lib/useIsMobile.js';
import { BottomSheet } from '../atoms/primitives/BottomSheet.js';
+import { useResourcePermissions } from '../hooks/useResourcePermissions.js';
import { Icon } from '../icons/Icon.js';
import { useOptionalServer } from '../server/ServerContext.js';
import { useOptionalShellMode } from '../server/ShellModeContext.js';
@@ -44,7 +45,8 @@ export type ThreadListContainerProps = {
const deleteItemClass =
'flex w-full cursor-pointer select-none items-center gap-2 rounded-md px-2 py-1.5 text-sm font-medium text-failure-bg outline-none transition-colors hover:bg-failure-bg/12 hover:text-failure-bg focus:bg-failure-bg/12 focus:text-failure-bg data-[highlighted]:bg-failure-bg/12 data-[highlighted]:text-failure-bg';
-function ThreadListItemDeleteMenu() {
+function ThreadListItemDeleteMenu({ disabled }: { disabled: boolean }) {
+ const PermissionGuard = useSlot('PermissionGuard');
const compact = useCompactLayout();
const isMobile = useIsMobile();
const [sheetOpen, setSheetOpen] = useState(false);
@@ -77,11 +79,18 @@ function ThreadListItemDeleteMenu() {
</button>
{sheetOpen ? (
<BottomSheet open onOpenChange={setSheetOpen} aria-label="Session actions">
- <div className="flex flex-col gap-1 p-2" role="menu">
- <ThreadListItemPrimitive.Delete className={deleteItemClass} onClick={() => setSheetOpen(false)}>
- <Icon name="trash" className="size-3.5" />
- Delete
- </ThreadListItemPrimitive.Delete>
+ <div className="flex flex-col gap-1 p-2 *:w-full" role="menu">
+ <PermissionGuard allowed={!disabled}>
+ <ThreadListItemPrimitive.Delete
+ className={deleteItemClass}
+ onClick={() => {
+ if (!disabled) setSheetOpen(false);
+ }}
+ >
+ <Icon name="trash" className="size-3.5" />
+ Delete
+ </ThreadListItemPrimitive.Delete>
+ </PermissionGuard>
</div>
</BottomSheet>
) : null}
@@ -103,14 +112,14 @@ function ThreadListItemDeleteMenu() {
portalProps={{ container: portalContainer }}
align="end"
sideOffset={4}
- className="font-sans-flex z-50 min-w-[8rem] rounded-md border border-border bg-card-bg p-1 text-text-primary shadow-md"
+ className="font-sans-flex z-50 min-w-[8rem] rounded-md border border-border bg-card-bg p-1 text-text-primary shadow-md *:w-full"
>
- <ThreadListItemPrimitive.Delete asChild>
- <ThreadListItemMorePrimitive.Item className={deleteItemClass}>
+ <PermissionGuard allowed={!disabled}>
+ <ThreadListItemPrimitive.Delete className={deleteItemClass}>
<Icon name="trash" className="size-3.5" />
Delete
- </ThreadListItemMorePrimitive.Item>
- </ThreadListItemPrimitive.Delete>
+ </ThreadListItemPrimitive.Delete>
+ </PermissionGuard>
</ThreadListItemMorePrimitive.Content>
</ThreadListItemMorePrimitive.Root>
);
@@ -119,9 +128,11 @@ function ThreadListItemDeleteMenu() {
function ThreadListItemRow({
onThreadOpen,
canDeleteSession,
+ canDeleteResource,
}: {
onThreadOpen?: () => void;
canDeleteSession: boolean;
+ canDeleteResource: (sessionId: string) => boolean;
}) {
const aui = useAui();
const shell = useOptionalShellMode();
@@ -134,6 +145,7 @@ function ThreadListItemRow({
const mainThreadId = useAuiState(s => s.threads.mainThreadId);
const agentName = readThreadAgentName(custom);
const showDelete = canDeleteSession && remoteId != null;
+ const deleteDisabled = remoteId != null && !canDeleteResource(remoteId);
const sidebarNavOpen = shell?.libraryOpen === true || shell?.sessionsOpen === true || shell?.schedulesOpen === true;
return (
@@ -183,7 +195,7 @@ function ThreadListItemRow({
}
void Promise.resolve(aui.threads().switchToThread(id)).catch(() => undefined);
}}
- actions={showDelete ? <ThreadListItemDeleteMenu /> : undefined}
+ actions={showDelete ? <ThreadListItemDeleteMenu disabled={deleteDisabled} /> : undefined}
/>
</ThreadListItemPrimitive.Root>
);
@@ -216,10 +228,12 @@ function ThreadListItemsByRecency({
indices,
onThreadOpen,
canDeleteSession,
+ canDeleteResource,
}: {
indices: number[];
onThreadOpen?: () => void;
canDeleteSession: boolean;
+ canDeleteResource: (sessionId: string) => boolean;
}) {
// Newest-first: remount/switchToThread can append the active session to threadIds.
const threadIds = useAuiState(s => s.threads.threadIds);
@@ -230,7 +244,11 @@ function ThreadListItemsByRecency({
const key = threadIds[index] ?? String(index);
return (
<ThreadListItemByIndexProvider key={key} index={index} archived={false}>
- <ThreadListItemRow onThreadOpen={onThreadOpen} canDeleteSession={canDeleteSession} />
+ <ThreadListItemRow
+ onThreadOpen={onThreadOpen}
+ canDeleteSession={canDeleteSession}
+ canDeleteResource={canDeleteResource}
+ />
</ThreadListItemByIndexProvider>
);
})}
@@ -289,6 +307,7 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threa
const isLoadingMore = useAuiState(s => s.threads.isLoadingMore);
const hasMore = useAuiState(s => s.threads.hasMore);
const threadIds = useAuiState(s => s.threads.threadIds);
+ const threadItems = useAuiState(s => s.threads.threadItems);
const shell = useOptionalShellMode();
const ThreadListShell = useSlot('ThreadListShell');
@@ -310,6 +329,11 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threa
const isIdle = shell?.mode.status === 'idle';
const isRecentHistory = variant === 'recent-history';
const canDeleteSession = typeof server?.deleteSession === 'function';
+ const remoteSessionIds = useMemo(
+ () => threadItems.flatMap(item => (item.remoteId == null ? [] : [item.remoteId])),
+ [threadItems],
+ );
+ const { allows } = useResourcePermissions({ resourceType: 'session', resourceIds: remoteSessionIds });
// Fill an underflowing viewport; once it scrolls, paginate only near the bottom.
// Re-measure after commit (threadIds / hasMore) instead of rAF-chaining, which
@@ -374,7 +398,12 @@ export function ThreadListContainer({ onThreadOpen, variant = 'default' }: Threa
} else {
listBody = (
<ThreadListPrimitive.Root className="flex min-h-0 flex-col gap-0.5">
- <ThreadListItemsByRecency indices={indices} onThreadOpen={onThreadOpen} canDeleteSession={canDeleteSession} />
+ <ThreadListItemsByRecency
+ indices={indices}
+ onThreadOpen={onThreadOpen}
+ canDeleteSession={canDeleteSession}
+ canDeleteResource={sessionId => allows(sessionId, 'DELETE')}
+ />
</ThreadListPrimitive.Root>
);
}
diff --git a/packages/trueforge-ui/src/containers/ToolApprovalContainer.tsx b/packages/trueforge-ui/src/containers/ToolApprovalContainer.tsx
index 51f1e554a..d9e778c79 100644
--- a/packages/trueforge-ui/src/containers/ToolApprovalContainer.tsx
+++ b/packages/trueforge-ui/src/containers/ToolApprovalContainer.tsx
@@ -5,6 +5,7 @@ import { useCallback, useMemo, useState } from 'react';
import type { ApprovalOption } from '../atoms/ToolApprovalBar.js';
import { parseMcpToolArgs } from '@/utils/toolCallParsing.js';
+import { useActiveSessionCanManage } from '../hooks/useResourcePermissions.js';
import { useSlot } from '../theme/SlotsProvider.js';
export type ToolApprovalOption = {
@@ -32,6 +33,7 @@ export function ToolApprovalContainer({
onSelectOption,
}: ToolApprovalContainerProps) {
const ToolApprovalBar = useSlot('ToolApprovalBar');
+ const canManageSession = useActiveSessionCanManage();
const { mcpServer, innerToolName } = parseMcpToolArgs(argsText);
const displayToolName = innerToolName && mcpServer ? `${innerToolName} (${mcpServer})` : toolName;
const [selectedDenyOptionId, setSelectedDenyOptionId] = useState<string | null>(null);
@@ -71,6 +73,7 @@ export function ToolApprovalContainer({
setShowReasonError(false);
}, []);
const onReasonSubmit = useCallback(() => {
+ if (!canManageSession) return;
const reason = denialReason.trim();
if (!reason) {
setShowReasonError(true);
@@ -80,7 +83,7 @@ export function ToolApprovalContainer({
onSelectOption(selectedDenyOptionId, reason);
onDenyOptionChange(null);
}
- }, [denialReason, onDenyOptionChange, onSelectOption, selectedDenyOptionId]);
+ }, [canManageSession, denialReason, onDenyOptionChange, onSelectOption, selectedDenyOptionId]);
return (
<ToolApprovalBar
@@ -90,7 +93,15 @@ export function ToolApprovalContainer({
selectedDenyOption={selectedDenyOption}
denialReason={denialReason}
showReasonError={showReasonError}
- onSelect={onSelectOption}
+ disabled={!canManageSession}
+ onSelect={(optionId, reason) => {
+ if (!canManageSession) return;
+ if (reason === undefined) {
+ onSelectOption(optionId);
+ return;
+ }
+ onSelectOption(optionId, reason);
+ }}
onDenyOptionChange={onDenyOptionChange}
onDenialReasonChange={onDenialReasonChange}
onReasonSubmit={onReasonSubmit}
diff --git a/packages/trueforge-ui/src/containers/TrueFoundryChatProvider.tsx b/packages/trueforge-ui/src/containers/TrueFoundryChatProvider.tsx
index 215173079..10394c7fb 100644
--- a/packages/trueforge-ui/src/containers/TrueFoundryChatProvider.tsx
+++ b/packages/trueforge-ui/src/containers/TrueFoundryChatProvider.tsx
@@ -1,6 +1,6 @@
'use client';
-import { AssistantRuntimeProvider } from '@assistant-ui/react';
+import { AssistantRuntimeProvider, useAuiState } from '@assistant-ui/react';
import {
trueFoundryAttachmentAdapter,
useTrueFoundryAgentRuntime,
@@ -11,14 +11,44 @@ import { useCallback, useMemo, type ReactNode } from 'react';
import { sessionIsCreateAgent } from '../atoms/lib/sessionCreateAgent.js';
import { notifyComposerBusyFailure } from '../hooks/useComposerBusyState.js';
+import { ActiveSessionPermissionsProvider } from '../hooks/useResourcePermissions.js';
import type { AgentUIServer } from '../server/types.js';
import { ToasterProvider, useToaster } from './ToasterContainer.js';
type RuntimeAdapters = NonNullable<UseTrueFoundryAgentRuntimeOptions['adapters']>;
-function withoutCreateAgentSessions(server: AgentUIServer): AgentUIServer {
+function ActiveSessionPermissionScope({
+ locallyCreatedSessionIds,
+ children,
+}: {
+ locallyCreatedSessionIds: ReadonlySet<string>;
+ children: ReactNode;
+}) {
+ const remoteId = useAuiState(state => state.threadListItem.remoteId);
+ return (
+ <ActiveSessionPermissionsProvider
+ sessionId={remoteId}
+ assumeManage={remoteId != null && locallyCreatedSessionIds.has(remoteId)}
+ >
+ {children}
+ </ActiveSessionPermissionsProvider>
+ );
+}
+
+function runtimeServer({
+ server,
+ locallyCreatedSessionIds,
+}: {
+ server: AgentUIServer;
+ locallyCreatedSessionIds: Set<string>;
+}): AgentUIServer {
return {
...server,
+ async createSession(request) {
+ const session = await server.createSession(request);
+ locallyCreatedSessionIds.add(session.id);
+ return session;
+ },
async listSessions(request) {
const result = await server.listSessions(request);
return {
@@ -64,7 +94,12 @@ function ChatRuntimeScope({
}) {
const { showError } = useToaster();
const reportError = onError ?? showError;
- const historyServer = useMemo(() => withoutCreateAgentSessions(server), [server]);
+ const localSessionState = useMemo(() => ({ server, ids: new Set<string>() }), [server]);
+ const locallyCreatedSessionIds = localSessionState.ids;
+ const historyServer = useMemo(
+ () => runtimeServer({ server, locallyCreatedSessionIds }),
+ [locallyCreatedSessionIds, server],
+ );
// composer().send() is void and swallows onNew rejections; clear optimistic
// busy when the runtime reports a pre-stream failure (e.g. createSession).
const resolvedOnError = useCallback(
@@ -89,7 +124,13 @@ function ChatRuntimeScope({
},
});
- return <AssistantRuntimeProvider runtime={runtime as never}>{children}</AssistantRuntimeProvider>;
+ return (
+ <AssistantRuntimeProvider runtime={runtime as never}>
+ <ActiveSessionPermissionScope locallyCreatedSessionIds={locallyCreatedSessionIds}>
+ {children}
+ </ActiveSessionPermissionScope>
+ </AssistantRuntimeProvider>
+ );
}
/**
diff --git a/packages/trueforge-ui/src/containers/UserEditComposerContainer.tsx b/packages/trueforge-ui/src/containers/UserEditComposerContainer.tsx
index 6b297d2af..fe7f35b53 100644
--- a/packages/trueforge-ui/src/containers/UserEditComposerContainer.tsx
+++ b/packages/trueforge-ui/src/containers/UserEditComposerContainer.tsx
@@ -4,6 +4,7 @@ import { useComposerCancel, useComposerSend, useThreadIsRunning } from '@assista
import { ComposerPrimitive, MessagePrimitive, useAuiState } from '@assistant-ui/react';
import { Button } from '../atoms/primitives/Button.js';
+import { useActiveSessionCanManage } from '../hooks/useResourcePermissions.js';
import { useSlot } from '../theme/SlotsProvider.js';
import { MessageAttachmentsContainer } from './AttachmentsContainer.js';
@@ -23,6 +24,7 @@ export function UserEditComposerContainer() {
const UserMessageEdit = useSlot('UserMessageEdit');
const MessageTimestamp = useSlot('MessageTimestamp');
const isRunning = useThreadIsRunning();
+ const canManageSession = useActiveSessionCanManage();
const createdAt = useAuiState(s => s.message.createdAt);
const { cancel, disabled: cancelDisabled } = useComposerCancel();
const { disabled: sendDisabled } = useComposerSend();
@@ -40,7 +42,7 @@ export function UserEditComposerContainer() {
<div className="mt-1 rounded border border-border bg-secondary-bg p-2 text-text-primary">
<ComposerPrimitive.Input
data-slot="aui_user-edit-input"
- disabled={isRunning}
+ disabled={isRunning || !canManageSession}
submitMode="enter"
aria-label="Edit message"
className="max-h-32 min-h-10 w-full resize-none border-none bg-transparent p-0 text-base leading-[1.34] outline-none focus:shadow-none"
@@ -53,7 +55,7 @@ export function UserEditComposerContainer() {
Cancel
</Button.Secondary>
<ComposerPrimitive.Send asChild>
- <Button.Primary type="submit" disabled={sendDisabled || isRunning}>
+ <Button.Primary type="submit" disabled={sendDisabled || isRunning || !canManageSession}>
Save &amp; Rerun
</Button.Primary>
</ComposerPrimitive.Send>
diff --git a/packages/trueforge-ui/src/containers/UserMessageContainer.tsx b/packages/trueforge-ui/src/containers/UserMessageContainer.tsx
index 611ebbbe9..b85752019 100644
--- a/packages/trueforge-ui/src/containers/UserMessageContainer.tsx
+++ b/packages/trueforge-ui/src/containers/UserMessageContainer.tsx
@@ -3,6 +3,7 @@
import { useActionBarCopy, useActionBarEdit, useThreadIsRunning } from '@assistant-ui/core/react';
import { MessagePrimitive, useAui, useAuiState } from '@assistant-ui/react';
+import { useActiveSessionCanManage } from '../hooks/useResourcePermissions.js';
import { useSlot } from '../theme/SlotsProvider.js';
import { MessageAttachmentsContainer } from './AttachmentsContainer.js';
@@ -10,6 +11,7 @@ export function UserMessageContainer() {
const UserMessageBubble = useSlot('UserMessageBubble');
const UserMessageActionBar = useSlot('UserMessageActionBar');
const isRunning = useThreadIsRunning();
+ const canManageSession = useActiveSessionCanManage();
const aui = useAui();
const createdAt = useAuiState(s => s.message.createdAt);
const text = useAuiState(s =>
@@ -32,11 +34,13 @@ export function UserMessageContainer() {
!isRunning ? (
<UserMessageActionBar
isCopied={isCopied}
- editDisabled={editDisabled}
+ editDisabled={editDisabled || !canManageSession}
+ retryDisabled={!canManageSession}
createdAt={createdAt}
onCopy={copy}
onEdit={edit}
onRetry={() => {
+ if (!canManageSession) return;
aui.message().composer().beginEdit();
aui.message().composer().send({ startRun: true });
}}
diff --git a/packages/trueforge-ui/src/containers/useResolvedServer.ts b/packages/trueforge-ui/src/containers/useResolvedServer.ts
index 5beb867a8..c8f0cda15 100644
--- a/packages/trueforge-ui/src/containers/useResolvedServer.ts
+++ b/packages/trueforge-ui/src/containers/useResolvedServer.ts
@@ -4,7 +4,12 @@ import { createTrueFoundryAgentUIServer } from '@truefoundry/assistant-ui-runtim
import { useEffect, useState } from 'react';
import type { TrueForgeBuiltInServerConfig, TrueForgeServerConfig } from '../server/TrueForgeServerConfig.js';
-import type { AgentBuilderCapabilitiesResponse, AgentUIServer, CatalogServer } from '../server/types.js';
+import type {
+ AgentBuilderCapabilitiesResponse,
+ AgentUIServer,
+ CatalogServer,
+ PermissionsServer,
+} from '../server/types.js';
export type ResolvedServerState =
| { status: 'loading'; server: null; error: null }
@@ -36,18 +41,26 @@ function hasGetCapabilities(
}
/**
- * Attach optional catalog and ensure `getCapabilities` exists on the composed port.
+ * Attach optional host ports and ensure `getCapabilities` exists on the composed port.
*/
-function toAgentUIServer(server: object, catalog: CatalogServer | undefined): AgentUIServer {
+function toAgentUIServer(
+ server: object,
+ catalog: CatalogServer | undefined,
+ permissions: PermissionsServer | undefined,
+): AgentUIServer {
const getCapabilities = hasGetCapabilities(server)
? () => server.getCapabilities()
: async () => DEFAULT_CAPABILITIES;
const withCapabilities = { ...server, getCapabilities };
- const withCatalog = catalog != null ? { ...withCapabilities, catalog } : withCapabilities;
- if (!isAgentUIServer(withCatalog)) {
+ const withOptionalPorts = {
+ ...withCapabilities,
+ ...(catalog == null ? {} : { catalog }),
+ ...(permissions == null ? {} : { permissions }),
+ };
+ if (!isAgentUIServer(withOptionalPorts)) {
throw new Error('TrueForgeUI: runtime adapter returned an incomplete AgentUIServer');
}
- return withCatalog;
+ return withOptionalPorts;
}
function isAgentUIServer(value: object): value is AgentUIServer {
@@ -90,6 +103,7 @@ export function useResolvedServer(
const trueforgeToken = builtIn?.type === 'trueforge' ? (builtIn.token ?? '') : '';
const trueforgeFetch = builtIn?.type === 'trueforge' ? builtIn.fetch : undefined;
const catalog = builtIn?.catalog;
+ const permissions = builtIn?.permissions;
const [state, setState] = useState<ResolvedServerState>(() => {
if (directServer) {
@@ -115,6 +129,7 @@ export function useResolvedServer(
...(trueforgeToken ? { token: trueforgeToken } : {}),
...(trueforgeFetch !== undefined ? { fetch: trueforgeFetch } : {}),
...(catalog != null ? { catalog } : {}),
+ ...(permissions != null ? { permissions } : {}),
});
}
@@ -124,7 +139,7 @@ export function useResolvedServer(
...(gatewayPlaneURL ? { gatewayURL: gatewayPlaneURL } : {}),
});
// TrueFoundry adapter may omit catalog; attach host-supplied catalog here.
- return toAgentUIServer(runtimeServer, catalog);
+ return toAgentUIServer(runtimeServer, catalog, permissions);
};
void resolve()
@@ -134,7 +149,7 @@ export function useResolvedServer(
// trueforge factory already includes catalog; still normalize capabilities.
setState({
status: 'ready',
- server: type === 'trueforge' ? toAgentUIServer(server, undefined) : server,
+ server: type === 'trueforge' ? toAgentUIServer(server, undefined, undefined) : server,
error: null,
});
} catch (error: unknown) {
@@ -161,6 +176,7 @@ export function useResolvedServer(
trueforgeToken,
trueforgeFetch,
catalog,
+ permissions,
onError,
]);
diff --git a/packages/trueforge-ui/src/hooks/useResourcePermissions.ts b/packages/trueforge-ui/src/hooks/useResourcePermissions.ts
new file mode 100644
index 000000000..3b31beb48
--- /dev/null
+++ b/packages/trueforge-ui/src/hooks/useResourcePermissions.ts
@@ -0,0 +1,153 @@
+'use client';
+
+import {
+ createContext,
+ createElement,
+ useCallback,
+ useContext,
+ useEffect,
+ useMemo,
+ useState,
+ type ReactNode,
+} from 'react';
+
+import { useOptionalPermissionsServer } from '../server/ServerContext.js';
+import type { PermissionResourceType, PermissionsServer, ResourcePermission } from '../server/types.js';
+
+const PERMISSIONS_BATCH_SIZE = 100;
+
+type PermissionsLoadState = {
+ server: PermissionsServer | null;
+ resourceType: PermissionResourceType | null;
+ key: string;
+ data: Record<string, ResourcePermission[]>;
+ loading: boolean;
+ error: unknown | null;
+};
+
+export type UseResourcePermissionsOptions = {
+ resourceType: PermissionResourceType;
+ resourceIds: readonly string[];
+};
+
+export type UseResourcePermissionsResult = {
+ loading: boolean;
+ error: unknown | null;
+ allows: (resourceId: string | null | undefined, permission: ResourcePermission) => boolean;
+};
+
+function parseResourceIds(value: string): string[] {
+ const parsed: unknown = JSON.parse(value);
+ if (!Array.isArray(parsed)) return [];
+ return parsed.filter((resourceId): resourceId is string => typeof resourceId === 'string');
+}
+
+function permissionBatches(resourceIds: string[]): string[][] {
+ const batches: string[][] = [];
+ for (let offset = 0; offset < resourceIds.length; offset += PERMISSIONS_BATCH_SIZE) {
+ batches.push(resourceIds.slice(offset, offset + PERMISSIONS_BATCH_SIZE));
+ }
+ return batches;
+}
+
+export function useResourcePermissions({
+ resourceType,
+ resourceIds,
+}: UseResourcePermissionsOptions): UseResourcePermissionsResult {
+ const server = useOptionalPermissionsServer();
+ const idsKey = JSON.stringify([...new Set(resourceIds.filter(resourceId => resourceId.length > 0))]);
+ const hasResourceIds = idsKey !== '[]';
+ const requestKey = `${resourceType}:${idsKey}`;
+ const requestedIds = useMemo(() => parseResourceIds(idsKey), [idsKey]);
+ const requestedIdSet = useMemo(() => new Set(requestedIds), [requestedIds]);
+ const [state, setState] = useState<PermissionsLoadState>({
+ server: null,
+ resourceType: null,
+ key: '',
+ data: {},
+ loading: false,
+ error: null,
+ });
+
+ useEffect(() => {
+ if (server == null || !hasResourceIds) return;
+
+ let cancelled = false;
+ setState(current =>
+ current.server === server && current.resourceType === resourceType
+ ? { ...current, key: requestKey, loading: true, error: null }
+ : { server, resourceType, key: requestKey, data: {}, loading: true, error: null },
+ );
+ void Promise.all(
+ permissionBatches(requestedIds).map(resourceIdsBatch =>
+ server.listPermissions({ resourceType, resourceIds: resourceIdsBatch }),
+ ),
+ ).then(
+ responses => {
+ if (cancelled) return;
+ setState({
+ server,
+ resourceType,
+ key: requestKey,
+ data: Object.assign({}, ...responses.map(response => response.data)),
+ loading: false,
+ error: null,
+ });
+ },
+ caught => {
+ if (cancelled) return;
+ setState(current => ({
+ server,
+ resourceType,
+ key: requestKey,
+ data: current.server === server && current.resourceType === resourceType ? current.data : {},
+ loading: false,
+ error: caught,
+ }));
+ },
+ );
+
+ return () => {
+ cancelled = true;
+ };
+ }, [hasResourceIds, requestKey, requestedIds, resourceType, server]);
+
+ const sameScope = state.server === server && state.resourceType === resourceType;
+ const loading = server != null && hasResourceIds && (!sameScope || state.key !== requestKey || state.loading);
+ const error = sameScope && state.key === requestKey ? state.error : null;
+
+ const allows = useCallback(
+ (resourceId: string | null | undefined, permission: ResourcePermission) => {
+ if (server == null || resourceId == null || resourceId === '') return true;
+ if (!requestedIdSet.has(resourceId) || !sameScope) return false;
+ return (state.data[resourceId] ?? []).includes(permission);
+ },
+ [requestedIdSet, sameScope, server, state.data],
+ );
+
+ return { loading, error, allows };
+}
+
+const ActiveSessionManageContext = createContext(true);
+
+export function ActiveSessionPermissionsProvider({
+ sessionId,
+ assumeManage = false,
+ children,
+}: {
+ sessionId: string | null | undefined;
+ assumeManage?: boolean;
+ children: ReactNode;
+}) {
+ const resourceIds = useMemo(() => (sessionId == null ? [] : [sessionId]), [sessionId]);
+ const { allows } = useResourcePermissions({ resourceType: 'session', resourceIds });
+ return createElement(
+ ActiveSessionManageContext.Provider,
+ { value: assumeManage || allows(sessionId, 'MANAGE') },
+ children,
+ );
+}
+
+export function useActiveSessionCanManage(): boolean {
+ return useContext(ActiveSessionManageContext);
+}
diff --git a/packages/trueforge-ui/src/index.ts b/packages/trueforge-ui/src/index.ts
index 62e8fa4d2..7cd219ec9 100644
--- a/packages/trueforge-ui/src/index.ts
+++ b/packages/trueforge-ui/src/index.ts
@@ -30,6 +30,8 @@ export type {
ThemePreset,
} from './theme/types.js';
+export { PermissionGuard } from './atoms/PermissionGuard.js';
+export type { PermissionGuardProps } from './atoms/PermissionGuard.js';
export { BottomSheet } from './atoms/primitives/BottomSheet.js';
export type { BottomSheetProps } from './atoms/primitives/BottomSheet.js';
export { Button } from './atoms/primitives/Button.js';
@@ -243,6 +245,8 @@ export { threadHasPendingMcpAuth, useComposerPauseView } from './hooks/useCompos
export type { ComposerPauseView, ThreadPauseState } from './hooks/useComposerPauseView.js';
export { MCP_AUTH_POPUP_CHANNEL, useMCPAuth } from './hooks/useMcpAuth.js';
export type { McpAuthCallback, McpAuthPopupMessage, UseMCPAuthOptions } from './hooks/useMcpAuth.js';
+export { useResourcePermissions } from './hooks/useResourcePermissions.js';
+export type { UseResourcePermissionsOptions, UseResourcePermissionsResult } from './hooks/useResourcePermissions.js';
// Curated chrome hooks (same instance as the SDK runtime). Deep primitives: install @assistant-ui/react.
export { useAui, useAuiState } from './assistant-ui.js';
@@ -297,6 +301,7 @@ export {
useOptionalAgentMetricsServer,
useOptionalAgentSessionsServer,
useOptionalCatalogServer,
+ useOptionalPermissionsServer,
useOptionalScheduleServer,
useOptionalServer,
useScheduleServer,
@@ -362,6 +367,8 @@ export type {
DefinedSkill,
GithubSkill,
ImportGithubSkillRequest,
+ ListPermissionsRequest,
+ ListPermissionsResponse,
ListResult,
ListSessionEventsParams,
ListSessionsOrder,
@@ -378,10 +385,13 @@ export type {
ModelSelection,
ModelSelectorEntry,
PageParams,
+ PermissionResourceType,
+ PermissionsServer,
PreviousTurnIdInput,
ProviderEntry,
ProviderType,
RegistrySkill,
+ ResourcePermission,
SandboxCatalogServer,
SandboxProviderBase,
SandboxProviderCatalogEntry,
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts
index 6dfa11ee2..fb8cdbd47 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/index.ts
@@ -2,7 +2,7 @@
* Built-in Harness → AgentUIServer factory for `<TrueForgeUI server={{ type: "trueforge", … }} />`.
*/
import { createTrueFoundryServer } from '../../server/createTrueFoundryServer.js';
-import type { CatalogServer } from '../../server/types.js';
+import type { CatalogServer, PermissionsServer } from '../../server/types.js';
import { createHarnessAgentMetricsServer } from './agentMetricsServer.js';
import { createHarnessAgentSessionsServer } from './agentSessionsServer.js';
import { createHarnessBuilderServer } from './builderServer.js';
@@ -12,6 +12,7 @@ import { createSandboxProviderCatalog } from './catalogs/sandboxProviderCatalog.
import { createSkillCatalog } from './catalogs/skillCatalog.js';
import { createHarnessChatServer } from './chatServer.js';
import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
+import { createHarnessPermissionsServer } from './permissionsServer.js';
import { createScheduleServer } from './schedules/scheduleServer.js';
import type { HarnessAgentSpec } from './types.js';
@@ -57,19 +58,22 @@ export {
export { createTrueForgeClient } from './client.js';
export type { CreateTrueForgeClientOptions } from './client.js';
export { getCapabilities, listConfiguredMcpServers, listModels, listSkills } from './lists.js';
+export { createHarnessPermissionsServer, type CreateHarnessPermissionsServerOptions } from './permissionsServer.js';
export { createScheduleServer } from './schedules/scheduleServer.js';
export type { HarnessAgentSpec, HarnessMcpServerMount, HarnessSkillMount } from './types.js';
export type CreateTrueForgeAgentUIServerOptions = CreateTrueForgeClientOptions & {
/** Override the default Harness settings catalogs. */
catalog?: CatalogServer;
+ /** Optional host-provided resource permissions port. */
+ permissions?: PermissionsServer;
};
/**
* Compose chat + builder + agent sessions + default settings catalogs into an `AgentUIServer`.
*/
export function createTrueForgeAgentUIServer(options: CreateTrueForgeAgentUIServerOptions = {}) {
- const { catalog: catalogOverride, ...clientOptions } = options;
+ const { catalog: catalogOverride, permissions, ...clientOptions } = options;
const client = createTrueForgeClient(clientOptions);
const catalog =
catalogOverride ??
@@ -87,5 +91,6 @@ export function createTrueForgeAgentUIServer(options: CreateTrueForgeAgentUIServ
sessions: createHarnessAgentSessionsServer({ ...clientOptions, client }),
metrics: createHarnessAgentMetricsServer({ ...clientOptions, client }),
schedules: createScheduleServer({ client }),
+ permissions: permissions ?? createHarnessPermissionsServer({ client }),
});
}
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/permissionsServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/permissionsServer.ts
new file mode 100644
index 000000000..92514f682
--- /dev/null
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/permissionsServer.ts
@@ -0,0 +1,15 @@
+import type { TrueForge } from '@truefoundry/trueforge-sdk';
+
+import type { PermissionsServer } from '../../server/types.js';
+import { createTrueForgeClient, type CreateTrueForgeClientOptions } from './client.js';
+
+export type CreateHarnessPermissionsServerOptions = CreateTrueForgeClientOptions & {
+ client?: TrueForge;
+};
+
+export function createHarnessPermissionsServer(options: CreateHarnessPermissionsServerOptions = {}): PermissionsServer {
+ const client = options.client ?? createTrueForgeClient(options);
+ return {
+ listPermissions: request => client.internal.listPermissions(request),
+ };
+}
diff --git a/packages/trueforge-ui/src/server/ServerContext.tsx b/packages/trueforge-ui/src/server/ServerContext.tsx
index eb0db4ceb..b8fa31974 100644
--- a/packages/trueforge-ui/src/server/ServerContext.tsx
+++ b/packages/trueforge-ui/src/server/ServerContext.tsx
@@ -8,6 +8,7 @@ import type {
AgentSessionsServer,
AgentUIServer,
CatalogServer,
+ PermissionsServer,
ScheduleServer,
} from './types.js';
@@ -133,3 +134,7 @@ export function useScheduleServer(): ScheduleServer {
export function useOptionalScheduleServer(): ScheduleServer | null {
return useOptionalServer()?.schedules ?? null;
}
+
+export function useOptionalPermissionsServer(): PermissionsServer | null {
+ return useOptionalServer()?.permissions ?? null;
+}
diff --git a/packages/trueforge-ui/src/server/TrueForgeServerConfig.ts b/packages/trueforge-ui/src/server/TrueForgeServerConfig.ts
index 6adc73c6b..1e12a587d 100644
--- a/packages/trueforge-ui/src/server/TrueForgeServerConfig.ts
+++ b/packages/trueforge-ui/src/server/TrueForgeServerConfig.ts
@@ -1,8 +1,8 @@
-import type { AgentUIServer, CatalogServer } from './types.js';
+import type { AgentUIServer, CatalogServer, PermissionsServer } from './types.js';
/**
* Built-in backends init inside `<TrueForgeUI />`.
- * Optional `catalog` is attached onto the resolved `AgentUIServer`.
+ * Optional host ports are attached onto the resolved `AgentUIServer`.
*/
export type TrueForgeBuiltInServerConfig =
| {
@@ -11,6 +11,7 @@ export type TrueForgeBuiltInServerConfig =
controlPlaneURL: string;
gatewayPlaneURL?: string;
catalog?: CatalogServer;
+ permissions?: PermissionsServer;
}
| {
type: 'trueforge';
@@ -21,6 +22,7 @@ export type TrueForgeBuiltInServerConfig =
/** Custom fetch (cookie sessions, auth interceptors). */
fetch?: typeof fetch;
catalog?: CatalogServer;
+ permissions?: PermissionsServer;
};
/**
diff --git a/packages/trueforge-ui/src/server/createTrueFoundryServer.ts b/packages/trueforge-ui/src/server/createTrueFoundryServer.ts
index 78fddcab9..57ed55751 100644
--- a/packages/trueforge-ui/src/server/createTrueFoundryServer.ts
+++ b/packages/trueforge-ui/src/server/createTrueFoundryServer.ts
@@ -10,6 +10,7 @@ import type {
CatalogServer,
ConnectorState,
ModelSelection,
+ PermissionsServer,
SaveAgentRequest,
SaveAgentResult,
ScheduleServer,
@@ -28,6 +29,7 @@ export type CreateTrueFoundryServerOptions<
TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,
TMetrics extends AgentMetricsServer = AgentMetricsServer,
TSchedules extends ScheduleServer = ScheduleServer,
+ TPermissions extends PermissionsServer = PermissionsServer,
> = {
/** Chat port — e.g. from `@truefoundry/agent-server-adapter`. */
chatServer: AgentChatServer<TSpec>;
@@ -48,6 +50,8 @@ export type CreateTrueFoundryServerOptions<
metrics?: TMetrics;
/** Schedules listing + CRUD. Optional. */
schedules?: TSchedules;
+ /** Per-resource grants. Omit to leave actions enabled. */
+ permissions?: TPermissions;
};
export type TrueFoundryServer<
@@ -62,12 +66,14 @@ export type TrueFoundryServer<
TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,
TMetrics extends AgentMetricsServer = AgentMetricsServer,
TSchedules extends ScheduleServer = ScheduleServer,
+ TPermissions extends PermissionsServer = PermissionsServer,
> = AgentChatServer<TSpec> &
AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> & {
catalog?: TCatalog;
sessions?: TSessions;
metrics?: TMetrics;
schedules?: TSchedules;
+ permissions?: TPermissions;
};
/**
@@ -87,6 +93,7 @@ export function createTrueFoundryServer<
TSessions extends AgentSessionsServer<TSpec> = AgentSessionsServer<TSpec>,
TMetrics extends AgentMetricsServer = AgentMetricsServer,
TSchedules extends ScheduleServer = ScheduleServer,
+ TPermissions extends PermissionsServer = PermissionsServer,
>(
opts: CreateTrueFoundryServerOptions<
TSpec,
@@ -99,7 +106,8 @@ export function createTrueFoundryServer<
TCapabilities,
TSessions,
TMetrics,
- TSchedules
+ TSchedules,
+ TPermissions
>,
): TrueFoundryServer<
TSpec,
@@ -112,7 +120,8 @@ export function createTrueFoundryServer<
TCapabilities,
TSessions,
TMetrics,
- TSchedules
+ TSchedules,
+ TPermissions
> {
const builder: AgentBuilderServer<TSpec, TModel, TSkill, TMcp, TAgent, TSave, TCapabilities> = {
getCapabilities: opts.getCapabilities,
@@ -143,7 +152,8 @@ export function createTrueFoundryServer<
TCapabilities,
TSessions,
TMetrics,
- TSchedules
+ TSchedules,
+ TPermissions
> = {
...opts.chatServer,
...builder,
@@ -151,6 +161,7 @@ export function createTrueFoundryServer<
...(opts.sessions != null ? { sessions: opts.sessions } : {}),
...(opts.metrics != null ? { metrics: opts.metrics } : {}),
...(opts.schedules != null ? { schedules: opts.schedules } : {}),
+ ...(opts.permissions != null ? { permissions: opts.permissions } : {}),
};
return server;
}
diff --git a/packages/trueforge-ui/src/server/types.ts b/packages/trueforge-ui/src/server/types.ts
index 008947c2b..bd0dc00bb 100644
--- a/packages/trueforge-ui/src/server/types.ts
+++ b/packages/trueforge-ui/src/server/types.ts
@@ -62,6 +62,8 @@ export type {
DefinedSkill,
GithubSkill,
ImportGithubSkillRequest,
+ ListPermissionsRequest,
+ ListPermissionsResponse,
ListResult,
ListSchedulesParams,
ListSessionEventsParams,
@@ -80,10 +82,13 @@ export type {
ModelSelection,
ModelSelectorEntry,
PageParams,
+ PermissionResourceType,
+ PermissionsServer,
PreviousTurnIdInput,
ProviderEntry,
ProviderType,
RegistrySkill,
+ ResourcePermission,
SandboxCatalogServer,
SandboxProviderBase,
SandboxProviderCatalogEntry,
diff --git a/packages/trueforge-ui/src/theme/defaultSlots.ts b/packages/trueforge-ui/src/theme/defaultSlots.ts
index 4a0b28fd7..8f6b77dc9 100644
--- a/packages/trueforge-ui/src/theme/defaultSlots.ts
+++ b/packages/trueforge-ui/src/theme/defaultSlots.ts
@@ -70,6 +70,7 @@ import { MessageIndicator } from '../atoms/MessageIndicator.js';
import { MessageTimestamp } from '../atoms/MessageTimestamp.js';
import { MonacoEditorCore } from '../atoms/MonacoEditorCore.js';
import { OpenUiFenceBlock } from '../atoms/OpenUiFenceBlock.js';
+import { PermissionGuard } from '../atoms/PermissionGuard.js';
import { SandboxArtifactDownload } from '../atoms/SandboxArtifactDownload.js';
import { SandboxToolCallCard } from '../atoms/SandboxToolCallCard.js';
import { SaveAgentButton } from '../atoms/SaveAgentButton.js';
@@ -148,6 +149,7 @@ export const defaultSlots = {
ComposerLeftSection,
ComposerRightSection,
ComposerSendButton,
+ PermissionGuard,
DraftComposerLeftSection,
DraftComposerRightSection,
DraftAgentConfigTrigger,
diff --git a/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx b/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx
index 96bfbcdb6..05a4edc79 100644
--- a/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx
+++ b/packages/trueforge-ui/test/atoms/AgentDetailsPage.test.tsx
@@ -6,11 +6,12 @@ import { afterEach, beforeAll, describe, expect, it, vi } from 'vitest';
import { AgentDetailsPage } from '@/atoms/agent-details/AgentDetailsPage.js';
import { AgentSessions } from '@/atoms/agent-details/AgentSessions.js';
import { ServerProvider } from '@/server/ServerContext.js';
-import { ShellModeProvider } from '@/server/ShellModeContext.js';
+import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
import type {
AgentDetail,
AgentMetricsServer,
CodeSnippet,
+ ListPermissionsResponse,
ScheduleServer,
Session,
SessionEventItem,
@@ -60,6 +61,17 @@ const sessionRows: SessionListEntry[] = [
},
];
+function ShellModeProbe() {
+ const shell = useShellMode();
+ return (
+ <output data-testid="shell-mode">
+ {shell.mode.status === 'active'
+ ? `${shell.mode.agentId ?? ''}:${String(shell.mode.isMutable)}`
+ : shell.mode.status}
+ </output>
+ );
+}
+
function deferred<T>() {
let settle: ((value: T) => void) | undefined;
return {
@@ -116,6 +128,7 @@ function renderPage({
<ServerProvider server={server}>
<ShellModeProvider>
<AgentDetailsPage agentId="agent-1" />
+ <ShellModeProbe />
</ShellModeProvider>
</ServerProvider>
</SlotsProvider>
@@ -159,6 +172,23 @@ describe('AgentDetailsPage', () => {
});
});
+ it('allows Try with USE while keeping Edit disabled without MANAGE', async () => {
+ renderPage({
+ serverOverrides: {
+ permissions: {
+ listPermissions: vi.fn(async (): Promise<ListPermissionsResponse> => ({ data: { 'agent-1': ['USE'] } })),
+ },
+ },
+ });
+
+ await waitFor(() => expect(screen.getByRole('button', { name: 'Try agent' })).toBeEnabled());
+ fireEvent.click(screen.getByRole('button', { name: 'Try agent' }));
+ expect(screen.getByTestId('shell-mode')).toHaveTextContent('agent-1:false');
+
+ fireEvent.click(screen.getByRole('button', { name: 'Actions for release-notes-writer' }));
+ expect(screen.getByRole('menuitem', { name: 'Edit' })).toBeDisabled();
+ });
+
it('renders tab bodies through SlotProvider overrides', async () => {
renderPage({ overrides: { AgentOverview: () => <div>Custom overview</div> } });
expect(await screen.findByText('Custom overview')).toBeInTheDocument();
diff --git a/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx b/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx
index a37191794..e63c05bd2 100644
--- a/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx
+++ b/packages/trueforge-ui/test/atoms/AgentsLibrary.test.tsx
@@ -8,9 +8,13 @@ import { AgentsLibraryButton } from '@/atoms/AgentsLibraryButton.js';
import { CenteredModal } from '@/atoms/primitives/CenteredModal.js';
import { ServerProvider } from '@/server/ServerContext.js';
import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
-import type { AgentUIServer } from '@/server/types.js';
+import type { AgentUIServer, ListPermissionsResponse } from '@/server/types.js';
import { SlotsProvider } from '@/theme/SlotsProvider.js';
-import { createMockAgentUIServer } from '../server/mockServer.js';
+import {
+ createMockAgentSessionsServer,
+ createMockAgentUIServer,
+ createMockScheduleServer,
+} from '../server/mockServer.js';
beforeAll(() => {
// jsdom does not implement HTMLDialogElement showModal/close.
@@ -189,6 +193,41 @@ describe('AgentsLibrary', () => {
expect(screen.getByRole('button', { name: 'Try agent try-only' })).toBeInTheDocument();
});
+ it('keeps Try and Clone available with USE while disabling Edit and Delete', async () => {
+ const server = createMockAgentUIServer({
+ searchAgents: vi.fn(async () => [
+ {
+ name: 'shared-agent',
+ agentId: 'shared-id',
+ agentSpec: { model: { name: 'openai/gpt-5' } },
+ },
+ ]),
+ permissions: {
+ listPermissions: vi.fn(async (): Promise<ListPermissionsResponse> => ({ data: { 'shared-id': ['USE'] } })),
+ },
+ sessions: createMockAgentSessionsServer(),
+ schedules: createMockScheduleServer(),
+ });
+
+ renderLibrary(<LibraryHarness />, { server });
+ fireEvent.click(screen.getByRole('button', { name: 'Open library' }));
+
+ await waitFor(() => {
+ expect(screen.getByRole('button', { name: 'Try agent shared-agent' })).toBeEnabled();
+ });
+ fireEvent.click(screen.getByRole('button', { name: 'Actions for shared-agent' }));
+ await waitFor(() => {
+ expect(screen.getByRole('menuitem', { name: 'Edit' })).toBeDisabled();
+ expect(screen.getByRole('menuitem', { name: 'Manage Schedules' })).toBeEnabled();
+ expect(screen.getByRole('menuitem', { name: 'Delete' })).toBeDisabled();
+ });
+ expect(screen.getByRole('menuitem', { name: 'Clone' })).toBeEnabled();
+ fireEvent.click(screen.getByRole('button', { name: 'Actions for shared-agent' }));
+ await waitFor(() => {
+ expect(screen.getByRole('button', { name: 'Add schedule for shared-agent' })).toBeEnabled();
+ });
+ });
+
it('clones an agent after confirm and stays on the library', async () => {
const saveAgent = vi.fn(async () => ({ agentId: 'writer-copy-id' }));
const server = createMockAgentUIServer({
diff --git a/packages/trueforge-ui/test/atoms/PermissionGuard.test.tsx b/packages/trueforge-ui/test/atoms/PermissionGuard.test.tsx
new file mode 100644
index 000000000..7306d814b
--- /dev/null
+++ b/packages/trueforge-ui/test/atoms/PermissionGuard.test.tsx
@@ -0,0 +1,32 @@
+// @vitest-environment jsdom
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+
+import { PermissionGuard } from '@/atoms/PermissionGuard.js';
+
+describe('PermissionGuard', () => {
+ it('preserves allowed controls and explains denied controls', () => {
+ const onClick = vi.fn();
+ const { rerender } = render(
+ <PermissionGuard allowed>
+ <button type="button" onClick={onClick}>
+ Update
+ </button>
+ </PermissionGuard>,
+ );
+ fireEvent.click(screen.getByRole('button', { name: 'Update' }));
+ expect(onClick).toHaveBeenCalledOnce();
+
+ rerender(
+ <PermissionGuard allowed={false} deniedMessage="Missing MANAGE permission">
+ <button type="button" onClick={onClick}>
+ Update
+ </button>
+ </PermissionGuard>,
+ );
+ const button = screen.getByRole('button', { name: 'Update' });
+ expect(button).toBeDisabled();
+ fireEvent.mouseEnter(button.parentElement ?? button);
+ expect(screen.getByRole('tooltip')).toHaveTextContent('Missing MANAGE permission');
+ });
+});
diff --git a/packages/trueforge-ui/test/atoms/schedules/ScheduleFormDrawer.test.tsx b/packages/trueforge-ui/test/atoms/schedules/ScheduleFormDrawer.test.tsx
index be047fa79..27480e681 100644
--- a/packages/trueforge-ui/test/atoms/schedules/ScheduleFormDrawer.test.tsx
+++ b/packages/trueforge-ui/test/atoms/schedules/ScheduleFormDrawer.test.tsx
@@ -7,7 +7,7 @@ import { ScheduleFormDrawer } from '@/atoms/schedules/ScheduleFormDrawer.js';
import { ToasterProvider } from '@/containers/ToasterContainer.js';
import { ServerProvider } from '@/server/ServerContext.js';
import { ShellModeProvider, useShellMode } from '@/server/ShellModeContext.js';
-import type { AgentUIServer, ConnectorBase, Schedule, ScheduleServer } from '@/server/types.js';
+import type { AgentUIServer, ConnectorBase, PermissionsServer, Schedule, ScheduleServer } from '@/server/types.js';
import { SlotsProvider } from '@/theme/SlotsProvider.js';
import { createMockAgentUIServer, createMockCatalog } from '../../server/mockServer.js';
@@ -83,11 +83,13 @@ function AgentBuilderProbe() {
function renderDrawer({
server,
scheduleServer,
+ permissions,
withShell = false,
...props
}: Partial<ComponentProps<typeof ScheduleFormDrawer>> & {
server?: AgentUIServer;
scheduleServer?: ScheduleServer;
+ permissions?: PermissionsServer;
withShell?: boolean;
}) {
const agentServer =
@@ -124,7 +126,7 @@ function renderDrawer({
...render(
<SlotsProvider>
<ToasterProvider>
- <ServerProvider server={{ ...agentServer, schedules }}>
+ <ServerProvider server={{ ...agentServer, schedules, ...(permissions == null ? {} : { permissions }) }}>
{withShell ? (
<ShellModeProvider>
{drawer}
@@ -211,6 +213,26 @@ describe('ScheduleFormDrawer', () => {
expect(screen.queryByLabelText('Cron expression')).not.toBeInTheDocument();
});
+ it('blocks create when the selected agent lacks USE', async () => {
+ const createSchedule = vi.fn(async () => pausedSchedule());
+ renderDrawer({
+ scheduleServer: mockScheduleServer({ createSchedule }),
+ permissions: {
+ listPermissions: vi.fn(async () => ({ data: { 'demo-agent': [] } })),
+ },
+ initialAgentId: 'demo-agent',
+ });
+
+ fireEvent.change(await screen.findByLabelText('Name'), { target: { value: 'digest' } });
+ fireEvent.change(screen.getByLabelText('Task'), { target: { value: 'summarize' } });
+ await waitFor(() => expect(screen.getByRole('button', { name: 'Save' })).toBeDisabled());
+ const form = screen.getByLabelText('Name').closest('form');
+ if (form == null) throw new Error('Expected schedule form');
+ fireEvent.submit(form);
+
+ expect(createSchedule).not.toHaveBeenCalled();
+ });
+
it('creates a paused schedule, stays open on the test screen, and toasts', async () => {
const createSchedule = vi.fn(async () => pausedSchedule());
const onOpenChange = vi.fn();
diff --git a/packages/trueforge-ui/test/atoms/schedules/SchedulesPage.test.tsx b/packages/trueforge-ui/test/atoms/schedules/SchedulesPage.test.tsx
index b42335997..d83a8a28d 100644
--- a/packages/trueforge-ui/test/atoms/schedules/SchedulesPage.test.tsx
+++ b/packages/trueforge-ui/test/atoms/schedules/SchedulesPage.test.tsx
@@ -5,7 +5,14 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { SchedulesPage } from '@/atoms/schedules/SchedulesPage.js';
import { ToasterProvider } from '@/containers/ToasterContainer.js';
import { ServerProvider } from '@/server/ServerContext.js';
-import type { AgentUIServer, Schedule, ScheduleRun, ScheduleServer } from '@/server/types.js';
+import type {
+ AgentUIServer,
+ ListPermissionsResponse,
+ PermissionsServer,
+ Schedule,
+ ScheduleRun,
+ ScheduleServer,
+} from '@/server/types.js';
import { createMockAgentUIServer } from '../../server/mockServer.js';
const sampleSchedules: Schedule[] = [
@@ -61,7 +68,7 @@ function renderPage(
overrides: Partial<ScheduleServer> = {},
listImpl?: ScheduleServer['listSchedules'],
searchAgents?: AgentUIServer['searchAgents'],
- options: { agentId?: string } = {},
+ options: { agentId?: string; permissions?: PermissionsServer } = {},
) {
const scheduleServer: ScheduleServer = {
listSchedules: vi.fn(
@@ -81,11 +88,12 @@ function renderPage(
const server = createMockAgentUIServer({
searchAgents: searchAgents ?? vi.fn(async () => [{ name: 'demo-agent', agentId: 'demo-agent' }]),
schedules: scheduleServer,
+ ...(options.permissions == null ? {} : { permissions: options.permissions }),
});
render(
<ServerProvider server={server}>
<ToasterProvider>
- <SchedulesPage {...options} />
+ <SchedulesPage {...(options.agentId == null ? {} : { agentId: options.agentId })} />
</ToasterProvider>
</ServerProvider>,
);
@@ -105,6 +113,57 @@ describe('SchedulesPage', () => {
expect(scheduleServer.listSchedules).toHaveBeenCalledWith(expect.objectContaining({ limit: 10 }));
});
+ it('disables schedule mutations without MANAGE or DELETE', async () => {
+ const { scheduleServer } = renderPage(sampleSchedules, {}, undefined, undefined, {
+ agentId: 'demo-agent',
+ permissions: {
+ listPermissions: vi.fn(async () => ({ data: { s1: [] } })),
+ },
+ });
+
+ expect(await screen.findByRole('button', { name: 'Create Schedule' })).toBeDisabled();
+ expect(await screen.findByRole('button', { name: 'Run now daily-digest' })).toBeDisabled();
+ fireEvent.click(screen.getByRole('button', { name: 'Actions for daily-digest' }));
+ await waitFor(() => {
+ expect(screen.getByRole('menuitem', { name: 'Edit' })).toBeDisabled();
+ expect(screen.getByRole('menuitem', { name: 'Pause' })).toBeDisabled();
+ expect(screen.getByRole('menuitem', { name: 'Delete' })).toBeDisabled();
+ });
+ expect(scheduleServer.updateSchedule).not.toHaveBeenCalled();
+ expect(scheduleServer.deleteSchedule).not.toHaveBeenCalled();
+ });
+
+ it('allows schedule creation with agent USE permission', async () => {
+ renderPage(sampleSchedules, {}, undefined, undefined, {
+ agentId: 'demo-agent',
+ permissions: {
+ listPermissions: vi.fn(async ({ resourceType }): Promise<ListPermissionsResponse> => ({
+ data: resourceType === 'agent' ? { 'demo-agent': ['USE'] } : { s1: [] },
+ })),
+ },
+ });
+
+ await waitFor(() => {
+ expect(screen.getByRole('button', { name: 'Create Schedule' })).toBeEnabled();
+ });
+ expect(screen.getByRole('button', { name: 'Run now daily-digest' })).toBeDisabled();
+ });
+
+ it('disables global schedule creation when no listed agent has USE', async () => {
+ const listPermissions = vi.fn(async () => ({ data: { 'demo-agent': [] } }));
+ renderPage(sampleSchedules, {}, undefined, undefined, {
+ permissions: { listPermissions },
+ });
+
+ await waitFor(() => {
+ expect(listPermissions).toHaveBeenCalledWith({
+ resourceType: 'agent',
+ resourceIds: ['demo-agent'],
+ });
+ });
+ expect(screen.getByRole('button', { name: 'Create Schedule' })).toBeDisabled();
+ });
+
it('locks embedded schedules to the supplied agent', async () => {
const { scheduleServer } = renderPage(sampleSchedules, {}, undefined, undefined, { agentId: 'demo-agent' });
diff --git a/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx b/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx
index a8154f4c4..df52353df 100644
--- a/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx
+++ b/packages/trueforge-ui/test/containers/ThreadListContainer.pagination.test.tsx
@@ -81,6 +81,7 @@ vi.mock('@assistant-ui/react', () => ({
vi.mock('@/server/ServerContext.js', () => ({
useOptionalServer: () => undefined,
useOptionalAgentSessionsServer: () => null,
+ useOptionalPermissionsServer: () => null,
useOptionalScheduleServer: () => null,
}));
diff --git a/packages/trueforge-ui/test/containers/TrueFoundryChatProvider.test.tsx b/packages/trueforge-ui/test/containers/TrueFoundryChatProvider.test.tsx
index 1b419d467..81ba5803e 100644
--- a/packages/trueforge-ui/test/containers/TrueFoundryChatProvider.test.tsx
+++ b/packages/trueforge-ui/test/containers/TrueFoundryChatProvider.test.tsx
@@ -101,6 +101,30 @@ describe('TrueFoundryChatProvider', () => {
expect(result.nextPageToken).toBe('next-page');
});
+ it('wraps session creation used for local ownership tracking', async () => {
+ const createSession = vi.fn(async () => ({
+ id: 'new-session',
+ isMutable: false,
+ createdAt: '2026-09-10T00:00:00.000Z',
+ updatedAt: '2026-09-10T00:00:00.000Z',
+ }));
+ render(
+ <TrueFoundryChatProvider server={createMockAgentUIServer({ createSession })} agentName="my-agent">
+ <div>chat-child</div>
+ </TrueFoundryChatProvider>,
+ );
+ const runtimeServer = runtimeSpy.mock.calls[0]?.[0]?.server;
+ if (runtimeServer === undefined) throw new Error('Expected runtime server');
+
+ await expect(runtimeServer.createSession({ agentName: 'my-agent' })).resolves.toEqual({
+ id: 'new-session',
+ isMutable: false,
+ createdAt: '2026-09-10T00:00:00.000Z',
+ updatedAt: '2026-09-10T00:00:00.000Z',
+ });
+ expect(createSession).toHaveBeenCalledWith({ agentName: 'my-agent' });
+ });
+
it('forwards a discriminated agent configuration', () => {
const agent: TrueFoundryAgentConfig = {
mode: 'named',
diff --git a/packages/trueforge-ui/test/containers/useResolvedServer.test.tsx b/packages/trueforge-ui/test/containers/useResolvedServer.test.tsx
index 15bb67751..40d41c11c 100644
--- a/packages/trueforge-ui/test/containers/useResolvedServer.test.tsx
+++ b/packages/trueforge-ui/test/containers/useResolvedServer.test.tsx
@@ -3,9 +3,17 @@ import { renderHook, waitFor } from '@testing-library/react';
import { describe, expect, it, vi } from 'vitest';
import { useResolvedServer } from '@/containers/useResolvedServer.js';
+import type { PermissionsServer } from '@/server/types.js';
import { createMockAgentUIServer, createMockCatalog } from '../server/mockServer.js';
-const mockCreateTrueForgeAgentUIServer = vi.fn((_options?: unknown) =>
+const permissions: PermissionsServer = {
+ listPermissions: vi.fn(async () => ({ data: {} })),
+};
+const defaultHarnessPermissions: PermissionsServer = {
+ listPermissions: vi.fn(async () => ({ data: {} })),
+};
+
+const mockCreateTrueForgeAgentUIServer = vi.fn((options?: { permissions?: PermissionsServer }) =>
Promise.resolve(
createMockAgentUIServer({
getCapabilities: async () => ({
@@ -15,6 +23,7 @@ const mockCreateTrueForgeAgentUIServer = vi.fn((_options?: unknown) =>
settings: { enabled: true },
},
}),
+ permissions: options?.permissions ?? defaultHarnessPermissions,
}),
),
);
@@ -39,7 +48,8 @@ vi.mock('@truefoundry/assistant-ui-runtime/plugins/truefoundry-agent-server-adap
}));
vi.mock('@/plugins/trueforge-agent-server-adapter/index.js', () => ({
- createTrueForgeAgentUIServer: (options?: unknown) => mockCreateTrueForgeAgentUIServer(options),
+ createTrueForgeAgentUIServer: (options?: Parameters<typeof mockCreateTrueForgeAgentUIServer>[0]) =>
+ mockCreateTrueForgeAgentUIServer(options),
}));
describe('useResolvedServer', () => {
@@ -73,9 +83,30 @@ describe('useResolvedServer', () => {
token: 'tok',
fetch: fetchImpl,
});
+ expect(result.current.server?.permissions).toBe(defaultHarnessPermissions);
expect(result.current.server?.getCapabilities).toEqual(expect.any(Function));
});
+ it('passes an explicit permissions port to the trueforge server', async () => {
+ mockCreateTrueForgeAgentUIServer.mockClear();
+ const { result } = renderHook(() =>
+ useResolvedServer({
+ type: 'trueforge',
+ token: 'tok',
+ permissions,
+ }),
+ );
+
+ await waitFor(() => {
+ expect(result.current.status).toBe('ready');
+ });
+ expect(mockCreateTrueForgeAgentUIServer).toHaveBeenCalledWith({
+ token: 'tok',
+ permissions,
+ });
+ expect(result.current.server?.permissions).toBe(permissions);
+ });
+
it('attaches an optional catalog onto the trueforge server when factory returns one', async () => {
const catalog = createMockCatalog();
mockCreateTrueForgeAgentUIServer.mockImplementationOnce(async () =>
@@ -128,6 +159,7 @@ describe('useResolvedServer', () => {
cpURL: 'https://cp.example',
gatewayURL: 'https://gw.example',
});
+ expect(result.current.server?.permissions).toBeUndefined();
expect(result.current.server?.getCapabilities).toEqual(expect.any(Function));
await expect(result.current.server?.getCapabilities()).resolves.toEqual({
data: {
@@ -138,6 +170,22 @@ describe('useResolvedServer', () => {
});
});
+ it('attaches an explicit permissions port onto the truefoundry server', async () => {
+ const { result } = renderHook(() =>
+ useResolvedServer({
+ type: 'truefoundry',
+ apiKey: 'k',
+ controlPlaneURL: 'https://cp.example',
+ permissions,
+ }),
+ );
+
+ await waitFor(() => {
+ expect(result.current.status).toBe('ready');
+ });
+ expect(result.current.server?.permissions).toBe(permissions);
+ });
+
it('attaches an optional catalog onto the truefoundry server', async () => {
const catalog = createMockCatalog();
const { result } = renderHook(() =>
diff --git a/packages/trueforge-ui/test/hooks/useResourcePermissions.test.tsx b/packages/trueforge-ui/test/hooks/useResourcePermissions.test.tsx
new file mode 100644
index 000000000..baffb8912
--- /dev/null
+++ b/packages/trueforge-ui/test/hooks/useResourcePermissions.test.tsx
@@ -0,0 +1,143 @@
+// @vitest-environment jsdom
+import { act, renderHook, waitFor } from '@testing-library/react';
+import type { ReactNode } from 'react';
+import { describe, expect, it, vi } from 'vitest';
+
+import {
+ ActiveSessionPermissionsProvider,
+ useActiveSessionCanManage,
+ useResourcePermissions,
+} from '@/hooks/useResourcePermissions.js';
+import { ServerProvider } from '@/server/ServerContext.js';
+import type { ListPermissionsResponse, ResourcePermission } from '@/server/types.js';
+import { createMockAgentUIServer } from '../server/mockServer.js';
+
+describe('useResourcePermissions', () => {
+ it('allows without a permissions port', () => {
+ const { result } = renderHook(() => useResourcePermissions({ resourceType: 'agent', resourceIds: ['agent-1'] }));
+
+ expect(result.current.loading).toBe(false);
+ expect(result.current.allows('agent-1', 'MANAGE')).toBe(true);
+ });
+
+ it('fails closed until grants load and denies missing ids', async () => {
+ let resolvePermissions: ((value: { data: Record<string, ResourcePermission[]> }) => void) | undefined;
+ const listPermissions = vi.fn(
+ () =>
+ new Promise<{ data: Record<string, ResourcePermission[]> }>(resolve => {
+ resolvePermissions = resolve;
+ }),
+ );
+ const server = createMockAgentUIServer({ permissions: { listPermissions } });
+ const wrapper = ({ children }: { children: ReactNode }) => (
+ <ServerProvider server={server}>{children}</ServerProvider>
+ );
+ const { result } = renderHook(
+ () => useResourcePermissions({ resourceType: 'agent', resourceIds: ['agent-1', 'missing'] }),
+ { wrapper },
+ );
+
+ expect(result.current.allows('agent-1', 'MANAGE')).toBe(false);
+ await act(async () => {
+ resolvePermissions?.({ data: { 'agent-1': ['USE', 'MANAGE'] } });
+ });
+ await waitFor(() => expect(result.current.loading).toBe(false));
+ expect(result.current.allows('agent-1', 'USE')).toBe(true);
+ expect(result.current.allows('agent-1', 'MANAGE')).toBe(true);
+ expect(result.current.allows('agent-1', 'DELETE')).toBe(false);
+ expect(result.current.allows('missing', 'MANAGE')).toBe(false);
+ });
+
+ it('chunks requests at 100 ids and fails closed on errors', async () => {
+ const listPermissions = vi.fn(async ({ resourceIds }: { resourceIds: string[] }) => ({
+ data: Object.fromEntries(resourceIds.map(resourceId => [resourceId, ['DELETE' as const]])),
+ }));
+ const server = createMockAgentUIServer({ permissions: { listPermissions } });
+ const wrapper = ({ children }: { children: ReactNode }) => (
+ <ServerProvider server={server}>{children}</ServerProvider>
+ );
+ const resourceIds = Array.from({ length: 101 }, (_, index) => `session-${String(index)}`);
+ const { result, rerender } = renderHook(
+ ({ ids }) => useResourcePermissions({ resourceType: 'session', resourceIds: ids }),
+ { initialProps: { ids: resourceIds }, wrapper },
+ );
+
+ await waitFor(() => expect(result.current.allows('session-100', 'DELETE')).toBe(true));
+ expect(listPermissions).toHaveBeenCalledTimes(2);
+
+ listPermissions.mockRejectedValueOnce(new Error('permission service unavailable'));
+ rerender({ ids: ['session-error'] });
+ await waitFor(() => expect(result.current.error).toEqual(new Error('permission service unavailable')));
+ expect(result.current.allows('session-error', 'DELETE')).toBe(false);
+ });
+
+ it('keeps known grants while an expanded request loads and fails', async () => {
+ let rejectExpanded: ((reason: unknown) => void) | undefined;
+ const knownResponse: { data: Record<string, ResourcePermission[]> } = {
+ data: { known: ['MANAGE'] },
+ };
+ const listPermissions = vi
+ .fn()
+ .mockResolvedValueOnce(knownResponse)
+ .mockImplementationOnce(
+ () =>
+ new Promise<{ data: Record<string, ResourcePermission[]> }>((_resolve, reject) => {
+ rejectExpanded = reject;
+ }),
+ );
+ const server = createMockAgentUIServer({ permissions: { listPermissions } });
+ const wrapper = ({ children }: { children: ReactNode }) => (
+ <ServerProvider server={server}>{children}</ServerProvider>
+ );
+ const { result, rerender } = renderHook(
+ ({ ids }) => useResourcePermissions({ resourceType: 'session', resourceIds: ids }),
+ { initialProps: { ids: ['known'] }, wrapper },
+ );
+
+ await waitFor(() => expect(result.current.allows('known', 'MANAGE')).toBe(true));
+ rerender({ ids: ['known', 'new'] });
+ expect(result.current.allows('known', 'MANAGE')).toBe(true);
+ expect(result.current.allows('new', 'MANAGE')).toBe(false);
+
+ await act(async () => {
+ rejectExpanded?.(new Error('permission service unavailable'));
+ });
+ await waitFor(() => expect(result.current.error).toEqual(new Error('permission service unavailable')));
+ expect(result.current.allows('known', 'MANAGE')).toBe(true);
+ expect(result.current.allows('new', 'MANAGE')).toBe(false);
+ });
+
+ it('keeps a locally created active session manageable while permissions load', () => {
+ const server = createMockAgentUIServer({
+ permissions: {
+ listPermissions: vi.fn(() => new Promise<ListPermissionsResponse>(() => undefined)),
+ },
+ });
+ const wrapper = ({ children }: { children: ReactNode }) => (
+ <ServerProvider server={server}>
+ <ActiveSessionPermissionsProvider sessionId="new-session" assumeManage>
+ {children}
+ </ActiveSessionPermissionsProvider>
+ </ServerProvider>
+ );
+ const { result } = renderHook(() => useActiveSessionCanManage(), { wrapper });
+
+ expect(result.current).toBe(true);
+ });
+
+ it('keeps a loaded active session read-only while permissions load', () => {
+ const server = createMockAgentUIServer({
+ permissions: {
+ listPermissions: vi.fn(() => new Promise<ListPermissionsResponse>(() => undefined)),
+ },
+ });
+ const wrapper = ({ children }: { children: ReactNode }) => (
+ <ServerProvider server={server}>
+ <ActiveSessionPermissionsProvider sessionId="loaded-session">{children}</ActiveSessionPermissionsProvider>
+ </ServerProvider>
+ );
+ const { result } = renderHook(() => useActiveSessionCanManage(), { wrapper });
+
+ expect(result.current).toBe(false);
+ });
+});
diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/permissionsServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/permissionsServer.test.ts
new file mode 100644
index 000000000..dfa78f4a3
--- /dev/null
+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/permissionsServer.test.ts
@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import { createTrueForgeAgentUIServer } from '@/plugins/trueforge-agent-server-adapter/index.js';
+import { createHarnessPermissionsServer } from '@/plugins/trueforge-agent-server-adapter/permissionsServer.js';
+import type { PermissionsServer } from '@/server/types.js';
+
+describe('createHarnessPermissionsServer', () => {
+ it('delegates list requests to the generated internal SDK client', async () => {
+ const fetchMock: typeof fetch = vi.fn(async (input, init) => {
+ expect(String(input)).toBe('https://trueforge.test/api/internal/list-permissions');
+ expect(init?.method).toBe('POST');
+ expect(init?.body).toBe(JSON.stringify({ resource_type: 'agent', resource_ids: ['agent-1'] }));
+ return Response.json({ data: { 'agent-1': ['USE'] } });
+ });
+ const server = createHarnessPermissionsServer({
+ baseUrl: 'https://trueforge.test',
+ token: 'test-token',
+ fetch: fetchMock,
+ });
+
+ await expect(server.listPermissions({ resourceType: 'agent', resourceIds: ['agent-1'] })).resolves.toEqual({
+ data: { 'agent-1': ['USE'] },
+ });
+ expect(fetchMock).toHaveBeenCalledOnce();
+ });
+});
+
+describe('createTrueForgeAgentUIServer permissions', () => {
+ it('enables Harness permissions by default', () => {
+ const server = createTrueForgeAgentUIServer({ fetch: vi.fn() });
+ expect(server.permissions?.listPermissions).toEqual(expect.any(Function));
+ });
+
+ it('preserves an explicit permissions port', () => {
+ const permissions: PermissionsServer = {
+ listPermissions: vi.fn(async () => ({ data: {} })),
+ };
+ const server = createTrueForgeAgentUIServer({ fetch: vi.fn(), permissions });
+ expect(server.permissions).toBe(permissions);
+ });
+});
diff --git a/packages/trueforge-ui/test/publicUiExports.test.ts b/packages/trueforge-ui/test/publicUiExports.test.ts
index fd104955e..b16eaa438 100644
--- a/packages/trueforge-ui/test/publicUiExports.test.ts
+++ b/packages/trueforge-ui/test/publicUiExports.test.ts
@@ -99,6 +99,7 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = [
'MonacoEditorCore',
'OpenUiFenceBlock',
'PRESETS',
+ 'PermissionGuard',
'PopoverSelect',
'PostMcpOauthScreen',
'ReasoningContainer',
@@ -198,9 +199,11 @@ const expectedRuntimeExports: Array<keyof typeof sdk> = [
'useOptionalCatalogServer',
'useOptionalContentClassNames',
'useOptionalCustomActionRenderers',
+ 'useOptionalPermissionsServer',
'useOptionalScheduleServer',
'useOptionalServer',
'useOptionalShellMode',
+ 'useResourcePermissions',
'useScheduleServer',
'useServer',
'useServerCapabilities',
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 9e72d4363..b3b7fa48b 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -363,8 +363,8 @@ importers:
specifier: ^0.13.2
'@truefoundry/assistant-ui-runtime':
- specifier: 0.1.34
+ specifier: 0.1.35
'@truefoundry/trueforge-sdk':
specifier: workspace:*
version: link:../trueforge-sdk
@@ -1071,12 +1071,6 @@ packages:
cpu: [ppc64]
os: [aix]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==}
- engines: {node: '>=18'}
- cpu: [ppc64]
- os: [aix]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==}
engines: {node: '>=18'}
@@ -1095,12 +1089,6 @@ packages:
cpu: [arm64]
os: [android]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [android]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==}
engines: {node: '>=18'}
@@ -1119,12 +1107,6 @@ packages:
cpu: [arm]
os: [android]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==}
- engines: {node: '>=18'}
- cpu: [arm]
- os: [android]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==}
engines: {node: '>=18'}
@@ -1143,12 +1125,6 @@ packages:
cpu: [x64]
os: [android]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [android]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==}
engines: {node: '>=18'}
@@ -1167,12 +1143,6 @@ packages:
cpu: [arm64]
os: [darwin]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [darwin]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==}
engines: {node: '>=18'}
@@ -1191,12 +1161,6 @@ packages:
cpu: [x64]
os: [darwin]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [darwin]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==}
engines: {node: '>=18'}
@@ -1215,12 +1179,6 @@ packages:
cpu: [arm64]
os: [freebsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [freebsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==}
engines: {node: '>=18'}
@@ -1239,12 +1197,6 @@ packages:
cpu: [x64]
os: [freebsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [freebsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==}
engines: {node: '>=18'}
@@ -1263,12 +1215,6 @@ packages:
cpu: [arm64]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==}
engines: {node: '>=18'}
@@ -1287,12 +1233,6 @@ packages:
cpu: [arm]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==}
- engines: {node: '>=18'}
- cpu: [arm]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==}
engines: {node: '>=18'}
@@ -1311,12 +1251,6 @@ packages:
cpu: [ia32]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==}
- engines: {node: '>=18'}
- cpu: [ia32]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==}
engines: {node: '>=18'}
@@ -1335,12 +1269,6 @@ packages:
cpu: [loong64]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==}
- engines: {node: '>=18'}
- cpu: [loong64]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==}
engines: {node: '>=18'}
@@ -1359,12 +1287,6 @@ packages:
cpu: [mips64el]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==}
- engines: {node: '>=18'}
- cpu: [mips64el]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==}
engines: {node: '>=18'}
@@ -1383,12 +1305,6 @@ packages:
cpu: [ppc64]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==}
- engines: {node: '>=18'}
- cpu: [ppc64]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==}
engines: {node: '>=18'}
@@ -1407,12 +1323,6 @@ packages:
cpu: [riscv64]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==}
- engines: {node: '>=18'}
- cpu: [riscv64]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==}
engines: {node: '>=18'}
@@ -1431,12 +1341,6 @@ packages:
cpu: [s390x]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==}
- engines: {node: '>=18'}
- cpu: [s390x]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==}
engines: {node: '>=18'}
@@ -1455,12 +1359,6 @@ packages:
cpu: [x64]
os: [linux]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [linux]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==}
engines: {node: '>=18'}
@@ -1479,12 +1377,6 @@ packages:
cpu: [arm64]
os: [netbsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [netbsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==}
engines: {node: '>=18'}
@@ -1503,12 +1395,6 @@ packages:
cpu: [x64]
os: [netbsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [netbsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==}
engines: {node: '>=18'}
@@ -1527,12 +1413,6 @@ packages:
cpu: [arm64]
os: [openbsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [openbsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==}
engines: {node: '>=18'}
@@ -1551,12 +1431,6 @@ packages:
cpu: [x64]
os: [openbsd]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [openbsd]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==}
engines: {node: '>=18'}
@@ -1575,12 +1449,6 @@ packages:
cpu: [arm64]
os: [openharmony]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [openharmony]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==}
engines: {node: '>=18'}
@@ -1599,12 +1467,6 @@ packages:
cpu: [x64]
os: [sunos]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [sunos]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==}
engines: {node: '>=18'}
@@ -1623,12 +1485,6 @@ packages:
cpu: [arm64]
os: [win32]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==}
- engines: {node: '>=18'}
- cpu: [arm64]
- os: [win32]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==}
engines: {node: '>=18'}
@@ -1647,12 +1503,6 @@ packages:
cpu: [ia32]
os: [win32]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==}
- engines: {node: '>=18'}
- cpu: [ia32]
- os: [win32]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==}
engines: {node: '>=18'}
@@ -1671,12 +1521,6 @@ packages:
cpu: [x64]
os: [win32]
- '@esbuild/[email protected]':
- resolution: {integrity: sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==}
- engines: {node: '>=18'}
- cpu: [x64]
- os: [win32]
-
'@esbuild/[email protected]':
resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==}
engines: {node: '>=18'}
@@ -3654,6 +3498,18 @@ packages:
truefoundry-gateway-sdk:
optional: true
+ '@truefoundry/[email protected]':
+ resolution: {integrity: sha512-r9m9xCcNlvVVX9Em/MzzlIUiT9JVuMf5XeX+KnT/mMx4BvQ9C36Iyn350PsdL6miSmmpsALWjH3weX45zM7k9g==}
+ peerDependencies:
+ '@types/react': '*'
+ react: ^18 || ^19
+ truefoundry-gateway-sdk: ^0.4.0-rc.6
+ peerDependenciesMeta:
+ '@types/react':
+ optional: true
+ truefoundry-gateway-sdk:
+ optional: true
+
resolution: {integrity: sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==}
@@ -4822,11 +4678,6 @@ packages:
engines: {node: '>=18'}
hasBin: true
- resolution: {integrity: sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==}
- engines: {node: '>=18'}
- hasBin: true
-
resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==}
engines: {node: '>=18'}
@@ -8486,9 +8337,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8498,9 +8346,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8510,9 +8355,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8522,9 +8364,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8534,9 +8373,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8546,9 +8382,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8558,9 +8391,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8570,9 +8400,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8582,9 +8409,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8594,9 +8418,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8606,9 +8427,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8618,9 +8436,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8630,9 +8445,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8642,9 +8454,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8654,9 +8463,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8666,9 +8472,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8678,9 +8481,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8690,9 +8490,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8702,9 +8499,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8714,9 +8508,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8726,9 +8517,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8738,9 +8526,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8750,9 +8535,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8762,9 +8544,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8774,9 +8553,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -8786,9 +8562,6 @@ snapshots:
'@esbuild/[email protected]':
optional: true
- '@esbuild/[email protected]':
- optional: true
-
'@esbuild/[email protected]':
optional: true
@@ -10912,6 +10685,21 @@ snapshots:
- redis
- zustand
+ dependencies:
+ '@assistant-ui/store': 0.2.21(@assistant-ui/[email protected](@types/[email protected])([email protected]))(@types/[email protected])([email protected])
+ react: 19.2.8
+ optionalDependencies:
+ '@types/react': 19.2.18
+ truefoundry-gateway-sdk: 0.4.2
+ transitivePeerDependencies:
+ - '@assistant-ui/tap'
+ - assistant-cloud
+ - ioredis
+ - redis
+ - zustand
+
'@types/[email protected]': {}
@@ -11087,10 +10875,10 @@ snapshots:
transitivePeerDependencies:
- supports-color
dependencies:
'@eslint-community/regexpp': 4.12.2
'@typescript-eslint/scope-manager': 8.68.0
@@ -12158,35 +11946,6 @@ snapshots:
'@esbuild/win32-ia32': 0.27.7
'@esbuild/win32-x64': 0.27.7
- optionalDependencies:
- '@esbuild/aix-ppc64': 0.28.1
- '@esbuild/android-arm': 0.28.1
- '@esbuild/android-arm64': 0.28.1
- '@esbuild/android-x64': 0.28.1
- '@esbuild/darwin-arm64': 0.28.1
- '@esbuild/darwin-x64': 0.28.1
- '@esbuild/freebsd-arm64': 0.28.1
- '@esbuild/freebsd-x64': 0.28.1
- '@esbuild/linux-arm': 0.28.1
- '@esbuild/linux-arm64': 0.28.1
- '@esbuild/linux-ia32': 0.28.1
- '@esbuild/linux-loong64': 0.28.1
- '@esbuild/linux-mips64el': 0.28.1
- '@esbuild/linux-ppc64': 0.28.1
- '@esbuild/linux-riscv64': 0.28.1
- '@esbuild/linux-s390x': 0.28.1
- '@esbuild/linux-x64': 0.28.1
- '@esbuild/netbsd-arm64': 0.28.1
- '@esbuild/netbsd-x64': 0.28.1
- '@esbuild/openbsd-arm64': 0.28.1
- '@esbuild/openbsd-x64': 0.28.1
- '@esbuild/openharmony-arm64': 0.28.1
- '@esbuild/sunos-x64': 0.28.1
- '@esbuild/win32-arm64': 0.28.1
- '@esbuild/win32-ia32': 0.28.1
- '@esbuild/win32-x64': 0.28.1
-
optionalDependencies:
'@esbuild/aix-ppc64': 0.28.2
@@ -12215,7 +11974,6 @@ snapshots:
'@esbuild/win32-arm64': 0.28.2
'@esbuild/win32-ia32': 0.28.2
'@esbuild/win32-x64': 0.28.2
- optional: true
@@ -15289,7 +15047,7 @@ snapshots:
dependencies:
- esbuild: 0.28.1
+ esbuild: 0.28.2
optionalDependencies:
fsevents: 2.3.3
@@ -15324,7 +15082,7 @@ snapshots:
dependencies:
'@typescript-eslint/typescript-estree': 8.68.0([email protected])([email protected])