plugin-build-visualization-block 0.1.1

package/dist/server/collections/ai-visualization-build-settings.js

@@ -0,0 +1,68 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ai_visualization_build_settings_exports = {};
+__export(ai_visualization_build_settings_exports, {
+  default: () => ai_visualization_build_settings_default
+});
+module.exports = __toCommonJS(ai_visualization_build_settings_exports);
+var import_database = require("@nocobase/database");
+var ai_visualization_build_settings_default = (0, import_database.defineCollection)({
+  name: "aiVisualizationBuildSettings",
+  shared: true,
+  dumpRules: "required",
+  migrationRules: ["overwrite", "schema-only"],
+  fields: [
+    {
+      type: "bigInt",
+      name: "id",
+      primaryKey: true,
+      autoIncrement: true
+    },
+    {
+      type: "string",
+      name: "defaultDataSource"
+    },
+    {
+      type: "json",
+      name: "defaultCollections",
+      defaultValue: []
+    },
+    {
+      type: "string",
+      name: "defaultLLMService"
+    },
+    {
+      type: "string",
+      name: "defaultModel"
+    },
+    {
+      type: "boolean",
+      name: "enableAITool",
+      defaultValue: true
+    }
+  ]
+});

package/dist/server/collections/ai-visualization-builds.js

@@ -0,0 +1,143 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ai_visualization_builds_exports = {};
+__export(ai_visualization_builds_exports, {
+  default: () => ai_visualization_builds_default
+});
+module.exports = __toCommonJS(ai_visualization_builds_exports);
+var import_database = require("@nocobase/database");
+var ai_visualization_builds_default = (0, import_database.defineCollection)({
+  name: "aiVisualizationBuilds",
+  shared: true,
+  dumpRules: "required",
+  migrationRules: ["overwrite", "schema-only"],
+  timestamps: true,
+  fields: [
+    {
+      type: "bigInt",
+      name: "id",
+      primaryKey: true,
+      autoIncrement: true
+    },
+    {
+      type: "string",
+      name: "title"
+    },
+    {
+      type: "text",
+      name: "requirement"
+    },
+    {
+      type: "string",
+      name: "dataSource"
+    },
+    {
+      // Array of selected target collection names.
+      type: "json",
+      name: "collections"
+    },
+    {
+      type: "string",
+      name: "primaryCollection"
+    },
+    {
+      type: "string",
+      name: "llmService"
+    },
+    {
+      type: "string",
+      name: "model"
+    },
+    {
+      // idle | building | completed | error
+      type: "string",
+      name: "status",
+      defaultValue: "idle"
+    },
+    {
+      // idle | queued | analyzing | generating | completed | failed
+      type: "string",
+      name: "buildPhase",
+      defaultValue: "idle"
+    },
+    {
+      // Current run identity, used as a stale-run guard.
+      type: "uuid",
+      name: "buildRunId"
+    },
+    {
+      type: "date",
+      name: "buildQueuedAt"
+    },
+    {
+      type: "date",
+      name: "buildStartedAt"
+    },
+    {
+      type: "date",
+      name: "buildHeartbeatAt"
+    },
+    {
+      type: "string",
+      name: "buildWorkerId"
+    },
+    {
+      // The validated BlockSpec produced by the pipeline.
+      type: "json",
+      name: "blockSpec"
+    },
+    {
+      // The generated Formily block schema.
+      type: "json",
+      name: "blockSchema"
+    },
+    {
+      // Validator adjustments (removed / remapped references, unmet roles).
+      type: "json",
+      name: "adjustments"
+    },
+    {
+      type: "boolean",
+      name: "usedFallback",
+      defaultValue: false
+    },
+    {
+      type: "text",
+      name: "buildLog"
+    },
+    {
+      type: "text",
+      name: "errorMessage"
+    },
+    {
+      type: "belongsTo",
+      name: "createdBy",
+      target: "users",
+      foreignKey: "createdById"
+    }
+  ]
+});

