@inkeep/agents-manage-ui 0.1.0

package/src/lib/api/api-config.ts

@@ -0,0 +1,104 @@
+/**
+ * API Configuration
+ *
+ * Centralized configuration for API endpoints and settings
+ */
+
+import { ApiError } from '../types/errors';
+
+const DEFAULT_MANAGEMENT_API_BASE_URL = 'http://localhost:3002';
+const DEFAULT_EXECUTION_API_BASE_URL = 'http://localhost:3003';
+
+// Management API (CRUD operations, configuration)
+if (!process.env.NEXT_PUBLIC_INKEEP_MANAGEMENT_API_URL) {
+  console.warn(
+    `NEXT_PUBLIC_INKEEP_MANAGEMENT_API_URL is not set, falling back to: ${DEFAULT_MANAGEMENT_API_BASE_URL}`
+  );
+}
+
+// Execution API (chat completions, agent execution)
+if (!process.env.NEXT_PUBLIC_INKEEP_EXECUTION_API_URL) {
+  console.warn(
+    `NEXT_PUBLIC_INKEEP_EXECUTION_API_URL is not set, falling back to: ${DEFAULT_EXECUTION_API_BASE_URL}`
+  );
+}
+
+export const MANAGEMENT_API_BASE_URL =
+  process.env.NEXT_PUBLIC_INKEEP_MANAGEMENT_API_URL || DEFAULT_MANAGEMENT_API_BASE_URL;
+export const EXECUTION_API_BASE_URL =
+  process.env.NEXT_PUBLIC_INKEEP_EXECUTION_API_URL || DEFAULT_EXECUTION_API_BASE_URL;
+
+async function makeApiRequestInternal<T>(
+  baseUrl: string,
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<T> {
+  const url = `${baseUrl}/${endpoint}`;
+  const defaultHeaders = {
+    'Content-Type': 'application/json',
+    ...options.headers,
+    ...(process.env.INKEEP_AGENTS_MANAGE_API_SECRET && {
+      Authorization: `Bearer ${process.env.INKEEP_AGENTS_MANAGE_API_SECRET}`,
+    }),
+  };
+
+  try {
+    const response = await fetch(url, {
+      ...options,
+      headers: defaultHeaders,
+    });
+
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({
+        error: { code: 'unknown', message: 'Unknown error occurred' },
+      }));
+
+      throw new ApiError(
+        errorData.error || { code: 'unknown', message: 'Unknown error occurred' },
+        response.status
+      );
+    }
+
+    // Check if there's actually content to parse
+    const contentType = response.headers.get('content-type');
+    const hasJsonContent = contentType?.includes('application/json');
+
+    // Try to parse JSON if we expect JSON content
+    if (hasJsonContent) {
+      const text = await response.text();
+      return text ? JSON.parse(text) : (undefined as T);
+    }
+
+    // For non-JSON responses or empty responses
+    return undefined as T;
+  } catch (error) {
+    if (error instanceof ApiError) {
+      throw error;
+    }
+
+    // Network or other errors
+    throw new ApiError(
+      {
+        code: 'internal_server_error',
+        message: error instanceof Error ? error.message : 'Network error occurred',
+      },
+      500
+    );
+  }
+}
+
+// Management API requests (CRUD operations, configuration)
+export async function makeManagementApiRequest<T>(
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<T> {
+  return makeApiRequestInternal<T>(MANAGEMENT_API_BASE_URL, endpoint, options);
+}
+
+// Execution API requests (chat completions, agent execution)
+export async function makeExecutionApiRequest<T>(
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<T> {
+  return makeApiRequestInternal<T>(EXECUTION_API_BASE_URL, endpoint, options);
+}

package/src/lib/api/api-keys.ts

@@ -0,0 +1,117 @@
+/**
+ * API Client for API Keys Operations
+ *
+ * This module provides HTTP client functions to communicate with the
+ * inkeep-chat backend API Keys REST API endpoints.
+ */
+
+'use server';
+
+import type { ApiKeyApiSelect, ApiKeyApiCreationResponse } from '@inkeep/agents-core/client-exports';
+import type { ListResponse, SingleResponse } from '../types/response';
+import { makeManagementApiRequest } from './api-config';
+import { validateProjectId, validateTenantId } from './resource-validation';
+
+// Re-export types from core package for convenience
+// Note: ApiKeyApiSelect might not have a 'name' field yet, and UI expects undefined instead of null
+export type ApiKey = Omit<ApiKeyApiSelect, 'lastUsedAt' | 'expiresAt'> & {
+  name?: string; // todo: will be added soon (should be required then)
+  lastUsedAt?: string; // Convert null to undefined for UI compatibility
+  expiresAt?: string; // Convert null to undefined for UI compatibility
+};
+
+// The core ApiKeyApiCreationResponse has a 'data' wrapper, but we want a flat structure
+export type ApiKeyCreateResponse = {
+  apiKey: ApiKey;
+  key: string; // The full API key value (shown only once)
+};
+
+export async function fetchApiKeys(
+  tenantId: string,
+  projectId: string
+): Promise<ListResponse<ApiKey>> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<ListResponse<ApiKeyApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/api-keys`
+  );
+
+  // Transform the response to convert nulls to undefined
+  return {
+    ...response,
+    data: response.data.map((item) => ({
+      ...item,
+      lastUsedAt: item.lastUsedAt ?? undefined,
+      expiresAt: item.expiresAt ?? undefined,
+    })),
+  } as ListResponse<ApiKey>;
+}
+
+/**
+ * Create a new api key
+ */
+export async function createApiKey(
+  tenantId: string,
+  projectId: string,
+  apiKeyData: Partial<ApiKey>
+): Promise<ApiKeyCreateResponse> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<ApiKeyApiCreationResponse>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/api-keys`,
+    {
+      method: 'POST',
+      body: JSON.stringify(apiKeyData),
+    }
+  );
+
+  // The response.data contains the ApiKeyApiCreationResponse structure
+  // We need to extract and transform it to our expected structure
+  const rawResponse = response.data as any;
+  if (rawResponse?.data?.apiKey && rawResponse?.data?.key) {
+    const { apiKey, key } = rawResponse.data;
+    return {
+      apiKey: {
+        ...apiKey,
+        lastUsedAt: apiKey.lastUsedAt ?? undefined,
+        expiresAt: apiKey.expiresAt ?? undefined,
+      },
+      key,
+    };
+  }
+
+  // Fallback for direct structure (if API returns flat response)
+  if (rawResponse?.apiKey && rawResponse?.key) {
+    return {
+      apiKey: {
+        ...rawResponse.apiKey,
+        lastUsedAt: rawResponse.apiKey.lastUsedAt ?? undefined,
+        expiresAt: rawResponse.apiKey.expiresAt ?? undefined,
+      },
+      key: rawResponse.key,
+    };
+  }
+
+  return rawResponse;
+}
+
+/**
+ * Delete an api key
+ */
+export async function deleteApiKey(
+  tenantId: string,
+  projectId: string,
+  apiKeyId: string
+): Promise<void> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  await makeManagementApiRequest(
+    `tenants/${tenantId}/crud/projects/${projectId}/api-keys/${apiKeyId}`,
+    {
+      method: 'DELETE',
+    }
+  );
+}

