@exulu/backend 1.48.1 → 1.49.0

package/mintlify-docs/README.md

@@ -1,55 +0,0 @@
-# Mintlify Starter Kit
-
-Use the starter kit to get your docs deployed and ready to customize.
-
-Click the green **Use this template** button at the top of this repo to copy the Mintlify starter kit. The starter kit contains examples with
-
-- Guide pages
-- Navigation
-- Customizations
-- API reference pages
-- Use of popular components
-
-**[Follow the full quickstart guide](https://starter.mintlify.com/quickstart)**
-
-## AI-assisted writing
-
-Set up your AI coding tool to work with Mintlify:
-
-```bash
-npx skills add https://mintlify.com/docs
-```
-
-This command installs Mintlify's documentation skill for your configured AI tools like Claude Code, Cursor, Windsurf, and others. The skill includes component reference, writing standards, and workflow guidance.
-
-See the [AI tools guides](/ai-tools) for tool-specific setup.
-
-## Development
-
-Install the [Mintlify CLI](https://www.npmjs.com/package/mint) to preview your documentation changes locally. To install, use the following command:
-
-```
-npm i -g mint
-```
-
-Run the following command at the root of your documentation, where your `docs.json` is located:
-
-```
-mint dev
-```
-
-View your local preview at `http://localhost:3000`.
-
-## Publishing changes
-
-Install our GitHub app from your [dashboard](https://dashboard.mintlify.com/settings/organization/github-app) to propagate changes from your repo to your deployment. Changes are deployed to production automatically after pushing to the default branch.
-
-## Need help?
-
-### Troubleshooting
-
-- If your dev environment isn't running: Run `mint update` to ensure you have the most recent version of the CLI.
-- If a page loads as a 404: Make sure you are running in a folder with a valid `docs.json`.
-
-### Resources
-- [Mintlify documentation](https://mintlify.com/docs)

package/mintlify-docs/ai-tools/claude-code.mdx

@@ -1,43 +0,0 @@
----
-title: "Claude Code setup"
-description: "Configure Claude Code for your documentation workflow"
-icon: "asterisk"
----
-
-Set up Claude Code to help you write and maintain your Mintlify documentation.
-
-## Prerequisites
-
-- Active Claude subscription (Pro, Max, or API access)
-
-## Setup
-
-<Steps>
-<Step title="Install Claude Code">
-  ```bash
-  npm install -g @anthropic-ai/claude-code
-  ```
-</Step>
-
-<Step title="Install the Mintlify skill">
-  In your docs directory, run:
-
-  ```bash
-  npx skills add https://mintlify.com/docs
-  ```
-
-  This gives Claude Code Mintlify's component reference, writing standards,
-  and workflow guidance.
-</Step>
-
-<Step title="Customize project instructions">
-  Edit `AGENTS.md` in your project root to add project-specific terminology,
-  style preferences, and content boundaries.
-</Step>
-
-<Step title="Start writing with Claude Code">
-  ```bash
-  claude
-  ```
-</Step>
-</Steps>

package/mintlify-docs/ai-tools/cursor.mdx

@@ -1,39 +0,0 @@
----
-title: "Cursor setup"
-description: "Configure Cursor for your documentation workflow"
-icon: "arrow-pointer"
----
-
-Set up Cursor to help you write and maintain your Mintlify documentation.
-
-## Prerequisites
-
-- Cursor editor installed
-
-## Setup
-
-<Steps>
-<Step title="Open your docs directory in Cursor">
-  Open the root of your documentation repository where `docs.json` is located.
-</Step>
-
-<Step title="Install the Mintlify skill">
-  In the integrated terminal, run:
-
-  ```bash
-  npx skills add https://mintlify.com/docs
-  ```
-
-  This gives Cursor Mintlify's component reference, writing standards,
-  and workflow guidance.
-</Step>
-
-<Step title="Customize project instructions">
-  Edit `AGENTS.md` in your project root to add project-specific terminology,
-  style preferences, and content boundaries.
-</Step>
-
-<Step title="Start writing with Cursor">
-  Open a file and use Cursor's AI features to draft and edit documentation.
-</Step>
-</Steps>

package/mintlify-docs/ai-tools/windsurf.mdx

@@ -1,39 +0,0 @@
----
-title: "Windsurf setup"
-description: "Configure Windsurf for your documentation workflow"
-icon: "water"
----
-
-Set up Windsurf's Cascade AI assistant to help you write and maintain your Mintlify documentation.
-
-## Prerequisites
-
-- Windsurf editor installed
-
-## Setup
-
-<Steps>
-<Step title="Open your docs directory in Windsurf">
-  Open the root of your documentation repository where `docs.json` is located.
-</Step>
-
-<Step title="Install the Mintlify skill">
-  In the integrated terminal, run:
-
-  ```bash
-  npx skills add https://mintlify.com/docs
-  ```
-
-  This gives Windsurf Mintlify's component reference, writing standards,
-  and workflow guidance.
-</Step>
-
-<Step title="Customize project instructions">
-  Edit `AGENTS.md` in your project root to add project-specific terminology,
-  style preferences, and content boundaries.
-</Step>
-
-<Step title="Start writing with Cascade">
-  Open a file and use Cascade to draft and edit documentation.
-</Step>
-</Steps>

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

@@ -1,110 +0,0 @@
----
-title: 'Agents'
-description: 'GraphQL types for AI agent configurations and capabilities'
----
-
-## agent
-
-AI agent configurations and instances.
-
-```graphql
-type agent {
-  id: ID!
-  name: String!
-  description: String
-  backend: String!
-  type: String!
-  createdAt: Date!
-  updatedAt: Date!
-
-  # Backend-specific fields
-  provider: String
-  providerName: String
-  modelName: String
-  systemInstructions: String
-  authenticationInformation: String
-
-  # Configuration
-  rateLimit: RateLimiterRule
-  streaming: Boolean
-  capabilities: AgentCapabilities
-  maxContextLength: Int
-
-  # Workflows
-  workflows: AgentWorkflows
-
-  # Access control (if RBAC enabled)
-  RBAC: RBACData
-
-  # Routing
-  slug: String
-}
-```
-
-**Example query:**
-
-```graphql
-query {
-  agentById(id: "agent-123") {
-    id
-    name
-    provider
-    modelName
-    capabilities {
-      text
-      images
-      files
-    }
-    workflows {
-      enabled
-      queue {
-        name
-      }
-    }
-  }
-}
-```
-
-## AgentCapabilities
-
-Defines what content types the agent can process.
-
-```graphql
-type AgentCapabilities {
-  text: Boolean
-  images: [String]    # e.g., [".png", ".jpg"]
-  files: [String]     # e.g., [".pdf", ".docx"]
-  audio: [String]
-  video: [String]
-}
-```
-
-## RateLimiterRule
-
-Rate limiting configuration for agent requests.
-
-```graphql
-type RateLimiterRule {
-  name: String
-  rate_limit: RateLimiterRuleRateLimit
-}
-
-type RateLimiterRuleRateLimit {
-  time: Int    # Time window in seconds
-  limit: Int   # Max requests per time window
-}
-```
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Session Types" icon="comments" href="/api-reference/core-types/session-types">
-    Agent sessions and messages
-  </Card>
-  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
-    Agent workflow configurations
-  </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/analytics-types.mdx

@@ -1,95 +0,0 @@
----
-title: 'Analytics'
-description: 'GraphQL types for usage statistics and reporting'
----
-
-## statistics
-
-Usage statistics and analytics.
-
-```graphql
-type statistics {
-  id: ID!
-  name: String!
-  label: String!
-  type: String!
-  trigger: String!
-  count: Int!
-  user: ID
-  role: ID
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-## Aggregate Statistics
-
-Query aggregate statistics with grouping:
-
-```graphql
-query {
-  statisticsStatistics(
-    groupBy: "label"
-    filters: [
-      { type: { eq: "agent_run" } }
-    ]
-    limit: 10
-  ) {
-    group
-    count
-  }
-}
-```
-
-## Common Statistics Types
-
-- **agent_run** - Agent execution count
-- **api_call** - API request count
-- **workflow_execution** - Workflow run count
-- **eval_run** - Evaluation execution count
-- **context_search** - Vector search count
-
-## Usage Analytics
-
-Statistics track usage across:
-
-- **Per user** - Track individual user activity
-- **Per role** - Aggregate by role
-- **Per resource** - Track specific agents, workflows, etc.
-- **Time-based** - Query by date ranges
-
-## Example: Agent Usage Report
-
-```graphql
-query {
-  statisticsStatistics(
-    groupBy: "label"
-    filters: [
-      {
-        type: { eq: "agent_run" }
-        createdAt: { gte: "2025-01-01T00:00:00Z" }
-      }
-    ]
-  ) {
-    group  # Agent name
-    count  # Number of executions
-  }
-}
-```
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    User and role statistics
-  </Card>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent usage tracking
-  </Card>
-  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
-    Workflow execution stats
-  </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/configuration-types.mdx

@@ -1,83 +0,0 @@
----
-title: 'Configuration'
-description: 'GraphQL types for encrypted variables and project organization'
----
-
-## variables
-
-Encrypted configuration values (alternative to .env files).
-
-```graphql
-type variables {
-  id: ID!
-  name: String!
-  value: String!
-  encrypted: Boolean!
-  description: String
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-<Note>
-  Values are encrypted with AES using `NEXTAUTH_SECRET`. Use [`ExuluVariables.get()`](/core/exulu-variables/api-reference#get) to retrieve decrypted values.
-</Note>
-
-**Example usage:**
-
-```graphql
-mutation {
-  variablesCreateOne(
-    input: {
-      name: "openai_api_key"
-      value: "sk-..."
-      encrypted: true
-      description: "OpenAI API key for production"
-    }
-  ) {
-    item {
-      id
-      name
-    }
-  }
-}
-```
-
-## projects
-
-Project organization for grouping resources.
-
-```graphql
-type projects {
-  id: ID!
-  name: String!
-  description: String
-  createdAt: Date!
-  updatedAt: Date!
-}
-```
-
-Projects provide a way to organize related resources for better management and organization.
-
-## Security
-
-<Warning>
-  Variable values are write-only. Once encrypted, they cannot be retrieved through GraphQL - use the ExuluVariables API instead.
-</Warning>
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
-    Workflow variables
-  </Card>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agent configuration
-  </Card>
-  <Card title="User Management" icon="users" href="/api-reference/core-types/user-management">
-    Access permissions
-  </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/evaluation-types.mdx

@@ -1,106 +0,0 @@
----
-title: 'Evaluations'
-description: 'GraphQL types for testing and evaluating agent performance'
----
-
-## test_cases
-
-Test cases for evaluating agent performance.
-
-```graphql
-type test_cases {
-  id: ID!
-  name: String!
-  description: String
-  inputs: JSON!                           # UIMessage[]
-  expected_output: String!
-  expected_tools: JSON                    # string[]
-  expected_knowledge_sources: JSON        # string[]
-  expected_agent_tools: JSON              # string[]
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-**Example:**
-
-```graphql
-mutation {
-  test_casesCreateOne(
-    input: {
-      name: "Weather Query"
-      description: "User asks about weather"
-      inputs: [
-        { role: "user", content: "What's the weather like?" }
-      ]
-      expected_output: "Based on current data, it's 68°F and sunny."
-      expected_tools: ["get_weather"]
-    }
-  ) {
-    item {
-      id
-      name
-    }
-  }
-}
-```
-
-## eval_sets
-
-Collections of test cases for batch evaluation.
-
-```graphql
-type eval_sets {
-  id: ID!
-  name: String!
-  description: String
-  test_case_ids: JSON       # string[]
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-## eval_runs
-
-Evaluation execution records.
-
-```graphql
-type eval_runs {
-  id: ID!
-  name: String!
-  description: String
-  agent_id: ID!
-  test_case_ids: JSON           # string[]
-  eval_functions: JSON          # string[]
-  config: JSON
-  scoring_method: String
-  pass_threshold: Float
-  timeout_in_seconds: Int
-  createdAt: Date!
-  updatedAt: Date!
-  RBAC: RBACData
-}
-```
-
-## Evaluation Workflow
-
-1. Create **test_cases** with expected inputs and outputs
-2. Group test cases into **eval_sets** for organized testing
-3. Run **eval_runs** to evaluate agent performance
-4. Review results and iterate on agent improvements
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Agent Types" icon="robot" href="/api-reference/core-types/agent-types">
-    Agents being evaluated
-  </Card>
-  <Card title="Job Types" icon="gears" href="/api-reference/core-types/job-types">
-    Background eval execution
-  </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/job-types.mdx

@@ -1,135 +0,0 @@
----
-title: 'Job Management'
-description: 'GraphQL types for background job tracking with BullMQ'
----
-
-## Job
-
-Background job information from BullMQ.
-
-```graphql
-type Job {
-  id: String!
-  name: String!
-  returnvalue: JSON
-  stacktrace: [String]
-  finishedOn: Date
-  processedOn: Date
-  attemptsMade: Int
-  failedReason: String
-  state: String!
-  data: JSON
-  timestamp: Date
-}
-```
-
-## Query Jobs
-
-**By queue and status:**
-
-```graphql
-query {
-  jobs(
-    queue: eval_runs
-    statusses: [active, waiting, failed]
-    page: 1
-    limit: 50
-  ) {
-    items {
-      id
-      name
-      state
-      failedReason
-    }
-  }
-}
-```
-
-## Job States
-
-- **waiting** - Job is queued
-- **active** - Job is currently processing
-- **completed** - Job finished successfully
-- **failed** - Job failed with error
-- **delayed** - Job is scheduled for later
-- **paused** - Queue is paused
-
-## Queue Information
-
-Get detailed queue status:
-
-```graphql
-query {
-  queue(queue: eval_runs) {
-    name
-    concurrency {
-      worker
-      queue
-    }
-    timeoutInSeconds
-    ratelimit
-    isMaxed
-    isPaused
-    jobs {
-      paused
-      completed
-      failed
-      waiting
-      active
-      delayed
-    }
-  }
-}
-```
-
-## Queue Management
-
-Manage queue operations:
-
-```graphql
-mutation {
-  # Pause a queue
-  pauseQueue(queue: eval_runs) {
-    success
-  }
-
-  # Resume a queue
-  resumeQueue(queue: eval_runs) {
-    success
-  }
-
-  # Drain waiting jobs
-  drainQueue(queue: eval_runs) {
-    success
-  }
-
-  # Delete a specific job
-  deleteJob(queue: eval_runs, id: "job-123") {
-    success
-  }
-}
-```
-
-## Common Queues
-
-- **eval_runs** - Evaluation execution
-- **chunk_generation** - Vector embedding generation
-- **workflow_execution** - Workflow runs
-- **context_processing** - Context data processing
-
-## Related Types
-
-<CardGroup cols={2}>
-  <Card title="Evaluation Types" icon="chart-line" href="/api-reference/core-types/evaluation-types">
-    Eval run jobs
-  </Card>
-  <Card title="Workflow Types" icon="workflow" href="/api-reference/core-types/workflow-types">
-    Workflow execution jobs
-  </Card>
-  <Card title="Dynamic Types" icon="wand-magic-sparkles" href="/api-reference/dynamic-types">
-    Context chunk jobs
-  </Card>
-  <Card title="Back to Overview" icon="arrow-left" href="/api-reference/core-types/overview">
-    View all core types
-  </Card>
-</CardGroup>