package/dist/server/index.js

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var server_exports = {};
+__export(server_exports, {
+  default: () => import_plugin.default
+});
+module.exports = __toCommonJS(server_exports);
+__reExport(server_exports, require("./plugin"), module.exports);
+var import_plugin = __toESM(require("./plugin"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./plugin")
+});

package/dist/server/pipeline/analyzer.js

@@ -0,0 +1,220 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var analyzer_exports = {};
+__export(analyzer_exports, {
+  analyze: () => analyze,
+  buildAnalyzerMessages: () => buildAnalyzerMessages,
+  extractJsonObject: () => extractJsonObject,
+  getLLMProvider: () => getLLMProvider,
+  invokeLLM: () => invokeLLM,
+  parseBlockSpec: () => parseBlockSpec,
+  stripFence: () => stripFence,
+  stripThink: () => stripThink,
+  toPlainText: () => toPlainText
+});
+module.exports = __toCommonJS(analyzer_exports);
+var import_messages = require("@langchain/core/messages");
+var import_blockSpec = require("../../shared/blockSpec");
+var import_constants = require("../../shared/constants");
+var import_fallback = require("./fallback");
+function stripThink(text) {
+  return text.replace(/<think>[\s\S]*?(?:<\/think>|$)/gi, "").trim();
+}
+function stripFence(text) {
+  return text.replace(/^```(?:json|markdown|md|html)?\s*/i, "").replace(/```\s*$/i, "").trim();
+}
+function toPlainText(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (typeof item === "string") {
+        return item;
+      }
+      if (item && typeof item === "object") {
+        const part = item;
+        if (typeof part.text === "string") {
+          return part.text;
+        }
+        if (typeof part.content === "string") {
+          return part.content;
+        }
+      }
+      return "";
+    }).filter(Boolean).join("\n");
+  }
+  if (value && typeof value === "object") {
+    const obj = value;
+    const text = obj.text ?? obj.content;
+    if (typeof text === "string") {
+      return text;
+    }
+  }
+  return JSON.stringify(value);
+}
+function extractJsonObject(text) {
+  const cleanText = stripFence(stripThink(text));
+  const jsonStart = cleanText.indexOf("{");
+  const jsonEnd = cleanText.lastIndexOf("}");
+  return jsonStart >= 0 && jsonEnd > jsonStart ? cleanText.slice(jsonStart, jsonEnd + 1) : cleanText;
+}
+async function getLLMProvider(app, llmService, model) {
+  const aiPlugin = app.pm.get("ai");
+  if (!aiPlugin) {
+    throw new Error("Plugin AI is not available");
+  }
+  const serviceData = await aiPlugin.aiManager.getLLMService({ llmService, model });
+  return serviceData.provider;
+}
+function compactSummary(summary) {
+  return {
+    dataSource: summary.dataSource,
+    collections: summary.collections.map((collection) => ({
+      name: collection.name,
+      ...collection.introspectionFailed ? { introspectionFailed: true } : {},
+      fields: collection.fields.map((field) => ({
+        name: field.name,
+        type: field.type,
+        interface: field.interface
+      })),
+      relations: collection.relations.map((relation) => ({
+        name: relation.name,
+        type: relation.type,
+        target: relation.target
+      }))
+    }))
+  };
+}
+const SYSTEM_PROMPT = `You are a NocoBase block designer. Given a natural-language requirement and a JSON description of the available collections (with their fields and relations), design exactly one block: a chart, a table, or a form.
+
+Return ONLY one JSON object. Do not include any prose, explanation, Markdown, or code fences. The JSON object must conform to this BlockSpec shape:
+
+{
+  "version": 1,
+  "blockType": "chart" | "table" | "form",
+  "title": string,
+  "primaryCollection": string,   // a collection name from the provided schema; the block is bound to it
+  "dataSource": string,          // the provided dataSource
+  // include exactly one of the following payloads, matching blockType:
+  // when blockType === "chart":
+  "charts": [
+    {
+      "key": string,
+      "title": string,
+      "chartType": string,       // e.g. "ant-design-charts.pie", "ant-design-charts.column", "antd.statistic"
+      "measures": [
+        { "field": string, "aggregation": "count" | "sum" | "avg" | "max" | "min", "alias": string }
+      ],
+      "dimensions": [ { "field": string } ]
+    }
+  ],
+  // when blockType === "table":
+  "table": { "fields": [string] },
+  // when blockType === "form":
+  "form": { "fields": [string] }
+}
+
+Rules:
+- Use ONLY collections, fields, and relations that appear in the provided schema. Never invent field names.
+- "primaryCollection" must be one of the provided collection names.
+- "dataSource" must equal the provided dataSource.
+- Always set "version" to 1.
+- Choose the blockType that best satisfies the requirement and include only that type's payload.
+- Output the single JSON object and nothing else.`;
+function buildAnalyzerMessages(params) {
+  const { requirement, summary } = params;
+  const schemaJson = JSON.stringify(compactSummary(summary));
+  return [
+    new import_messages.SystemMessage(SYSTEM_PROMPT),
+    new import_messages.HumanMessage(`Requirement:
+${requirement}
+
+Available schema (JSON):
+${schemaJson}
+
+Return ONLY the BlockSpec JSON object.`)
+  ];
+}
+async function invokeLLM(provider, messages) {
+  let timer;
+  const timeout = new Promise((_resolve, reject) => {
+    timer = setTimeout(() => reject(new Error(`LLM invocation timed out after ${import_constants.LLM_TIMEOUT_MS}ms`)), import_constants.LLM_TIMEOUT_MS);
+  });
+  try {
+    const response = await Promise.race([provider.chatModel.invoke(messages), timeout]);
+    return extractJsonObject(toPlainText(response.content));
+  } finally {
+    if (timer) {
+      clearTimeout(timer);
+    }
+  }
+}
+function parseBlockSpec(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    return { ok: false, error: `Failed to parse LLM output as JSON: ${reason}` };
+  }
+  const result = import_blockSpec.blockSpecSchema.safeParse(parsed);
+  if (!result.success) {
+    const reason = result.error.issues.map((issue) => `${issue.path.join(".") || "<root>"}: ${issue.message}`).join("; ");
+    return { ok: false, error: `LLM output did not match BlockSpec shape: ${reason}` };
+  }
+  return { ok: true, spec: result.data };
+}
+async function analyze(app, params) {
+  const { requirement, summary, llmService, model } = params;
+  let raw;
+  try {
+    const provider = await getLLMProvider(app, llmService, model);
+    const messages = buildAnalyzerMessages({ requirement, summary });
+    raw = await invokeLLM(provider, messages);
+  } catch (err) {
+    const error = err instanceof Error ? err.message : String(err);
+    return { spec: (0, import_fallback.buildFallbackSpec)(summary), usedFallback: true, error };
+  }
+  const parsed = parseBlockSpec(raw);
+  if (parsed.ok) {
+    return { spec: parsed.spec, usedFallback: false };
+  }
+  return { spec: (0, import_fallback.buildFallbackSpec)(summary), usedFallback: true, error: parsed.error };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  analyze,
+  buildAnalyzerMessages,
+  extractJsonObject,
+  getLLMProvider,
+  invokeLLM,
+  parseBlockSpec,
+  stripFence,
+  stripThink,
+  toPlainText
+});

