@inkeep/agents-manage-ui 0.18.1 → 0.19.0

package/src/app/[tenantId]/projects/[projectId]/{graphs → agents}/loading.tsx

@@ -2,13 +2,13 @@ import { BodyTemplate } from '@/components/layout/body-template';
 import { MainContent } from '@/components/layout/main-content';
 import { PageHeader } from '@/components/layout/page-header';
 import { Skeleton } from '@/components/ui/skeleton';
-import { graphDescription } from '@/constants/page-descriptions';
+import { agentDescription } from '@/constants/page-descriptions';
 
 export default function Loading() {
   return (
-    <BodyTemplate breadcrumbs={[{ label: 'Graphs' }]}>
+    <BodyTemplate breadcrumbs={[{ label: 'Agent' }]}>
       <MainContent>
-        <PageHeader title="Graphs" description={graphDescription} />
+        <PageHeader title="Agent" description={agentDescription} />
         <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-3 md:gap-4">
           {Array.from({ length: 6 }).map((_, i) => (
             <Skeleton key={`loading-skeleton-${i}`} className="h-36 w-full rounded-lg" />

package/src/app/[tenantId]/projects/[projectId]/{graphs → agents}/new/page.tsx

@@ -1,4 +1,4 @@
-import { Graph } from '@/components/graph/graph';
+import { Agent } from '@/components/agent/agent';
 import { BodyTemplate } from '@/components/layout/body-template';
 import { fetchArtifactComponentsAction } from '@/lib/actions/artifact-components';
 import { fetchCredentialsAction } from '@/lib/actions/credentials';
@@ -6,7 +6,7 @@ import { fetchDataComponentsAction } from '@/lib/actions/data-components';
 import { fetchToolsAction } from '@/lib/actions/tools';
 import { createLookup } from '@/lib/utils';
 
-async function NewGraphPage({
+async function NewAgentPage({
   params,
 }: {
   params: Promise<{ tenantId: string; projectId: string }>;
@@ -42,11 +42,11 @@ async function NewGraphPage({
   return (
     <BodyTemplate
       breadcrumbs={[
-        { label: 'Graphs', href: `/${tenantId}/projects/${projectId}/graphs` },
-        { label: 'New Graph' },
+        { label: 'Agent', href: `/${tenantId}/projects/${projectId}/agents` },
+        { label: 'New Agent' },
       ]}
     >
-      <Graph
+      <Agent
         dataComponentLookup={dataComponentLookup}
         artifactComponentLookup={artifactComponentLookup}
         toolLookup={toolLookup}
@@ -56,4 +56,4 @@ async function NewGraphPage({
   );
 }
 
-export default NewGraphPage;
+export default NewAgentPage;

package/src/app/[tenantId]/projects/[projectId]/agents/page.tsx

@@ -0,0 +1,50 @@
+import { AgentList } from '@/components/agents/agents-list';
+import { AgentsIcon } from '@/components/icons/empty-state/agents';
+import { BodyTemplate } from '@/components/layout/body-template';
+import EmptyState from '@/components/layout/empty-state';
+import { MainContent } from '@/components/layout/main-content';
+import { PageHeader } from '@/components/layout/page-header';
+import { agentDescription } from '@/constants/page-descriptions';
+import { fetchAgents } from '@/lib/api/agent-full-client';
+import type { Agent } from '@/lib/types/agent-full';
+
+export const dynamic = 'force-dynamic';
+
+interface AgentsPageProps {
+  params: Promise<{ tenantId: string; projectId: string }>;
+}
+
+async function AgentsPage({ params }: AgentsPageProps) {
+  const { tenantId, projectId } = await params;
+  let agent: { data: Agent[] } = { data: [] };
+  try {
+    const response = await fetchAgents(tenantId, projectId);
+    agent = response;
+  } catch (_error) {
+    throw new Error('Failed to fetch agent');
+  }
+  return (
+    <BodyTemplate
+      breadcrumbs={[{ label: 'Agent', href: `/${tenantId}/projects/${projectId}/agents` }]}
+    >
+      <MainContent className="min-h-full">
+        {agent.data.length > 0 ? (
+          <>
+            <PageHeader title="Agent" description={agentDescription} />
+            <AgentList tenantId={tenantId} projectId={projectId} agent={agent.data} />
+          </>
+        ) : (
+          <EmptyState
+            title="No agent yet."
+            description={agentDescription}
+            link={`/${tenantId}/projects/${projectId}/agents/new`}
+            linkText="Create agent"
+            icon={<AgentsIcon />}
+          />
+        )}
+      </MainContent>
+    </BodyTemplate>
+  );
+}
+
+export default AgentsPage;

package/src/app/[tenantId]/projects/[projectId]/api-keys/page.tsx

@@ -6,16 +6,16 @@ import { MainContent } from '@/components/layout/main-content';
 import { PageHeader } from '@/components/layout/page-header';
 import { apiKeyDescription } from '@/constants/page-descriptions';
 import { fetchApiKeys } from '@/lib/api/api-keys';
-import { fetchGraphs } from '@/lib/api/graph-full-client';
-import type { Graph } from '@/lib/types/graph-full';
+import { fetchAgents } from '@/lib/api/agent-full-client';
+import type { Agent } from '@/lib/types/agent-full';
 import { createLookup } from '@/lib/utils';
 
 export const dynamic = 'force-dynamic';
 
-const createGraphOptions = (graphs: Graph[]): SelectOption[] => {
-  return graphs.map((graph) => ({
-    value: graph.id,
-    label: graph.name,
+const createAgentOptions = (agent: Agent[]): SelectOption[] => {
+  return agent.map((agent) => ({
+    value: agent.id,
+    label: agent.name,
   }));
 };
 
@@ -25,13 +25,13 @@ interface ApiKeysPageProps {
 
 async function ApiKeysPage({ params }: ApiKeysPageProps) {
   const { tenantId, projectId } = await params;
-  const [apiKeys, graphs] = await Promise.all([
+  const [apiKeys, agent] = await Promise.all([
     fetchApiKeys(tenantId, projectId),
-    fetchGraphs(tenantId, projectId),
+    fetchAgents(tenantId, projectId),
   ]);
 
-  const graphLookup = createLookup(graphs.data);
-  const graphOptions = createGraphOptions(graphs.data);
+  const agentLookup = createLookup(agent.data);
+  const agentOptions = createAgentOptions(agent.data);
   return (
     <BodyTemplate
       breadcrumbs={[
@@ -49,11 +49,11 @@ async function ApiKeysPage({ params }: ApiKeysPageProps) {
             <NewApiKeyDialog
               tenantId={tenantId}
               projectId={projectId}
-              graphsOptions={graphOptions}
+              agentsOptions={agentOptions}
             />
           }
         />
-        <ApiKeysTable apiKeys={apiKeys.data} graphLookup={graphLookup} />
+        <ApiKeysTable apiKeys={apiKeys.data} agentLookup={agentLookup} />
       </MainContent>
     </BodyTemplate>
   );

package/src/app/[tenantId]/projects/[projectId]/page.tsx

@@ -11,7 +11,7 @@ export default function ProjectPage() {
 
   useEffect(() => {
     // Use client-side navigation instead of server-side redirect
-    router.replace(`/${tenantId}/projects/${projectId}/graphs`);
+    router.replace(`/${tenantId}/projects/${projectId}/agents`);
   }, [tenantId, projectId, router]);
 
   // Show loading state while redirecting

package/src/app/api/signoz/conversations/[conversationId]/route.ts

@@ -209,7 +209,7 @@ function buildConversationListPayload(
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             { key: SPAN_KEYS.AI_TOOL_TYPE, ...QUERY_FIELD_CONFIGS.STRING_TAG },
-            { key: SPAN_KEYS.AI_AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.AI_SUB_AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
             {
               key: SPAN_KEYS.AI_TELEMETRY_FUNCTION_ID,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
@@ -239,8 +239,8 @@ function buildConversationListPayload(
               key: SPAN_KEYS.OTEL_STATUS_DESCRIPTION,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
-            { key: SPAN_KEYS.GRAPH_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
-            { key: SPAN_KEYS.GRAPH_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.AGENT_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
           ]
         ),
 
@@ -292,7 +292,7 @@ function buildConversationListPayload(
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             {
-              key: SPAN_KEYS.CONTEXT_AGENT_GRAPH_ID,
+              key: SPAN_KEYS.CONTEXT_AGENT_ID,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             {
@@ -350,7 +350,7 @@ function buildConversationListPayload(
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             {
-              key: SPAN_KEYS.CONTEXT_AGENT_GRAPH_ID,
+              key: SPAN_KEYS.CONTEXT_AGENT_ID,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             {
@@ -463,8 +463,8 @@ function buildConversationListPayload(
               key: SPAN_KEYS.MESSAGE_TIMESTAMP,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
-            { key: SPAN_KEYS.GRAPH_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
-            { key: SPAN_KEYS.GRAPH_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.AGENT_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
           ]
         ),
 
@@ -511,7 +511,7 @@ function buildConversationListPayload(
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
             {
-              key: SPAN_KEYS.AI_AGENT_NAME_ALT,
+              key: SPAN_KEYS.AI_SUB_AGENT_NAME_ALT,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
             },
           ]
@@ -617,8 +617,8 @@ function buildConversationListPayload(
               key: SPAN_KEYS.DURATION_NANO,
               ...QUERY_FIELD_CONFIGS.FLOAT64_TAG_COLUMN,
             },
-            { key: SPAN_KEYS.AGENT_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
-            { key: SPAN_KEYS.AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.SUB_AGENT_ID, ...QUERY_FIELD_CONFIGS.STRING_TAG },
+            { key: SPAN_KEYS.SUB_AGENT_NAME, ...QUERY_FIELD_CONFIGS.STRING_TAG },
             {
               key: SPAN_KEYS.AI_RESPONSE_TEXT,
               ...QUERY_FIELD_CONFIGS.STRING_TAG,
@@ -813,9 +813,9 @@ export async function GET(
       'context.resolve',
       'agent.generate',
       'context-resolver.resolve_single_fetch_definition',
-      'graph_session.generate_structured_update',
-      'graph_session.process_artifact',
-      'graph_session.generate_artifact_metadata',
+      'agent_session.generate_structured_update',
+      'agent_session.process_artifact',
+      'agent_session.generate_artifact_metadata',
       'response.format_object_response',
       'response.format_response',
     ];
@@ -832,12 +832,12 @@ export async function GET(
       }
     }
 
-    let graphId: string | null = null;
-    let graphName: string | null = null;
+    let agentId: string | null = null;
+    let agentName: string | null = null;
     for (const s of userMessageSpans) {
-      graphId = getString(s, SPAN_KEYS.GRAPH_ID, '') || null;
-      graphName = getString(s, SPAN_KEYS.GRAPH_NAME, '') || null;
-      if (graphId || graphName) break;
+      agentId = getString(s, SPAN_KEYS.AGENT_ID, '') || null;
+      agentName = getString(s, SPAN_KEYS.AGENT_NAME, '') || null;
+      if (agentId || agentName) break;
     }
     // activities
     type Activity = {
@@ -857,7 +857,7 @@ export async function GET(
       timestamp: string;
       status: 'success' | 'error' | 'pending';
       subAgentId?: string;
-      agentName?: string;
+      subAgentName?: string;
       result?: string;
       // ai
       aiModel?: string;
@@ -871,7 +871,7 @@ export async function GET(
       messageContent?: string;
       // context resolution
       contextConfigId?: string;
-      contextAgentGraphId?: string;
+      contextAgentAgentId?: string;
       contextHeadersKeys?: string[];
       contextTrigger?: string;
       contextStatusDescription?: string;
@@ -944,7 +944,7 @@ export async function GET(
         description: hasError && statusMessage ? statusMessage : `Called ${name}`,
         timestamp: span.timestamp,
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
-        agentName: getString(span, SPAN_KEYS.AI_AGENT_NAME, ACTIVITY_NAMES.UNKNOWN_AGENT),
+        subAgentName: getString(span, SPAN_KEYS.AI_SUB_AGENT_NAME, ACTIVITY_NAMES.UNKNOWN_AGENT),
         result: hasError ? `Tool call failed (${durMs.toFixed(2)}ms)` : `${durMs.toFixed(2)}ms`,
         toolType: toolType || undefined,
         toolPurpose: toolPurpose || undefined,
@@ -983,7 +983,7 @@ export async function GET(
         contextStatusDescription: statusMessage || undefined,
         contextUrl: getString(span, SPAN_KEYS.CONTEXT_URL, '') || undefined,
         contextConfigId: getString(span, SPAN_KEYS.CONTEXT_CONFIG_ID, '') || undefined,
-        contextAgentGraphId: getString(span, SPAN_KEYS.CONTEXT_AGENT_GRAPH_ID, '') || undefined,
+        contextAgentAgentId: getString(span, SPAN_KEYS.CONTEXT_AGENT_ID, '') || undefined,
         contextHeadersKeys: keys,
       });
     }
@@ -1013,7 +1013,7 @@ export async function GET(
         contextStatusDescription: statusMessage || undefined,
         contextUrl: getString(span, SPAN_KEYS.CONTEXT_URL, '') || undefined,
         contextConfigId: getString(span, SPAN_KEYS.CONTEXT_CONFIG_ID, '') || undefined,
-        contextAgentGraphId: getString(span, SPAN_KEYS.CONTEXT_AGENT_GRAPH_ID, '') || undefined,
+        contextAgentAgentId: getString(span, SPAN_KEYS.CONTEXT_AGENT_ID, '') || undefined,
         contextHeadersKeys: keys,
       });
     }
@@ -1030,7 +1030,7 @@ export async function GET(
         timestamp: getString(span, SPAN_KEYS.MESSAGE_TIMESTAMP),
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
         subAgentId: AGENT_IDS.USER,
-        agentName: ACTIVITY_NAMES.USER,
+        subAgentName: ACTIVITY_NAMES.USER,
         result: hasError
           ? 'Message processing failed'
           : `Message received successfully (${durMs.toFixed(2)}ms)`,
@@ -1050,7 +1050,7 @@ export async function GET(
         timestamp: getString(span, SPAN_KEYS.AI_RESPONSE_TIMESTAMP),
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
         subAgentId: AGENT_IDS.AI_ASSISTANT,
-        agentName: getString(span, SPAN_KEYS.AI_AGENT_NAME_ALT, ACTIVITY_NAMES.UNKNOWN_AGENT),
+        subAgentName: getString(span, SPAN_KEYS.AI_SUB_AGENT_NAME_ALT, ACTIVITY_NAMES.UNKNOWN_AGENT),
         result: hasError
           ? 'AI response failed'
           : `AI response sent successfully (${durMs.toFixed(2)}ms)`,
@@ -1076,7 +1076,7 @@ export async function GET(
         timestamp: span.timestamp,
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
         subAgentId: getString(span, SPAN_KEYS.AGENT_ID, '') || undefined,
-        agentName: getString(span, SPAN_KEYS.AI_TELEMETRY_FUNCTION_ID, '') || undefined,
+        subAgentName: getString(span, SPAN_KEYS.AI_TELEMETRY_FUNCTION_ID, '') || undefined,
         result: hasError
           ? 'AI generation failed'
           : `AI text generated successfully (${durMs.toFixed(2)}ms)`,
@@ -1124,8 +1124,8 @@ export async function GET(
         description: 'AI model streaming text response',
         timestamp: span.timestamp,
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
-        subAgentId: getString(span, SPAN_KEYS.AGENT_ID, '') || undefined,
-        agentName: getString(span, SPAN_KEYS.AGENT_NAME, ACTIVITY_NAMES.UNKNOWN_AGENT),
+        subAgentId: getString(span, SPAN_KEYS.SUB_AGENT_ID, '') || undefined,
+        subAgentName: getString(span, SPAN_KEYS.SUB_AGENT_NAME, ACTIVITY_NAMES.UNKNOWN_AGENT),
         result: hasError
           ? 'AI streaming failed'
           : `AI text streamed successfully (${durMs.toFixed(2)}ms)`,
@@ -1148,7 +1148,7 @@ export async function GET(
         timestamp: span.timestamp,
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
         subAgentId: UNKNOWN_VALUE,
-        agentName: 'Context Fetcher',
+        subAgentName: 'Context Fetcher',
         result: hasError
           ? 'Context fetch failed'
           : getString(span, SPAN_KEYS.HTTP_URL, 'Unknown URL'),
@@ -1169,7 +1169,7 @@ export async function GET(
         description: 'Artifact processed',
         timestamp: span.timestamp,
         status: hasError ? ACTIVITY_STATUS.ERROR : ACTIVITY_STATUS.SUCCESS,
-        agentName: getString(span, SPAN_KEYS.ARTIFACT_AGENT_ID, '') || 'Unknown Agent',
+        subAgentName: getString(span, SPAN_KEYS.ARTIFACT_AGENT_ID, '') || 'Unknown Agent',
         result: hasError
           ? 'Artifact processing failed'
           : 'Artifact processed successfully',
@@ -1291,8 +1291,8 @@ export async function GET(
       totalInputTokens,
       totalOutputTokens,
       mcpToolErrors: [],
-      graphId,
-      graphName,
+      agentId,
+      agentName,
       allSpanAttributes,
       spansWithErrorsCount: spansWithErrorsList.length,
       errorCount,

package/src/app/api/signoz/route.ts

@@ -137,7 +137,7 @@ export async function GET() {
       step: 60,
       compositeQuery: {
         queryType: 'builder',
-        panelType: 'graph',
+        panelType: 'agent',
         builderQueries: {},
       },
     };

package/src/app/layout.tsx

@@ -28,7 +28,7 @@ const inter = Inter({
 export const metadata: Metadata = {
   title: 'Inkeep Agents',
   description:
-    "Inkeep's multi-agent framework enables multiple specialized AI agents to collaborate and solve complex problems through a graph-based architecture. You can define networks of agents, each with unique instructions, tools, and purposes.",
+    "Inkeep's multi-agent framework enables multiple specialized AI agents to collaborate and solve complex problems through an agent-based architecture. You can define networks of agents, each with unique instructions, tools, and purposes.",
 };
 
 export default function RootLayout({

package/src/app/page.tsx

@@ -8,7 +8,7 @@ async function Home() {
     console.warn(`TENANT_ID is not set, using default tenantId: ${DEFAULT_TENANT_ID}`);
   }
   const tenantId = process.env.TENANT_ID || DEFAULT_TENANT_ID;
-  await redirectToProject(tenantId, 'graphs');
+  await redirectToProject(tenantId, 'agents');
 }
 
 export default Home;