Skip to content

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

2.1 KB
Raw Blame
'use client';

import { createContext, createElement, useContext, useEffect, useState, type ReactNode } from 'react';

import type { PermissionsServer } from '../server/types.js';

export type UseCanCreateAgentResult = {
  loading: boolean;
  /** False while loading, on error, or when CREATE is not granted (fail-closed). */
  canCreateAgent: boolean;
};

const CanCreateAgentContext = createContext<UseCanCreateAgentResult>({
  loading: false,
  canCreateAgent: true,
});

/**
 * Fetches the tenant-scoped CREATE grant once for the given permissions server
 * and broadcasts the result via context. Mount once high in the tree (inside
 * ServerProvider) so every useCanCreateAgent consumer shares a single
 * list-permissions call instead of each firing its own.
 */
export function CanCreateAgentProvider({
  permissionsServer,
  children,
}: {
  permissionsServer: PermissionsServer | null;
  children: ReactNode;
}) {
  const [state, setState] = useState<UseCanCreateAgentResult>({
    loading: permissionsServer != null,
    canCreateAgent: permissionsServer == null,
  });

  useEffect(() => {
    if (permissionsServer == null) {
      setState({ loading: false, canCreateAgent: true });
      return;
    }

    let cancelled = false;
    setState({ loading: true, canCreateAgent: false });
    void permissionsServer
      .listPermissions({ resourceType: 'tenant', resourceIds: [] })
      .then(response => {
        if (cancelled) return;
        const granted = response.data.permissions.agent ?? [];
        setState({ loading: false, canCreateAgent: granted.includes('CREATE') });
      })
      .catch(() => {
        if (cancelled) return;
        setState({ loading: false, canCreateAgent: false });
      });

    return () => {
      cancelled = true;
    };
  }, [permissionsServer]);

  return createElement(CanCreateAgentContext.Provider, { value: state }, children);
}

/**
 * Tenant-scoped create-agent grant. Reads from CanCreateAgentProvider (mounted
 * inside ServerProvider). Falls back to allow-all when no permissions port is configured.
 */
export function useCanCreateAgent(): UseCanCreateAgentResult {
  return useContext(CanCreateAgentContext);
}