package/src/lib/api/artifact-components.ts

@@ -0,0 +1,146 @@
+/**
+ * API Client for Artifacts Operations
+ *
+ * This module provides HTTP client functions to communicate with the
+ * inkeep-chat backend Artifacts REST API endpoints.
+ */
+
+'use server';
+
+import type {
+  ArtifactComponentApiInsert,
+  ArtifactComponentApiSelect,
+  ArtifactComponentApiUpdate,
+} from '@inkeep/agents-core';
+import type { ListResponse, SingleResponse } from '../types/response';
+// Configuration for the API client
+import { makeManagementApiRequest } from './api-config';
+import { validateProjectId, validateTenantId } from './resource-validation';
+
+// Re-export types from core package for convenience
+// Note: ArtifactComponentApiSelect might have nullable props, but UI expects non-nullable
+export type ArtifactComponent = Omit<ArtifactComponentApiSelect, 'summaryProps' | 'fullProps'> & {
+  summaryProps: Record<string, any>; // Ensure summaryProps is non-nullable for UI compatibility
+  fullProps: Record<string, any>; // Ensure fullProps is non-nullable for UI compatibility
+};
+
+/**
+ * Fetch all artifacts for a tenant
+ */
+export async function fetchArtifactComponents(
+  tenantId: string,
+  projectId: string
+): Promise<ListResponse<ArtifactComponent>> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<ListResponse<ArtifactComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/artifact-components`
+  );
+
+  // Transform the response to ensure props are non-nullable
+  return {
+    ...response,
+    data: response.data.map((item) => ({
+      ...item,
+      summaryProps: item.summaryProps || {},
+      fullProps: item.fullProps || {},
+    })),
+  };
+}
+
+/**
+ * Fetch a single artifact component by ID
+ */
+export async function fetchArtifactComponent(
+  tenantId: string,
+  projectId: string,
+  artifactComponentId: string
+): Promise<ArtifactComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<ArtifactComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/artifact-components/${artifactComponentId}`
+  );
+
+  // Transform the response to ensure props are non-nullable
+  return {
+    ...response.data,
+    summaryProps: response.data.summaryProps || {},
+    fullProps: response.data.fullProps || {},
+  };
+}
+
+/**
+ * Create a new artifact component
+ */
+export async function createArtifactComponent(
+  tenantId: string,
+  projectId: string,
+  artifactComponent: ArtifactComponentApiInsert
+): Promise<ArtifactComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<ArtifactComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/artifact-components`,
+    {
+      method: 'POST',
+      body: JSON.stringify(artifactComponent),
+    }
+  );
+
+  // Transform the response to ensure props are non-nullable
+  return {
+    ...response.data,
+    summaryProps: response.data.summaryProps || {},
+    fullProps: response.data.fullProps || {},
+  };
+}
+
+/**
+ * Update an existing artifact component
+ */
+export async function updateArtifactComponent(
+  tenantId: string,
+  projectId: string,
+  artifactComponent: ArtifactComponentApiUpdate & { id: string }
+): Promise<ArtifactComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<ArtifactComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/artifact-components/${artifactComponent.id}`,
+    {
+      method: 'PUT',
+      body: JSON.stringify(artifactComponent),
+    }
+  );
+
+  // Transform the response to ensure props are non-nullable
+  return {
+    ...response.data,
+    summaryProps: response.data.summaryProps || {},
+    fullProps: response.data.fullProps || {},
+  };
+}
+
+/**
+ * Delete an artifact component
+ */
+export async function deleteArtifactComponent(
+  tenantId: string,
+  projectId: string,
+  artifactComponentId: string
+): Promise<void> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  await makeManagementApiRequest(
+    `tenants/${tenantId}/crud/projects/${projectId}/artifact-components/${artifactComponentId}`,
+    {
+      method: 'DELETE',
+    }
+  );
+}

