plugin-custom-llm 1.2.1 → 1.2.3

package/src/server/plugin.ts

@@ -0,0 +1,27 @@
+import { Plugin } from '@nocobase/server';
+import PluginAIServer from '@nocobase/plugin-ai';
+import { customLLMProviderOptions } from './llm-providers/custom-llm';
+
+export class PluginCustomLLMServer extends Plugin {
+  async afterAdd() {}
+
+  async beforeLoad() {}
+
+  async load() {
+    this.aiPlugin.aiManager.registerLLMProvider('custom-llm', customLLMProviderOptions);
+  }
+
+  async install() {}
+
+  async afterEnable() {}
+
+  async afterDisable() {}
+
+  async remove() {}
+
+  private get aiPlugin(): PluginAIServer {
+    return this.app.pm.get('ai');
+  }
+}
+
+export default PluginCustomLLMServer;

package/src/swagger.ts

@@ -0,0 +1,9 @@
+export default {
+  info: {
+    title: 'NocoBase API - Custom LLM Plugin',
+    description:
+      'Registers a custom OpenAI-compatible LLM provider with the AI plugin. This plugin has no direct HTTP endpoints — all API access is through the AI API plugin gateway (`/api/ai-llm/v1/*`) using models registered under the `custom-llm` service.',
+  },
+  tags: [{ name: 'custom-llm', description: 'Custom LLM provider (no direct endpoints)' }],
+  paths: {},
+};

package/dist/client/index.d.ts

@@ -1,8 +0,0 @@
-import { Plugin } from '@nocobase/client';
-export declare class PluginCustomLLMClient extends Plugin {
-    afterAdd(): Promise<void>;
-    beforeLoad(): Promise<void>;
-    load(): Promise<void>;
-    private get aiPlugin();
-}
-export default PluginCustomLLMClient;

package/dist/client/llm-providers/custom-llm/ModelSettings.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const ModelSettingsForm: React.FC;

package/dist/client/llm-providers/custom-llm/ProviderSettings.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export declare const ProviderSettingsForm: React.FC;

package/dist/client/llm-providers/custom-llm/index.d.ts

@@ -1,2 +0,0 @@
-import { LLMProviderOptions } from '@nocobase/plugin-ai/client';
-export declare const customLLMProviderOptions: LLMProviderOptions;

package/dist/client/locale.d.ts

@@ -1,2 +0,0 @@
-export declare const namespace = "@nocobase/plugin-custom-llm";
-export declare function useT(): import("react-i18next").TFunction<"@nocobase/plugin-custom-llm", undefined>;

package/dist/client/plugin.d.ts

@@ -1,5 +0,0 @@
-import { Plugin } from '@nocobase/client';
-export declare class PluginCustomLlmClient extends Plugin {
-    load(): Promise<void>;
-}
-export default PluginCustomLlmClient;

package/dist/server/llm-providers/custom-llm.d.ts

@@ -1,54 +0,0 @@
-import { LLMProvider, LLMProviderMeta } from '@nocobase/plugin-ai';
-import { Model } from '@nocobase/database';
-import { Context } from '@nocobase/actions';
-import type { ParsedAttachmentResult } from '@nocobase/plugin-ai';
-export declare class CustomLLMProvider extends LLMProvider {
-    get baseURL(): any;
-    private get requestConfig();
-    private get responseConfig();
-    createModel(): any;
-    parseResponseChunk(chunk: any): string | null;
-    parseResponseMessage(message: Model): {
-        key: Model;
-        content: Record<string, any>;
-        role: Model;
-    };
-    parseReasoningContent(chunk: any): {
-        status: string;
-        content: string;
-    } | null;
-    /**
-     * Extract response metadata from LLM output for post-save enrichment.
-     * Sanitizes overly long message IDs from Gemini or other providers.
-     */
-    parseResponseMetadata(output: any): any;
-    parseResponseError(err: any): any;
-    /**
-     * Self-contained file reading that correctly handles the APP_PUBLIC_PATH prefix.
-     *
-     * plugin-ai's encodeLocalFile does path.join(cwd, url) without stripping
-     * APP_PUBLIC_PATH, so when the app is deployed under a sub-path (e.g. /my-app)
-     * the resolved path becomes '{cwd}/my-app/storage/uploads/…' which does not exist.
-     * We cannot fix that in plugin-ai (core), so we re-implement file reading here
-     * with the prefix stripped before the cwd join.
-     */
-    private readFileAsBase64;
-    /**
-     * Override parseAttachment to convert all attachments into formats that
-     * generic OpenAI-compatible endpoints actually support:
-     *
-     *   - Images     → image_url block with base64 data URI (vision models)
-     *   - Text files → text block with decoded UTF-8 content
-     *   - Binary     → text block with base64 data URI (multi-modal or fallback)
-     *
-     * The base-class implementation returns a LangChain ContentBlock.Multimodal.File
-     * (`type: 'file'`) for non-image attachments. LangChain serialises this as the
-     * newer OpenAI Files API format which most custom/local endpoints do NOT understand,
-     * causing file content to be silently dropped.
-     *
-     * This method is entirely self-contained — it does not call super — so it is
-     * safe to use without modifying plugin-ai core.
-     */
-    parseAttachment(ctx: Context, attachment: any): Promise<ParsedAttachmentResult>;
-}
-export declare const customLLMProviderOptions: LLMProviderMeta;

package/dist/server/plugin.d.ts

@@ -1,12 +0,0 @@
-import { Plugin } from '@nocobase/server';
-export declare class PluginCustomLLMServer extends Plugin {
-    afterAdd(): Promise<void>;
-    beforeLoad(): Promise<void>;
-    load(): Promise<void>;
-    install(): Promise<void>;
-    afterEnable(): Promise<void>;
-    afterDisable(): Promise<void>;
-    remove(): Promise<void>;
-    private get aiPlugin();
-}
-export default PluginCustomLLMServer;