@exulu/backend 1.48.2 → 1.49.0

package/mintlify-docs/api-reference/core-types/overview.mdx

@@ -1,73 +0,0 @@
----
-title: 'Overview'
-description: 'Predefined GraphQL types for Exulu IMP platform resources'
----
-
-## Overview
-
-Core types are predefined GraphQL types provided by Exulu IMP for managing platform resources. These types are always available in the schema, regardless of your implementation.
-
-## Type Categories
-
-<CardGroup cols={2}>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent configurations, capabilities, and rate limiting
-  </Card>
-  <Card title="Session Types" icon="comments" href="/api-reference/core-types/session-types">
-    Conversation sessions and messages
-  </Card>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    Users, roles, and authentication
-  </Card>
-  <Card title="Evaluation Types" icon="chart-line" href="/api-reference/core-types/evaluation-types">
-    Test cases, eval sets, and eval runs
-  </Card>
-  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
-    Workflow templates and execution
-  </Card>
-  <Card title="Configuration" icon="gear" href="/api-reference/core-types/configuration-types">
-    Variables and project organization
-  </Card>
-  <Card title="Prompt Management" icon="pen-to-square" href="/api-reference/core-types/prompt-types">
-    Prompt library and favorites
-  </Card>
-  <Card title="Analytics" icon="chart-bar" href="/api-reference/core-types/analytics-types">
-    Usage statistics and reporting
-  </Card>
-  <Card title="Job Management" icon="gears" href="/api-reference/core-types/job-types">
-    Background job tracking
-  </Card>
-  <Card title="RBAC Types" icon="shield" href="/api-reference/core-types/rbac-types">
-    Access control and permissions
-  </Card>
-</CardGroup>
-
-## Common Fields
-
-Most core types include these standard fields:
-
-- **id** - Unique identifier (ID or Int)
-- **createdAt** - Timestamp when resource was created
-- **updatedAt** - Timestamp when resource was last modified
-- **RBAC** - Access control settings (when RBAC is enabled)
-
-## Type Safety
-
-All core types are fully typed in the GraphQL schema with TypeScript support. Use GraphQL introspection to explore available fields and their types.
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card title="Dynamic Types" icon="wand-magic-sparkles" href="/api-reference/dynamic-types">
-    Learn about context-generated types
-  </Card>
-  <Card title="Queries" icon="magnifying-glass" href="/api-reference/queries">
-    Explore all query operations
-  </Card>
-  <Card title="Mutations" icon="pen-to-square" href="/api-reference/mutations">
-    Explore all mutation operations
-  </Card>
-  <Card title="API Introduction" icon="book" href="/api-reference/introduction">
-    Back to API overview
-  </Card>
-</CardGroup>

package/mintlify-docs/api-reference/core-types/prompt-types.mdx