package/src/lib/api/credentials.ts

@@ -0,0 +1,127 @@
+'use server';
+
+import type {
+  CredentialReferenceApiSelect,
+  CredentialReferenceApiInsert,
+  McpTool,
+} from '@inkeep/agents-core';
+import type { ListResponse, SingleResponse } from '../types/response';
+// Default configuration
+import { makeManagementApiRequest } from './api-config';
+import { validateProjectId, validateTenantId } from './resource-validation';
+
+// Re-export types from core package for convenience
+export type Credential = CredentialReferenceApiSelect & {
+  tools?: McpTool[];
+};
+export type CreateCredentialRequest = CredentialReferenceApiInsert;
+
+/**
+ * List all credentials for the current tenant
+ */
+export async function fetchCredentials(
+  tenantId: string,
+  projectId: string,
+  page = 1,
+  pageSize = 50
+): Promise<Credential[]> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const params = new URLSearchParams({
+    page: page.toString(),
+    limit: pageSize.toString(),
+  });
+
+  const response = await makeManagementApiRequest<ListResponse<CredentialReferenceApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/credentials?${params}`
+  );
+
+  // Cast to Credential type (includes optional tools field)
+  return response.data as Credential[];
+}
+
+/**
+ * Get a single credential by ID
+ */
+export async function fetchCredential(
+  tenantId: string,
+  projectId: string,
+  id: string
+): Promise<Credential> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<CredentialReferenceApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/credentials/${id}`
+  );
+
+  // Cast to Credential type (includes optional tools field)
+  return response.data as Credential;
+}
+
+/**
+ * Create a new credential
+ */
+export async function createCredential(
+  tenantId: string,
+  projectId: string,
+  data: CredentialReferenceApiInsert
+): Promise<Credential> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<CredentialReferenceApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/credentials`,
+    {
+      method: 'POST',
+      body: JSON.stringify(data),
+    }
+  );
+
+  // Cast to Credential type (includes optional tools field)
+  return response.data as Credential;
+}
+
+/**
+ * Update an existing credential
+ */
+export async function updateCredential(
+  tenantId: string,
+  projectId: string,
+  id: string,
+  data: Partial<CredentialReferenceApiInsert>
+): Promise<Credential> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<CredentialReferenceApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/credentials/${id}`,
+    {
+      method: 'PUT',
+      body: JSON.stringify(data),
+    }
+  );
+
+  // Cast to Credential type (includes optional tools field)
+  return response.data as Credential;
+}
+
+/**
+ * Delete a credential
+ */
+export async function deleteCredential(
+  tenantId: string,
+  projectId: string,
+  id: string
+): Promise<void> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  await makeManagementApiRequest<void>(
+    `tenants/${tenantId}/crud/projects/${projectId}/credentials/${id}`,
+    {
+      method: 'DELETE',
+    }
+  );
+}

