plugin-ai-api 1.0.2 → 1.0.4

package/src/server/utils/openai-format.ts

@@ -0,0 +1,142 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import crypto from 'crypto';
+
+// ─── Model string parsing ───
+
+export interface ParsedModel {
+  llmService: string;
+  modelId: string;
+}
+
+/**
+ * Parse OpenAI-style model string into NocoBase llmService + modelId.
+ * Format: "llmServiceName/modelId" (e.g. "my-openai/gpt-4o")
+ * If no "/" is present, the entire string is treated as modelId and llmService is empty.
+ */
+export function parseModelString(model: string): ParsedModel {
+  const slashIndex = model.indexOf('/');
+  if (slashIndex === -1) {
+    return { llmService: '', modelId: model };
+  }
+  return {
+    llmService: model.substring(0, slashIndex),
+    modelId: model.substring(slashIndex + 1),
+  };
+}
+
+// ─── ID generation ───
+
+export function generateCompletionId(): string {
+  return `chatcmpl-${crypto.randomBytes(16).toString('hex').substring(0, 29)}`;
+}
+
+// ─── OpenAI error format ───
+
+export function toOpenAIError(statusCode: number, message: string, type = 'invalid_request_error', code?: string) {
+  return {
+    error: {
+      message,
+      type,
+      param: null,
+      code: code || null,
+    },
+  };
+}
+
+// ─── OpenAI Chat Completion response (non-streaming) ───
+
+export function toOpenAIResponse(options: {
+  id: string;
+  model: string;
+  content: string;
+  finishReason?: string;
+  usage?: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number };
+}) {
+  const { id, model, content, finishReason = 'stop', usage } = options;
+  return {
+    id,
+    object: 'chat.completion',
+    created: Math.floor(Date.now() / 1000),
+    model,
+    system_fingerprint: null,
+    choices: [
+      {
+        index: 0,
+        message: {
+          role: 'assistant',
+          content,
+        },
+        logprobs: null,
+        finish_reason: finishReason,
+      },
+    ],
+    usage: usage || { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+  };
+}
+
+// ─── OpenAI Streaming chunk format ───
+
+export function toOpenAIStreamChunk(options: {
+  id: string;
+  model: string;
+  delta: { role?: string; content?: string };
+  finishReason?: string | null;
+}) {
+  const { id, model, delta, finishReason = null } = options;
+  return {
+    id,
+    object: 'chat.completion.chunk',
+    created: Math.floor(Date.now() / 1000),
+    model,
+    system_fingerprint: null,
+    choices: [
+      {
+        index: 0,
+        delta,
+        logprobs: null,
+        finish_reason: finishReason,
+      },
+    ],
+  };
+}
+
+// ─── OpenAI Embeddings response ───
+
+export function toOpenAIEmbeddingsResponse(options: { model: string; embeddings: number[][]; promptTokens?: number }) {
+  const { model, embeddings, promptTokens = 0 } = options;
+  return {
+    object: 'list' as const,
+    data: embeddings.map((embedding, index) => ({
+      object: 'embedding' as const,
+      embedding,
+      index,
+    })),
+    model,
+    usage: {
+      prompt_tokens: promptTokens,
+      total_tokens: promptTokens,
+    },
+  };
+}
+
+/**
+ * Format a streaming chunk as an SSE data line.
+ */
+export function formatSSE(data: any): string {
+  return `data: ${JSON.stringify(data)}\n\n`;
+}
+
+/**
+ * Format the terminal SSE [DONE] signal.
+ */
+export function formatSSEDone(): string {
+  return `data: [DONE]\n\n`;
+}

package/src/server/utils/rate-limiter.ts

@@ -0,0 +1,83 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+/**
+ * In-memory sliding window rate limiter.
+ *
+ * Stores per-user request timestamps. On each check: prunes timestamps
+ * older than the window, counts the remainder, and accepts/rejects.
+ *
+ * Single-process safe (Node.js event loop). Not distributed.
+ * For multi-process deployments, replace with a Redis-backed implementation.
+ */
+export class RateLimiter {
+  /** Map<userId, sorted array of request timestamps in ms> */
+  private readonly store = new Map<string | number, number[]>();
+
+  constructor(private readonly windowMs = 60_000) {}
+
+  /**
+   * Check and record a request for a user.
+   *
+   * @param userId  The user ID (string or numeric)
+   * @param limit   Max allowed requests per window (from aiApiConfig.rateLimitPerMinute)
+   * @returns { allowed: true } or { allowed: false, retryAfterMs: number }
+   */
+  check(userId: string | number, limit: number): { allowed: true } | { allowed: false; retryAfterMs: number } {
+    const now = Date.now();
+    const windowStart = now - this.windowMs;
+
+    let timestamps = this.store.get(userId);
+    if (!timestamps) {
+      timestamps = [];
+      this.store.set(userId, timestamps);
+    }
+
+    // Binary-search prune: drop all timestamps before the window start.
+    // O(log n + k) vs O(n) for a simple filter.
+    let lo = 0,
+      hi = timestamps.length;
+    while (lo < hi) {
+      const mid = (lo + hi) >>> 1;
+      if (timestamps[mid] < windowStart) {
+        lo = mid + 1;
+      } else {
+        hi = mid;
+      }
+    }
+    if (lo > 0) timestamps.splice(0, lo);
+
+    if (timestamps.length >= limit) {
+      // retryAfterMs is the time until the oldest request falls out of the window
+      const retryAfterMs = Math.max(0, timestamps[0] + this.windowMs - now);
+      return { allowed: false, retryAfterMs };
+    }
+
+    timestamps.push(now);
+    return { allowed: true };
+  }
+
+  /**
+   * Garbage collect entries for inactive users.
+   * Call every ~5 minutes to prevent unbounded memory growth in long-running servers.
+   */
+  gc(): void {
+    const cutoff = Date.now() - this.windowMs;
+    for (const [userId, timestamps] of this.store) {
+      if (!timestamps.length || timestamps[timestamps.length - 1] < cutoff) {
+        this.store.delete(userId);
+      }
+    }
+  }
+
+  /** Clear all state (useful in tests). */
+  clear(): void {
+    this.store.clear();
+  }
+}

package/src/server/utils/resolve-service.ts

@@ -0,0 +1,82 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { Context } from '@nocobase/actions';
+
+/**
+ * Resolve an LLM service by name or title.
+ */
+export async function resolveLlmService(ctx: Context, serviceKey: string) {
+  const repo = ctx.db.getRepository('llmServices');
+
+  let service = await repo.findOne({ filter: { name: serviceKey } });
+  if (!service) {
+    service = await repo.findOne({ filter: { title: serviceKey } });
+  }
+  return service;
+}
+
+/**
+ * Resolve a model string to a service + modelId.
+ *
+ * Strategy (priority order):
+ * 1. Try splitting at each "/" position and match the left part against DB (name or title).
+ *    This handles cases like "Custom LLM (OpenAI Compatible)/qwen/qwen3.6-plus-preview:free"
+ * 2. If no service match, use the defaultLlmService from config and treat the ENTIRE
+ *    model string as the modelId. This allows clients to send just "qwen/qwen3.6-plus-preview:free"
+ *    or "gpt-4o" without knowing the service name.
+ */
+export async function resolveModelString(
+  ctx: Context,
+  modelString: string,
+): Promise<{ service: any; modelId: string } | null> {
+  const repo = ctx.db.getRepository('llmServices');
+
+  // ─── Strategy 1: Try splitting at "/" positions ───
+  const slashPositions: number[] = [];
+  for (let i = 0; i < modelString.length; i++) {
+    if (modelString[i] === '/') {
+      slashPositions.push(i);
+    }
+  }
+
+  if (slashPositions.length > 0) {
+    for (const pos of slashPositions) {
+      const serviceKey = modelString.substring(0, pos);
+      const modelId = modelString.substring(pos + 1);
+      if (!serviceKey || !modelId) continue;
+
+      let service = await repo.findOne({ filter: { name: serviceKey } });
+      if (!service) {
+        service = await repo.findOne({ filter: { title: serviceKey } });
+      }
+
+      if (service) {
+        return { service, modelId };
+      }
+    }
+  }
+
+  // ─── Strategy 2: Use default LLM service from config ───
+  const config = await ctx.db.getRepository('aiApiConfig').findOne();
+  if (config?.defaultLlmService) {
+    const service = await repo.findOne({ filter: { name: config.defaultLlmService } });
+    if (service) {
+      return { service, modelId: modelString };
+    }
+  }
+
+  // ─── Strategy 3: If only one service enabled, use it ───
+  const enabledServices = await repo.find({ filter: { enabled: true } });
+  if (enabledServices.length === 1) {
+    return { service: enabledServices[0], modelId: modelString };
+  }
+
+  return null;
+}

package/src/swagger.ts

@@ -0,0 +1,325 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+export default {
+  info: {
+    title: 'NocoBase API - AI API Plugin',
+    description: 'OpenAI-compatible AI gateway and configuration API',
+  },
+  tags: [
+    { name: 'aiApiConfig', description: 'AI API configuration management' },
+    { name: 'ai-llm', description: 'OpenAI-compatible LLM gateway (prefix: /api/ai-llm/v1)' },
+  ],
+  paths: {
+    '/aiApiConfig:get': {
+      get: {
+        tags: ['aiApiConfig'],
+        summary: 'Get AI API configuration',
+        security: [{ BearerAuth: [] }],
+        responses: {
+          200: {
+            description: 'Current AI API configuration',
+            content: {
+              'application/json': {
+                schema: { $ref: '#/components/schemas/AiApiConfig' },
+              },
+            },
+          },
+        },
+      },
+    },
+    '/aiApiConfig:save': {
+      post: {
+        tags: ['aiApiConfig'],
+        summary: 'Save AI API configuration',
+        security: [{ BearerAuth: [] }],
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: { $ref: '#/components/schemas/AiApiConfig' },
+            },
+          },
+        },
+        responses: {
+          200: { description: 'Configuration saved successfully' },
+        },
+      },
+    },
+    '/ai-llm/v1/models': {
+      get: {
+        tags: ['ai-llm'],
+        summary: 'List available models',
+        description:
+          'Returns all LLM models available across registered services. Model IDs are formatted as `serviceName/modelId`.',
+        security: [{ BearerAuth: [] }],
+        responses: {
+          200: {
+            description: 'List of available models',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    object: { type: 'string', example: 'list' },
+                    data: {
+                      type: 'array',
+                      items: { $ref: '#/components/schemas/ModelObject' },
+                    },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    '/ai-llm/v1/models/{id}': {
+      get: {
+        tags: ['ai-llm'],
+        summary: 'Get model details',
+        security: [{ BearerAuth: [] }],
+        parameters: [
+          {
+            name: 'id',
+            in: 'path',
+            required: true,
+            description: 'Model ID in format `serviceName/modelId`',
+            schema: { type: 'string', example: 'openai/gpt-4o' },
+          },
+        ],
+        responses: {
+          200: {
+            description: 'Model details',
+            content: {
+              'application/json': {
+                schema: { $ref: '#/components/schemas/ModelObject' },
+              },
+            },
+          },
+          404: { description: 'Model not found' },
+        },
+      },
+    },
+    '/ai-llm/v1/chat/completions': {
+      post: {
+        tags: ['ai-llm'],
+        summary: 'Chat completions',
+        description:
+          'OpenAI-compatible chat completions endpoint. Supports streaming (`stream: true`). Use header `X-AI-Mode: llm` (default) or `X-AI-Mode: agent` to switch between direct LLM and agent mode.',
+        security: [{ BearerAuth: [] }],
+        parameters: [
+          {
+            name: 'X-AI-Mode',
+            in: 'header',
+            required: false,
+            description: 'AI mode: `llm` (default) or `agent`',
+            schema: { type: 'string', enum: ['llm', 'agent'], default: 'llm' },
+          },
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: { $ref: '#/components/schemas/ChatCompletionRequest' },
+            },
+          },
+        },
+        responses: {
+          200: {
+            description: 'Chat completion response (or SSE stream when `stream: true`)',
+            content: {
+              'application/json': {
+                schema: { $ref: '#/components/schemas/ChatCompletionResponse' },
+              },
+              'text/event-stream': {
+                schema: { type: 'string', description: 'SSE stream of completion chunks' },
+              },
+            },
+          },
+          429: { description: 'Rate limit exceeded' },
+        },
+      },
+    },
+    '/ai-llm/v1/completions': {
+      post: {
+        tags: ['ai-llm'],
+        summary: 'Text completions (legacy)',
+        description: 'Legacy text completions for LiteLLM compatibility.',
+        security: [{ BearerAuth: [] }],
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: {
+                  model: { type: 'string' },
+                  prompt: { type: 'string' },
+                  max_tokens: { type: 'integer' },
+                  stream: { type: 'boolean', default: false },
+                },
+                required: ['model', 'prompt'],
+              },
+            },
+          },
+        },
+        responses: {
+          200: { description: 'Completion response' },
+          429: { description: 'Rate limit exceeded' },
+        },
+      },
+    },
+    '/ai-llm/v1/embeddings': {
+      post: {
+        tags: ['ai-llm'],
+        summary: 'Generate embeddings',
+        description: 'OpenAI-compatible embeddings endpoint.',
+        security: [{ BearerAuth: [] }],
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: {
+                  model: { type: 'string', example: 'openai/text-embedding-ada-002' },
+                  input: {
+                    oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],
+                  },
+                },
+                required: ['model', 'input'],
+              },
+            },
+          },
+        },
+        responses: {
+          200: {
+            description: 'Embedding vectors',
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'object',
+                  properties: {
+                    object: { type: 'string', example: 'list' },
+                    data: {
+                      type: 'array',
+                      items: {
+                        type: 'object',
+                        properties: {
+                          object: { type: 'string', example: 'embedding' },
+                          embedding: { type: 'array', items: { type: 'number' } },
+                          index: { type: 'integer' },
+                        },
+                      },
+                    },
+                    model: { type: 'string' },
+                    usage: {
+                      type: 'object',
+                      properties: {
+                        prompt_tokens: { type: 'integer' },
+                        total_tokens: { type: 'integer' },
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+          429: { description: 'Rate limit exceeded' },
+        },
+      },
+    },
+  },
+  components: {
+    schemas: {
+      AiApiConfig: {
+        type: 'object',
+        properties: {
+          mode: {
+            type: 'string',
+            enum: ['llm', 'agent'],
+            description: 'Default AI mode',
+          },
+          defaultAiEmployee: { type: 'string', description: 'Default AI employee name' },
+          defaultLlmService: { type: 'string', description: 'Default LLM service name' },
+          enabledLlmServices: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'List of enabled LLM service names',
+          },
+          rateLimitPerMinute: {
+            type: 'integer',
+            description: 'Max requests per minute per user (0 = unlimited)',
+          },
+        },
+      },
+      ModelObject: {
+        type: 'object',
+        properties: {
+          id: { type: 'string', example: 'openai/gpt-4o', description: 'Model ID (serviceName/modelId)' },
+          object: { type: 'string', example: 'model' },
+          created: { type: 'integer' },
+          owned_by: { type: 'string' },
+        },
+      },
+      ChatMessage: {
+        type: 'object',
+        properties: {
+          role: { type: 'string', enum: ['system', 'user', 'assistant', 'tool'] },
+          content: { type: 'string' },
+          name: { type: 'string' },
+        },
+        required: ['role', 'content'],
+      },
+      ChatCompletionRequest: {
+        type: 'object',
+        properties: {
+          model: { type: 'string', example: 'openai/gpt-4o' },
+          messages: { type: 'array', items: { $ref: '#/components/schemas/ChatMessage' } },
+          stream: { type: 'boolean', default: false },
+          temperature: { type: 'number', minimum: 0, maximum: 2 },
+          max_tokens: { type: 'integer' },
+          top_p: { type: 'number' },
+          frequency_penalty: { type: 'number' },
+          presence_penalty: { type: 'number' },
+        },
+        required: ['model', 'messages'],
+      },
+      ChatCompletionResponse: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          object: { type: 'string', example: 'chat.completion' },
+          created: { type: 'integer' },
+          model: { type: 'string' },
+          choices: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                index: { type: 'integer' },
+                message: { $ref: '#/components/schemas/ChatMessage' },
+                finish_reason: { type: 'string', enum: ['stop', 'length', 'tool_calls'] },
+              },
+            },
+          },
+          usage: {
+            type: 'object',
+            properties: {
+              prompt_tokens: { type: 'integer' },
+              completion_tokens: { type: 'integer' },
+              total_tokens: { type: 'integer' },
+            },
+          },
+        },
+      },
+    },
+  },
+};