package/dist/server/pipeline/fallback.js

@@ -0,0 +1,113 @@
+/**
+ * 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.
+ */
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var fallback_exports = {};
+__export(fallback_exports, {
+  buildFallbackSpec: () => buildFallbackSpec,
+  default: () => fallback_default
+});
+module.exports = __toCommonJS(fallback_exports);
+const RECORD_MATCH_NAMES = /* @__PURE__ */ new Set(["id", "uid", "uuid", "key"]);
+const STATUS_MATCH_NAMES = /* @__PURE__ */ new Set(["status", "state", "stage", "workflowstatus"]);
+const CREATED_AT_MATCH_NAMES = /* @__PURE__ */ new Set(["createdat", "createat", "creationdate", "createdon"]);
+const STATUS_INTERFACES = /* @__PURE__ */ new Set(["select", "radiogroup", "input", "multipleselect"]);
+const DATE_FIELD_TYPES = /* @__PURE__ */ new Set(["date", "dateonly", "datetime"]);
+const DATE_INTERFACES = /* @__PURE__ */ new Set(["createdat", "updatedat", "datetime", "date"]);
+const DEFAULT_MEASURE_FIELD = "id";
+const normalize = (value = "") => value.replace(/[^a-zA-Z0-9]/g, "").toLowerCase();
+function pickPrimaryCollection(summary) {
+  const withFields = summary.collections.find(
+    (collection) => !collection.introspectionFailed && collection.fields.length > 0
+  );
+  return withFields ?? summary.collections[0];
+}
+function pickMeasureField(fields) {
+  var _a;
+  const record = fields.find((field) => RECORD_MATCH_NAMES.has(normalize(field.name)));
+  return (record == null ? void 0 : record.name) ?? ((_a = fields[0]) == null ? void 0 : _a.name) ?? DEFAULT_MEASURE_FIELD;
+}
+function isStatusLike(field) {
+  if (STATUS_MATCH_NAMES.has(normalize(field.name))) {
+    return true;
+  }
+  return field.type === "string" && STATUS_INTERFACES.has(normalize(field.interface));
+}
+function isCreatedAtLike(field) {
+  if (CREATED_AT_MATCH_NAMES.has(normalize(field.name))) {
+    return true;
+  }
+  return DATE_FIELD_TYPES.has(normalize(field.type)) || DATE_INTERFACES.has(normalize(field.interface));
+}
+function buildFallbackSpec(summary) {
+  const collection = pickPrimaryCollection(summary);
+  const fields = (collection == null ? void 0 : collection.fields) ?? [];
+  const measureField = pickMeasureField(fields);
+  const charts = [
+    {
+      key: "total-records",
+      title: "Total records",
+      chartType: "antd.statistic",
+      measures: [{ field: measureField, aggregation: "count", alias: "value" }],
+      config: { field: "value", title: "Total records" }
+    }
+  ];
+  const statusField = fields.find(isStatusLike);
+  if (statusField) {
+    charts.push({
+      key: "records-by-status",
+      title: "Records by status",
+      chartType: "ant-design-charts.pie",
+      measures: [{ field: measureField, aggregation: "count", alias: "value" }],
+      dimensions: [{ field: statusField.name, alias: "status" }],
+      config: { angleField: "value", colorField: "status" }
+    });
+  }
+  const createdAtField = fields.find(isCreatedAtLike);
+  if (createdAtField) {
+    charts.push({
+      key: "created-trend",
+      title: "Created trend",
+      chartType: "ant-design-charts.line",
+      measures: [{ field: measureField, aggregation: "count", alias: "value" }],
+      dimensions: [{ field: createdAtField.name, format: "YYYY-MM-DD", alias: "createdAt" }],
+      config: { xField: "createdAt", yField: "value", smooth: true }
+    });
+  }
+  return {
+    version: 1,
+    blockType: "chart",
+    title: "Overview",
+    primaryCollection: (collection == null ? void 0 : collection.name) ?? "",
+    dataSource: summary.dataSource,
+    charts,
+    rationale: "Fallback collection overview generated automatically because a tailored specification was not available."
+  };
+}
+var fallback_default = buildFallbackSpec;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildFallbackSpec
+});