@@ -1,102 +0,0 @@
----
-title: 'Prompt Library'
-description: 'GraphQL types for prompt library and favorites'
----
-
-## prompt_library
-
-Saved prompts for reuse across agents.
-
-```graphql
-type prompt_library {
-  id: ID!
-  name: String!
-  content: String!
-  tags: JSON          # string[]
-  category: String
-  description: String
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-**Example query:**
-
-```graphql
-query {
-  prompt_libraryPagination(
-    filters: [
-      { tags: { contains: ["support", "greeting"] } }
-    ]
-  ) {
-    items {
-      id
-      name
-      content
-      tags
-    }
-  }
-}
-```
-
-## prompt_favorites
-
-User's favorited prompts.
-
-```graphql
-type prompt_favorites {
-  id: ID!
-  user: ID!
-  prompt: ID!
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-## Usage
-
-The prompt library allows teams to:
-
-- **Share prompts** across multiple agents
-- **Organize prompts** with tags and categories
-- **Version control** prompt templates
-- **Favorite prompts** for quick access
-
-## Example: Creating a Reusable Prompt
-
-```graphql
-mutation {
-  prompt_libraryCreateOne(
-    input: {
-      name: "Customer Greeting"
-      content: "Hello! I'm here to help you with {{topic}}. What can I assist you with today?"
-      tags: ["greeting", "support", "customer-service"]
-      category: "support"
-      description: "Standard greeting for customer support agents"
-    }
-  ) {
-    item {
-      id
-      name
-    }
-  }
-}
-```
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent system instructions
-  </Card>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    User favorites
-  </Card>
-  <Card title="RBAC Types" icon="shield" href="/api-reference/core-types/rbac-types">
-    Prompt access control
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>

package/mintlify-docs/api-reference/core-types/rbac-types.mdx

@@ -1,163 +0,0 @@
----
-title: 'RBAC'
-description: 'GraphQL types for role-based access control'
----
-
-## RBACData
-
-Access control information for resources.
-
-```graphql
-type RBACData {
-  type: String!       # "public" | "private" | "users" | "roles"
-  users: [RBACUser!]
-  roles: [RBACRole!]
-}
-
-type RBACUser {
-  id: ID!
-  rights: String!     # "read" | "write"
-}
-
-type RBACRole {
-  id: ID!
-  rights: String!     # "read" | "write"
-}
-```
-
-## RBACInput
-
-Input type for setting RBAC permissions.
-
-```graphql
-input RBACInput {
-  users: [RBACUserInput!]
-  roles: [RBACRoleInput!]
-}
-
-input RBACUserInput {
-  id: ID!
-  rights: String!     # "read" | "write"
-}
-
-input RBACRoleInput {
-  id: ID!
-  rights: String!     # "read" | "write"
-}
-```
-
-## RBAC Modes
-
-### Public Mode
-
-Resource is accessible to all authenticated users:
-
-```graphql
-{
-  RBAC: {
-    type: "public"
-  }
-}
-```
-
-### Private Mode
-
-Resource is only accessible to creator:
-
-```graphql
-{
-  RBAC: {
-    type: "private"
-  }
-}
-```
-
-### User-Based Access
-
-Grant specific users access:
-
-```graphql
-mutation {
-  agentsCreateOne(
-    input: {
-      name: "Private Agent"
-      RBAC: {
-        users: [
-          { id: "user-123", rights: "write" }
-          { id: "user-456", rights: "read" }
-        ]
-      }
-    }
-  ) {
-    item {
-      id
-      RBAC {
-        type
-        users {
-          id
-          rights
-        }
-      }
-    }
-  }
-}
-```
-
-### Role-Based Access
-
-Grant role-based access:
-
-```graphql
-mutation {
-  agentsUpdateOneById(
-    id: "agent-123"
-    input: {
-      RBAC: {
-        roles: [
-          { id: "developer", rights: "write" }
-          { id: "viewer", rights: "read" }
-        ]
-      }
-    }
-  ) {
-    item {
-      id
-      RBAC {
-        roles {
-          id
-          rights
-        }
-      }
-    }
-  }
-}
-```
-
-## Permission Rights
-
-- **read** - Can view the resource
-- **write** - Can view and modify the resource
-
-## RBAC Hierarchy
-
-1. **super_admin** - Full access to all resources
-2. **Role permissions** - Access based on user's role
-3. **Resource RBAC** - Specific resource-level permissions
-4. **Creator** - Special access for resource creator
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    Users and roles
-  </Card>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent access control
-  </Card>
-  <Card title="Session Types" icon="comments" href="/api-reference/core-types/session-types">
-    Session access control
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>

package/mintlify-docs/api-reference/core-types/session-types.mdx

@@ -1,77 +0,0 @@
----
-title: 'Sessions'
-description: 'GraphQL types for conversation sessions and messages'
----
-
-## agent_sessions
-
-Conversation sessions between users and agents.
-
-```graphql
-type agent_sessions {
-  id: ID!
-  agent: ID!
-  user: ID
-  name: String
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-**Example query:**
-
-```graphql
-query {
-  agent_sessionsPagination(
-    limit: 20
-    filters: [{ agent: { eq: "agent-123" } }]
-  ) {
-    items {
-      id
-      name
-      createdAt
-    }
-  }
-}
-```
-
-## agent_messages
-
-Individual messages within a session.
-
-```graphql
-type agent_messages {
-  id: ID!
-  session: ID!
-  role: String!       # "user" | "assistant" | "system"
-  content: String!
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-## Usage
-
-Sessions track conversation history between users and agents. Each session contains multiple messages with different roles:
-
-- **user** - Messages from the user
-- **assistant** - Responses from the AI agent
-- **system** - System instructions or context
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent configurations
-  </Card>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    User accounts
-  </Card>
-  <Card title="RBAC Types" icon="shield" href="/api-reference/core-types/rbac-types">
-    Session access control
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>

package/mintlify-docs/api-reference/core-types/user-management.mdx

@@ -1,112 +0,0 @@
----
-title: 'Users'
-description: 'GraphQL types for users, roles, and authentication'
----
-
-## user
-
-User accounts for authentication and access control.
-
-```graphql
-type user {
-  id: Int!
-  name: String
-  email: String!
-  emailVerified: Date
-  image: String
-  password: String
-  type: String        # "api" | "user"
-  apikey: String
-  role: ID
-  super_admin: Boolean
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-**Example query:**
-
-```graphql
-query {
-  usersPagination(
-    filters: [{ type: { eq: "user" } }]
-  ) {
-    items {
-      id
-      name
-      email
-      role
-      super_admin
-    }
-  }
-}
-```
-
-<Warning>
-  The `password` and `apikey` fields are write-only for security. They are hashed with bcrypt and cannot be retrieved.
-</Warning>
-
-## role
-
-Role definitions for RBAC.
-
-```graphql
-type role {
-  id: ID!
-  name: String!
-  agents: String      # "read" | "write"
-  evals: String
-  workflows: String
-  variables: String
-  users: String
-  api: String
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-**Example mutation:**
-
-```graphql
-mutation {
-  rolesCreateOne(
-    input: {
-      name: "Developer"
-      agents: "write"
-      evals: "write"
-      workflows: "read"
-      variables: "read"
-      users: "read"
-    }
-  ) {
-    item {
-      id
-      name
-    }
-  }
-}
-```
-
-## Permission Levels
-
-Roles support two permission levels for each resource type:
-
-- **read** - View resources
-- **write** - View and modify resources
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="RBAC Types" icon="shield" href="/api-reference/core-types/rbac-types">
-    Resource-level access control
-  </Card>
-  <Card title="Session Types" icon="comments" href="/api-reference/core-types/session-types">
-    User conversation sessions
-  </Card>
-  <Card title="Analytics" icon="chart-bar" href="/api-reference/core-types/analytics-types">
-    User activity statistics
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>

package/mintlify-docs/api-reference/core-types/workflow-types.mdx

@@ -1,88 +0,0 @@
----
-title: 'Workflows'
-description: 'GraphQL types for multi-step agent workflows'
----
-
-## workflow_templates
-
-Workflow definitions with agent execution steps.
-
-```graphql
-type workflow_templates {
-  id: ID!
-  name: String!
-  description: String
-  agent: ID!
-  steps_json: JSON
-  variables: [String]     # Extracted from steps_json
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-**Example query:**
-
-```graphql
-query {
-  workflow_templateById(id: "workflow-123") {
-    id
-    name
-    agent
-    variables
-  }
-}
-```
-
-## Workflow Execution
-
-Workflows are executed through mutations with variable substitution:
-
-```graphql
-mutation {
-  runWorkflow(
-    id: "workflow-123"
-    variables: {
-      customerName: "John Doe"
-      orderId: "12345"
-    }
-  ) {
-    result
-    job
-    metadata
-  }
-}
-```
-
-## Workflow Scheduling
-
-Workflows can be scheduled with cron expressions:
-
-```graphql
-mutation {
-  upsertWorkflowSchedule(
-    workflow: "workflow-123"
-    schedule: "0 9 * * *"  # Daily at 9 AM
-  ) {
-    status
-    job
-  }
-}
-```
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agents executing workflows
-  </Card>
-  <Card title="Job Types" icon="gears" href="/api-reference/core-types/job-types">
-    Background workflow execution
-  </Card>
-  <Card title="Configuration" icon="gear" href="/api-reference/core-types/configuration-types">
-    Workflow variables
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>