package/src/lib/api/data-components.ts

@@ -0,0 +1,141 @@
+/**
+ * API Client for Data Components Operations
+ *
+ * This module provides HTTP client functions to communicate with the
+ * inkeep-chat backend Data Components REST API endpoints.
+ */
+
+'use server';
+
+import type {
+  DataComponentApiSelect,
+  DataComponentApiInsert,
+  DataComponentApiUpdate,
+} from '@inkeep/agents-core';
+import type { ListResponse, SingleResponse } from '../types/response';
+// Configuration for the API client
+import { makeManagementApiRequest } from './api-config';
+import { validateProjectId, validateTenantId } from './resource-validation';
+
+// Re-export types from core package for convenience
+// Note: DataComponentApiSelect might have nullable props, but UI expects non-nullable
+export type DataComponent = Omit<DataComponentApiSelect, 'props'> & {
+  props: Record<string, any>; // Ensure props is non-nullable for UI compatibility
+};
+
+/**
+ * Fetch all data components for a tenant
+ */
+export async function fetchDataComponents(
+  tenantId: string,
+  projectId: string
+): Promise<ListResponse<DataComponent>> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<ListResponse<DataComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/data-components`
+  );
+
+  // Transform the response to ensure props is non-nullable
+  return {
+    ...response,
+    data: response.data.map((item) => ({
+      ...item,
+      props: item.props || {},
+    })),
+  };
+}
+
+/**
+ * Fetch a single data component by ID
+ */
+export async function fetchDataComponent(
+  tenantId: string,
+  projectId: string,
+  dataComponentId: string
+): Promise<DataComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<DataComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/data-components/${dataComponentId}`
+  );
+
+  // Transform the response to ensure props is non-nullable
+  return {
+    ...response.data,
+    props: response.data.props || {},
+  };
+}
+
+/**
+ * Create a new data component
+ */
+export async function createDataComponent(
+  tenantId: string,
+  projectId: string,
+  dataComponent: DataComponentApiInsert
+): Promise<DataComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<DataComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/data-components`,
+    {
+      method: 'POST',
+      body: JSON.stringify(dataComponent),
+    }
+  );
+
+  // Transform the response to ensure props is non-nullable
+  return {
+    ...response.data,
+    props: response.data.props || {},
+  };
+}
+
+/**
+ * Update an existing data component
+ */
+export async function updateDataComponent(
+  tenantId: string,
+  projectId: string,
+  dataComponent: DataComponentApiUpdate & { id: string }
+): Promise<DataComponent> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  const response = await makeManagementApiRequest<SingleResponse<DataComponentApiSelect>>(
+    `tenants/${tenantId}/crud/projects/${projectId}/data-components/${dataComponent.id}`,
+    {
+      method: 'PUT',
+      body: JSON.stringify(dataComponent),
+    }
+  );
+
+  // Transform the response to ensure props is non-nullable
+  return {
+    ...response.data,
+    props: response.data.props || {},
+  };
+}
+
+/**
+ * Delete a data component
+ */
+export async function deleteDataComponent(
+  tenantId: string,
+  projectId: string,
+  dataComponentId: string
+): Promise<void> {
+  validateTenantId(tenantId);
+  validateProjectId(projectId);
+
+  await makeManagementApiRequest(
+    `tenants/${tenantId}/crud/projects/${projectId}/data-components/${dataComponentId}`,
+    {
+      method: 'DELETE',
+    }
+  );
+}