package/dist/client/2c126424a58bcb27.js

@@ -1 +0,0 @@
-"use strict";(self.webpackChunkplugin_ai_api=self.webpackChunkplugin_ai_api||[]).push([["23"],{928:function(e,t,r){r.r(t),r.d(t,{AiApiRolePermissions:function(){return f}});var n=r(156),l=r.n(n),a=r(772),o=r(721);function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var r=0,n=Array(t);r<t;r++)n[r]=e[r];return n}function u(e,t,r,n,l,a,o){try{var i=e[a](o),u=i.value}catch(e){r(e);return}i.done?t(u):Promise.resolve(u).then(n,l)}function c(e){return function(){var t=this,r=arguments;return new Promise(function(n,l){var a=e.apply(t,r);function o(e){u(a,n,l,o,i,"next",e)}function i(e){u(a,n,l,o,i,"throw",e)}o(void 0)})}}function s(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},n=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(r).filter(function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable}))),n.forEach(function(t){var n;n=r[t],t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n})}return e}function p(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var r,n,l=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=l){var a=[],o=!0,i=!1;try{for(l=l.call(e);!(o=(r=l.next()).done)&&(a.push(r.value),!t||a.length!==t);o=!0);}catch(e){i=!0,n=e}finally{try{o||null==l.return||l.return()}finally{if(i)throw n}}return a}}(e,t)||function(e,t){if(e){if("string"==typeof e)return i(e,t);var r=Object.prototype.toString.call(e).slice(8,-1);if("Object"===r&&e.constructor&&(r=e.constructor.name),"Map"===r||"Set"===r)return Array.from(r);if("Arguments"===r||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(r))return i(e,t)}}(e,t)||function(){throw TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function d(e,t){var r,n,l,a,o={label:0,sent:function(){if(1&l[0])throw l[1];return l[1]},trys:[],ops:[]};return a={next:i(0),throw:i(1),return:i(2)},"function"==typeof Symbol&&(a[Symbol.iterator]=function(){return this}),a;function i(a){return function(i){var u=[a,i];if(r)throw TypeError("Generator is already executing.");for(;o;)try{if(r=1,n&&(l=2&u[0]?n.return:u[0]?n.throw||((l=n.return)&&l.call(n),0):n.next)&&!(l=l.call(n,u[1])).done)return l;switch(n=0,l&&(u=[2&u[0],l.value]),u[0]){case 0:case 1:l=u;break;case 4:return o.label++,{value:u[1],done:!1};case 5:o.label++,n=u[1],u=[0];continue;case 7:u=o.ops.pop(),o.trys.pop();continue;default:if(!(l=(l=o.trys).length>0&&l[l.length-1])&&(6===u[0]||2===u[0])){o=0;continue}if(3===u[0]&&(!l||u[1]>l[0]&&u[1]<l[3])){o.label=u[1];break}if(6===u[0]&&o.label<l[1]){o.label=l[1],l=u;break}if(l&&o.label<l[2]){o.label=l[2],o.ops.push(u);break}l[2]&&o.ops.pop(),o.trys.pop();continue}u=t.call(e,o)}catch(e){u=[6,e],n=0}finally{r=l=0}if(5&u[0])throw u[1];return{value:u[0]?u[1]:void 0,done:!0}}}}var m=o.Typography.Text;function f(e){var t,r,i=e.role,u=(0,a.useAPIClient)(),f=p((0,n.useState)(!0),2),y=f[0],b=f[1],h=p((0,n.useState)(!1),2),v=h[0],w=h[1],E=p((0,n.useState)([]),2),g=E[0],A=E[1],O=p((0,n.useState)(null),2),S=O[0],P=O[1],j=null==i?void 0:i.name;(0,n.useEffect)(function(){j&&k()},[j]);var k=(t=c(function(){var e,t,r,n,l,a,o;return d(this,function(i){switch(i.label){case 0:b(!0),i.label=1;case 1:return i.trys.push([1,3,4,5]),[4,Promise.all([u.request({url:"aiApiRolePermissions",params:{filter:{roleName:j},paginate:!1}}),u.request({url:"aiEmployees:list",params:{paginate:!1}})])];case 2:return l=(n=p.apply(void 0,[i.sent(),2]))[0],a=n[1],P((o=null==l||null==(t=l.data)||null==(e=t.data)?void 0:e[0])?{id:o.id,roleName:o.roleName,enabled:!!o.enabled,allowAllEmployees:!1!==o.allowAllEmployees,allowedEmployees:o.allowedEmployees||[]}:{roleName:j,enabled:!1,allowAllEmployees:!0,allowedEmployees:[]}),A(((null==a||null==(r=a.data)?void 0:r.data)||[]).map(function(e){return{username:e.username,nickname:e.nickname||e.username}})),[3,5];case 3:return console.error("Failed to load AI API role permissions:",i.sent()),[3,5];case 4:return b(!1),[7];case 5:return[2]}})}),function(){return t.apply(this,arguments)}),I=(r=c(function(e){var t,r,n,l;return d(this,function(a){switch(a.label){case 0:if(!S)return[2];P(t=s({},S,e)),w(!0),a.label=1;case 1:if(a.trys.push([1,6,7,8]),!t.id)return[3,3];return[4,u.request({url:"aiApiRolePermissions/".concat(t.id),method:"PUT",data:t})];case 2:return a.sent(),[3,5];case 3:return[4,u.request({url:"aiApiRolePermissions",method:"POST",data:t})];case 4:var o,i;(null==(l=null==(n=a.sent())||null==(r=n.data)?void 0:r.data)?void 0:l.id)&&P((o=s({},t),i=i={id:l.id},Object.getOwnPropertyDescriptors?Object.defineProperties(o,Object.getOwnPropertyDescriptors(i)):(function(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);r.push.apply(r,n)}return r})(Object(i)).forEach(function(e){Object.defineProperty(o,e,Object.getOwnPropertyDescriptor(i,e))}),o)),a.label=5;case 5:return[3,8];case 6:return console.error("Failed to save AI API role permissions:",a.sent()),P(S),[3,8];case 7:return w(!1),[7];case 8:return[2]}})}),function(e){return r.apply(this,arguments)});return y?l().createElement(o.Spin,null):l().createElement(o.Card,{bordered:!1},l().createElement(o.Space,{direction:"vertical",style:{width:"100%"},size:"middle"},l().createElement(o.Space,null,l().createElement(o.Switch,{checked:!!(null==S?void 0:S.enabled),loading:v,onChange:function(e){return I({enabled:e})}}),l().createElement(m,{strong:!0},"Allow this role to use the AI API")),(null==S?void 0:S.enabled)&&l().createElement(l().Fragment,null,l().createElement(o.Divider,{style:{margin:"8px 0"}}),l().createElement(o.Space,null,l().createElement(o.Switch,{checked:!!(null==S?void 0:S.allowAllEmployees),loading:v,onChange:function(e){return I({allowAllEmployees:e})}}),l().createElement(m,null,"Allow all AI Employees")),!(null==S?void 0:S.allowAllEmployees)&&l().createElement("div",null,l().createElement(m,{type:"secondary",style:{display:"block",marginBottom:8}},"Select which AI Employees this role may use:"),l().createElement(o.Select,{mode:"multiple",allowClear:!0,style:{width:"100%",maxWidth:480},placeholder:"Select allowed AI Employees",value:(null==S?void 0:S.allowedEmployees)||[],options:g.map(function(e){return{label:"".concat(e.nickname," (").concat(e.username,")"),value:e.username}}),onChange:function(e){return I({allowedEmployees:e})},disabled:v})))))}}}]);

package/dist/client/824c2f7487ee05fd.js

@@ -1 +0,0 @@
-"use strict";(self.webpackChunkplugin_ai_api=self.webpackChunkplugin_ai_api||[]).push([["503"],{968:function(e,t,n){n.r(t),n.d(t,{AiApiConfigPage:function(){return y}});var a=n(156),r=n.n(a),l=n(721),o=n(772);function i(e,t){(null==t||t>e.length)&&(t=e.length);for(var n=0,a=Array(t);n<t;n++)a[n]=e[n];return a}function c(e,t,n,a,r,l,o){try{var i=e[l](o),c=i.value}catch(e){n(e);return}i.done?t(c):Promise.resolve(c).then(a,r)}function u(e){return function(){var t=this,n=arguments;return new Promise(function(a,r){var l=e.apply(t,n);function o(e){c(l,a,r,o,i,"next",e)}function i(e){c(l,a,r,o,i,"throw",e)}o(void 0)})}}function s(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var n,a,r=null==e?null:"undefined"!=typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=r){var l=[],o=!0,i=!1;try{for(r=r.call(e);!(o=(n=r.next()).done)&&(l.push(n.value),!t||l.length!==t);o=!0);}catch(e){i=!0,a=e}finally{try{o||null==r.return||r.return()}finally{if(i)throw a}}return l}}(e,t)||function(e,t){if(e){if("string"==typeof e)return i(e,t);var n=Object.prototype.toString.call(e).slice(8,-1);if("Object"===n&&e.constructor&&(n=e.constructor.name),"Map"===n||"Set"===n)return Array.from(n);if("Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n))return i(e,t)}}(e,t)||function(){throw TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function m(e,t){var n,a,r,l,o={label:0,sent:function(){if(1&r[0])throw r[1];return r[1]},trys:[],ops:[]};return l={next:i(0),throw:i(1),return:i(2)},"function"==typeof Symbol&&(l[Symbol.iterator]=function(){return this}),l;function i(l){return function(i){var c=[l,i];if(n)throw TypeError("Generator is already executing.");for(;o;)try{if(n=1,a&&(r=2&c[0]?a.return:c[0]?a.throw||((r=a.return)&&r.call(a),0):a.next)&&!(r=r.call(a,c[1])).done)return r;switch(a=0,r&&(c=[2&c[0],r.value]),c[0]){case 0:case 1:r=c;break;case 4:return o.label++,{value:c[1],done:!1};case 5:o.label++,a=c[1],c=[0];continue;case 7:c=o.ops.pop(),o.trys.pop();continue;default:if(!(r=(r=o.trys).length>0&&r[r.length-1])&&(6===c[0]||2===c[0])){o=0;continue}if(3===c[0]&&(!r||c[1]>r[0]&&c[1]<r[3])){o.label=c[1];break}if(6===c[0]&&o.label<r[1]){o.label=r[1],r=c;break}if(r&&o.label<r[2]){o.label=r[2],o.ops.push(c);break}r[2]&&o.ops.pop(),o.trys.pop();continue}c=t.call(e,o)}catch(e){c=[6,e],a=0}finally{n=r=0}if(5&c[0])throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}}var p=l.Typography.Title,d=l.Typography.Text,f=l.Typography.Paragraph;function y(){var e,t,n=(0,o.useAPIClient)(),i=s(l.Form.useForm(),1)[0],c=s((0,a.useState)(!0),2),y=c[0],v=c[1],h=s((0,a.useState)(!1),2),b=h[0],g=h[1],E=s((0,a.useState)([]),2),A=E[0],S=E[1],w=s((0,a.useState)([]),2),I=w[0],L=w[1],k=s((0,a.useState)(""),2),C=k[0],P=k[1];(0,a.useEffect)(function(){x(),P("".concat(window.location.origin,"/api/ai-llm/v1"))},[]);var x=(e=u(function(){var e,t,a,r,l,o,c;return m(this,function(u){switch(u.label){case 0:v(!0),u.label=1;case 1:return u.trys.push([1,5,6,7]),[4,n.request({url:"aiApiConfig:get"})];case 2:return(l=null==(r=u.sent())||null==(e=r.data)?void 0:e.data)&&i.setFieldsValue({mode:l.mode||"llm",defaultAiEmployee:l.defaultAiEmployee||void 0,defaultLlmService:l.defaultLlmService||void 0,enabledLlmServices:l.enabledLlmServices||[],rateLimitPerMinute:l.rateLimitPerMinute||60}),[4,n.request({url:"aiEmployees:list",params:{paginate:!1}})];case 3:return S(((null==(o=u.sent())||null==(t=o.data)?void 0:t.data)||[]).map(function(e){return{username:e.username,nickname:e.nickname||e.username}})),[4,n.request({url:"ai:listLLMServices"})];case 4:return L(((null==(c=u.sent())||null==(a=c.data)?void 0:a.data)||[]).map(function(e){return{name:e.name,title:e.title||e.name,provider:e.provider,enabled:!1!==e.enabled}})),[3,7];case 5:return console.error("Failed to load config:",u.sent()),[3,7];case 6:return v(!1),[7];case 7:return[2]}})}),function(){return e.apply(this,arguments)}),M=(t=u(function(){var e;return m(this,function(t){switch(t.label){case 0:g(!0),t.label=1;case 1:return t.trys.push([1,3,4,5]),e=i.getFieldsValue(),[4,n.request({url:"aiApiConfig:save",method:"post",data:e})];case 2:return t.sent(),l.message.success("Configuration saved"),[3,5];case 3:return t.sent(),l.message.error("Failed to save configuration"),[3,5];case 4:return g(!1),[7];case 5:return[2]}})}),function(){return t.apply(this,arguments)});return y?r().createElement("div",{style:{display:"flex",justifyContent:"center",padding:60}},r().createElement(l.Spin,{size:"large"})):r().createElement("div",{style:{maxWidth:800,margin:"0 auto",padding:"24px 0"}},r().createElement(p,{level:3},"AI API Gateway Configuration"),r().createElement(f,{type:"secondary"},"Configure the OpenAI-compatible API endpoint. External applications can connect using the base URL and a NocoBase API key."),r().createElement(l.Card,{style:{marginBottom:24}},r().createElement(l.Alert,{type:"info",showIcon:!0,message:"API Endpoint",description:r().createElement(l.Space,{direction:"vertical",size:4},r().createElement(d,null,"Base URL: ",r().createElement(d,{code:!0,copyable:!0},C)),r().createElement(d,{type:"secondary"},"Use this as the base URL in any OpenAI-compatible client (Cursor, Continue.dev, n8n, etc.)")),style:{marginBottom:16}}),r().createElement(l.Alert,{type:"warning",showIcon:!0,message:"Authentication",description:r().createElement(d,null,"Clients must include a NocoBase API key as a Bearer token:",r().createElement("br",null),r().createElement(d,{code:!0},"Authorization: Bearer ","<your-nocobase-api-key>"),r().createElement("br",null),r().createElement(d,{type:"secondary"},"API keys can be created in Settings → API keys."))})),r().createElement(l.Card,{title:"Configuration"},r().createElement(l.Form,{form:i,layout:"vertical",onFinish:M,initialValues:{mode:"llm"}},r().createElement(l.Form.Item,{name:"mode",label:"API Mode",tooltip:"LLM Proxy: Direct access to the LLM model. Agent: Full AI Employee with tools, knowledge base, and agent capabilities."},r().createElement(l.Radio.Group,null,r().createElement(l.Radio.Button,{value:"llm"},"LLM Proxy"),r().createElement(l.Radio.Button,{value:"agent"},"AI Employee Agent"))),r().createElement(l.Form.Item,{name:"defaultAiEmployee",label:"Default AI Employee",tooltip:"The AI Employee whose system prompt will be injected into chat completions (when client doesn't provide a system message)"},r().createElement(l.Select,{allowClear:!0,placeholder:"Select an AI Employee (optional)",options:A.map(function(e){return{label:"".concat(e.nickname," (").concat(e.username,")"),value:e.username}})})),r().createElement(l.Form.Item,{name:"defaultLlmService",label:"Default LLM Service",tooltip:"The LLM service used when clients send only a model name (e.g. 'gpt-4o') without a service prefix. This is the main service that powers the API.",rules:[{required:!0,message:"Please select a default LLM service"}]},r().createElement(l.Select,{allowClear:!0,placeholder:"Select an LLM Service",options:I.map(function(e){return{label:"".concat(e.title," (").concat(e.provider,")"),value:e.name}})})),r().createElement(l.Form.Item,{name:"enabledLlmServices",label:"Enabled LLM Services",tooltip:"Only these services will be exposed via the API. Leave empty to expose all enabled services."},r().createElement(l.Select,{mode:"multiple",allowClear:!0,placeholder:"All enabled services (default)",options:I.map(function(e){return{label:"".concat(e.title," (").concat(e.provider,")"),value:e.name}})})),r().createElement(l.Form.Item,{name:"rateLimitPerMinute",label:"Rate Limit (requests/minute)",tooltip:"Maximum API requests per user per minute. Set 0 for unlimited."},r().createElement(l.InputNumber,{min:0,max:1e4,style:{width:200}})),r().createElement(l.Form.Item,null,r().createElement(l.Button,{type:"primary",htmlType:"submit",loading:b},"Save Configuration")))),r().createElement(l.Card,{title:"Quick Start",style:{marginTop:24}},r().createElement(p,{level:5},"cURL Example"),r().createElement(f,null,r().createElement("pre",{style:{background:"#1a1a2e",color:"#e0e0e0",padding:16,borderRadius:8,fontSize:13,overflow:"auto"}},"curl ".concat(C,'/chat/completions \\\n  -H "Authorization: Bearer <your-api-key>" \\\n  -H "Content-Type: application/json" \\\n  -d \'{\n    "model": "<service-name>/<model-id>",\n    "messages": [\n      {"role": "user", "content": "Hello!"}\n    ]\n  }\''))),r().createElement(p,{level:5},"Python (OpenAI SDK)"),r().createElement(f,null,r().createElement("pre",{style:{background:"#1a1a2e",color:"#e0e0e0",padding:16,borderRadius:8,fontSize:13,overflow:"auto"}},'from openai import OpenAI\n\nclient = OpenAI(\n    base_url="'.concat(C,'",\n    api_key="<your-nocobase-api-key>"\n)\n\nresponse = client.chat.completions.create(\n    model="<service-name>/<model-id>",\n    messages=[{"role": "user", "content": "Hello!"}]\n)'))),r().createElement(p,{level:5},"List Available Models"),r().createElement(f,null,r().createElement("pre",{style:{background:"#1a1a2e",color:"#e0e0e0",padding:16,borderRadius:8,fontSize:13,overflow:"auto"}},"curl ".concat(C,'/models \\\n  -H "Authorization: Bearer <your-api-key>"')))))}t.default=y}}]);

package/dist/client/AiApiConfigPage.d.ts

@@ -1,3 +0,0 @@
-import React from 'react';
-export declare function AiApiConfigPage(): React.JSX.Element;
-export default AiApiConfigPage;

package/dist/client/components/AiApiRolePermissions.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-/**
- * Permission tab shown in Settings → Users & Permissions → [Role] → "AI API" tab.
- * Lets admins control whether a role can use the AI API and which AI Employees it may access.
- */
-export declare function AiApiRolePermissions({ role }: {
-    role: any;
-}): React.JSX.Element;