@nocobase/plugin-ai 2.1.31 → 2.2.0-alpha.10

package/dist/ai/docs/nocobase/workflow/development/trigger.md

@@ -1,4 +1,10 @@
-# Extend Trigger Types
+---
+title: "Extending Trigger Types"
+description: "Extending trigger types: custom trigger development, configuration interface, trigger logic, API reference."
+keywords: "workflow,extending triggers,custom triggers,trigger development,NocoBase"
+---
+
+# Extending Trigger Types
 
 Every workflow must be configured with a specific trigger, which serves as the entry point for starting the process execution.
 
@@ -62,39 +68,129 @@ After the server starts and loads, the `'interval'` type trigger can be added an
 
 The client-side part mainly provides a configuration interface based on the configuration items required by the trigger type. Each trigger type also needs to register its corresponding type configuration with the Workflow plugin.
 
-For example, for the scheduled execution trigger mentioned above, define the required interval time configuration item (`interval`) in the configuration interface form:
+The trigger's configuration interface is defined through a Loader (lazy-loading function), which points to a plain React component that builds the form using antd's `Form.Item`.
+
+### The Simplest Trigger
+
+For example, for the interval timer trigger described above, define the interval time configuration item (`interval`) needed in the configuration interface form:
 
 ```ts
-import { Trigger } from '@nocobase/workflow/client';
+import { Trigger } from '@nocobase/plugin-workflow/client-v2';
 
 class MyTrigger extends Trigger {
   title = 'Interval timer trigger';
-  // fields of trigger config
-  fieldset = {
-    interval: {
-      type: 'number',
-      title: 'Interval',
-      name: 'config.interval',
-      'x-decorator': 'FormItem',
-      'x-component': 'InputNumber',
-      default: 60000,
-    },
-  };
+
+  // Trigger config form (lazy-loaded component)
+  FieldsetLoader = () => import('./IntervalConfig');
+
+  // Config validation
+  validate(config) {
+    return Boolean(config?.interval);
+  }
+}
+```
+
+Here, `FieldsetLoader` is a function that returns `Promise<{ default: ComponentType }>`, implementing lazy loading via dynamic `import()`. The component it points to is a standard React function component:
+
+```tsx
+// IntervalConfig.tsx
+import { Form, InputNumber } from 'antd';
+
+export default function IntervalConfig() {
+  return (
+    <Form.Item
+      name={['config', 'interval']}
+      label="Interval"
+      initialValue={60000}
+      rules={[{ required: true }]}
+    >
+      <InputNumber min={1000} />
+    </Form.Item>
+  );
 }
 ```
 
-Then, register this trigger type with the workflow plugin instance within the extended plugin:
+Note that the form field's `name` uses the nested array format `['config', 'fieldName']`, which is the standard antd Form convention.
+
+### Multiple Configuration Interfaces
+
+A trigger can provide multiple configuration interfaces for different scenarios:
+
+- `PresetFieldsetLoader` — Preset form when creating a workflow (usually contains only required fields)
+![PresetFieldsetLoader](https://static-docs.nocobase.com/20260701152711.png)
+
+- `FieldsetLoader` — Full trigger configuration form (displayed in the configuration drawer)
+![FieldsetLoader](https://static-docs.nocobase.com/20260701152822.png)
+
+- `TriggerFieldsetLoader` — Input form for manual execution
+![FieldsetLoader](https://static-docs.nocobase.com/20260701152846.png)
+
+When a Loader needs to point to a named export (rather than the default export) in a file, use `.then()` to remap:
 
 ```ts
-import { Plugin } from '@nocobase/client';
-import WorkflowPlugin from '@nocobase/plugin-workflow/client';
+class MyTrigger extends Trigger {
+  title = 'My trigger';
 
+  PresetFieldsetLoader = () =>
+    import('./MyTriggerConfig').then((m) => ({ default: m.MyPresetConfig }));
+  FieldsetLoader = () => import('./MyTriggerConfig');
+  TriggerFieldsetLoader = () => import('./TriggerMyConfig');
+
+  validate(config) {
+    return Boolean(config?.collection && config?.mode);
+  }
+
+  createDefaultConfig() {
+    return { mode: 1 };
+  }
+}
+```
+
+```tsx
+// MyTriggerConfig.tsx
+import { Form, Select } from 'antd';
+import { CollectionCascader } from '@nocobase/plugin-workflow/client-v2';
+
+// Preset form for creation (named export)
+export function MyPresetConfig() {
+  return (
+    <Form.Item name={['config', 'collection']} label="Collection" rules={[{ required: true }]}>
+      <CollectionCascader />
+    </Form.Item>
+  );
+}
+
+// Full config form (default export)
+export default function MyTriggerConfig() {
+  return (
+    <>
+      <Form.Item name={['config', 'collection']} label="Collection">
+        <CollectionCascader disabled />
+      </Form.Item>
+      <Form.Item name={['config', 'mode']} label="Mode">
+        <Select
+          options={[
+            { label: 'Created', value: 1 },
+            { label: 'Updated', value: 2 },
+          ]}
+        />
+      </Form.Item>
+    </>
+  );
+}
+```
+
+### Register the Trigger
+
+Register the trigger type with the workflow plugin instance within the extended plugin:
+
+```ts
+import { Plugin } from '@nocobase/client-v2';
 import MyTrigger from './MyTrigger';
 
 export default class extends Plugin {
-  // You can get and modify the app instance here
   async load() {
-    const workflow = this.app.pm.get(WorkflowPlugin) as WorkflowPlugin;
+    const workflow = this.app.pm.get('workflow');
     workflow.registerTrigger('interval', MyTrigger);
   }
 }
@@ -106,4 +202,10 @@ After that, the new trigger type will be visible in the workflow configuration i
 The identifier of the trigger type registered on the client-side must be consistent with the one on the server-side, otherwise it will cause errors.
 :::
 
-For other details on defining trigger types, please refer to the [Workflow API Reference](./api#pluginregisterTrigger) section.
+For a complete real-world example, refer to: [CollectionTrigger source code](https://github.com/nocobase/nocobase/blob/develop/packages/plugins/%40nocobase/plugin-workflow/src/client-v2/triggers/collection/index.tsx)
+
+For other details on defining trigger types, please refer to the [Workflow API Reference](./api) section.
+
+:::info{title=Note}
+If you were previously using the legacy (v1) client-side code and want to migrate to the new v2 version, refer to the [v1 to v2 Migration Guide](./migration).
+:::

package/dist/ai/docs/nocobase/workflow/nodes/index.md

@@ -6,7 +6,7 @@ A workflow is typically composed of several connected operational steps. Each no
 A workflow's trigger is not a node. It is only displayed as an entry point in the flowchart, but it is a different concept from a node. For details, please refer to the [Triggers](../triggers/index.md) content.
 :::
 
-From a functional perspective, the currently implemented nodes can be divided into several major categories (28 types of nodes in total):
+From a functional perspective, the currently implemented nodes can be divided into several major categories (30 types of nodes in total):
 
 - Artificial Intelligence
   - [Large Language Model](../../ai-employees/workflow/nodes/llm/chat.md) (provided by @nocobase/plugin-workflow-llm plugin)
@@ -32,6 +32,7 @@ From a functional perspective, the currently implemented nodes can be divided in
   - [Query Data](./query.md)
   - [Aggregate Query](./aggregate.md) (provided by @nocobase/plugin-workflow-aggregate plugin)
   - [SQL Action](./sql.md) (provided by @nocobase/plugin-workflow-sql plugin)
+  - [Database Transaction](./transaction.md) (provided by @nocobase/plugin-workflow-transaction plugin)
 - Manual Handling
   - [Manual Handling](./manual.md) (provided by @nocobase/plugin-workflow-manual plugin)
   - [Approval](./approval.md) (provided by @nocobase/plugin-workflow-approval plugin)

package/dist/ai/docs/nocobase/workflow/nodes/transaction.md

@@ -0,0 +1,81 @@
+---
+pkg: '@nocobase/plugin-workflow-transaction'
+title: "Workflow node - Database transaction"
+description: "Database transaction node: run data operations from the same data source in one transaction, commit on success, and roll back on failure."
+keywords: "workflow,database transaction,Transaction,rollback,commit,data operation,NocoBase"
+---
+
+# Database Transaction
+
+## Introduction
+
+The database transaction node runs a group of database operations in the same transaction. It is suitable for scenarios where multiple data steps must either all succeed or all roll back, such as creating an order, deducting inventory, writing order details, and updating status.
+
+The transaction node currently supports database data sources only. Data operations from the same data source inside the node are automatically included in the transaction; other data sources do not use this transaction.
+
+This node has been supported since 2.2.0.
+
+## Create Node
+
+In the workflow configuration interface, click the plus ("+") button in the flow to add a "Database transaction" node.
+
+![20260610205146](https://static-docs.nocobase.com/20260610205146.png)
+
+After creation, two branches are generated:
+
+- **Run**: The main branch executed inside the transaction. If all nodes in this branch succeed, the transaction is committed automatically. If any node fails or throws an error, the transaction is rolled back automatically.
+- **After rollback**: The branch executed after rollback. This branch runs outside the transaction and can be used to record logs, send notifications, or perform compensation handling.
+
+![20260610205303](https://static-docs.nocobase.com/20260610205303.png)
+
+## Node Configuration
+
+![20260610205505](https://static-docs.nocobase.com/20260610205505.png)
+
+### Data Source
+
+Select the database data source controlled by this transaction. Only data operation nodes from the same data source are automatically included in the transaction.
+
+### Isolation Level
+
+Set the transaction isolation level. The default value is `READ UNCOMMITTED`. If your business requires stricter data consistency, choose another isolation level based on database capabilities and concurrency requirements.
+
+### Continue Workflow After Rollback
+
+When enabled, the workflow continues to the nodes after the transaction node after the `After rollback` branch finishes.
+
+When disabled, the workflow stops at the transaction node after the `After rollback` branch finishes, and subsequent nodes are not executed.
+
+## Usage
+
+### Constraints
+
+The `Run` branch does not support asynchronous nodes that suspend the workflow, such as manual handling and delay nodes. The transaction must be committed or rolled back during the current execution. If the `Run` branch enters a waiting state, the system rolls back the transaction and marks the workflow as failed.
+
+The `After rollback` branch runs outside the transaction, so it is not subject to the above restriction. You can use asynchronous nodes in this branch as needed, such as sending requests, waiting for manual confirmation, or delaying processing.
+
+:::warning Note
+Transactions occupy database connections until they are committed or rolled back. Avoid long-running operations in the `Run` branch and keep only the necessary data reads, writes, and checks there.
+:::
+
+### Nested Transactions
+
+Transaction nodes can be nested, but you need to pay attention to the data source scope:
+
+- If the inner and outer transactions use the same data source, the inner transaction is created within the outer transaction scope and is handled according to the database and Sequelize capabilities.
+- If the inner transaction uses a different data source, it does not reuse the outer transaction and creates an independent transaction for that data source.
+- If the workflow is triggered by a synchronous collection event, the trigger itself may already provide a top-level transaction for the same data source. The transaction node preferentially reuses the outer transaction of the same data source and does not reuse transactions from different data sources.
+
+Nested transactions increase the cost of understanding and troubleshooting. In general, use nested transactions only when you really need a local rollback boundary. Otherwise, prefer wrapping the complete data processing flow in a single transaction node.
+
+### Common Scenario
+
+A typical flow is as follows:
+
+1. Query or create related data in the `Run` branch.
+2. Continue updating inventory, status, details, and other data from the same data source in the `Run` branch.
+3. If all steps succeed, the transaction is committed automatically.
+4. If any node fails or throws an error, the transaction is rolled back automatically and the workflow enters the `After rollback` branch.
+5. Record the failure reason, send notifications, or perform compensation logic in the `After rollback` branch.
+
+If the workflow needs to continue after rollback, enable "Continue workflow after rollback".

package/dist/ai/tools/executeFrontendTool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+declare const _default: import("@nocobase/ai").ToolsOptions;
+export default _default;

package/dist/ai/tools/executeFrontendTool.js

@@ -0,0 +1,86 @@
+/**
+ * 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 __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 executeFrontendTool_exports = {};
+__export(executeFrontendTool_exports, {
+  default: () => executeFrontendTool_default
+});
+module.exports = __toCommonJS(executeFrontendTool_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var import_frontend_tools = require("../../common/frontend-tools");
+var import_frontend_tools2 = require("../../server/frontend-tools");
+var import_package = __toESM(require("../../../package.json"));
+var executeFrontendTool_default = (0, import_ai.defineTools)({
+  scope: "GENERAL",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("Execute frontend tool", { ns: "${import_package.default.name}" })}}`,
+    about: `{{t("Execute a frontend tool provided by the selected block.", { ns: "${import_package.default.name}" })}}`
+  },
+  definition: {
+    name: import_frontend_tools.EXECUTE_FRONTEND_TOOL_NAME,
+    description: "Execute a frontend tool from the current frontendToolCatalog. Use loadFrontendTool first when you need its input schema. Never use a tool id that is not present in the current catalog.",
+    schema: import_zod.z.object({
+      toolId: import_zod.z.string().describe("The exact tool id from the current frontendToolCatalog."),
+      args: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).default({}).describe("Arguments that match the loaded frontend tool schema.")
+    })
+  },
+  invoke: async (ctx, args, runtime) => {
+    const tool = await (0, import_frontend_tools2.findCurrentFrontendTool)(ctx, args.toolId);
+    if (!tool) {
+      return {
+        status: "error",
+        content: "Frontend tool is unavailable in the current conversation."
+      };
+    }
+    const result = await (0, import_frontend_tools2.readFrontendToolResult)(ctx, runtime.toolCallId);
+    if (!(result == null ? void 0 : result.provided)) {
+      return {
+        status: "error",
+        content: "Frontend tool did not return a result."
+      };
+    }
+    if ((0, import_frontend_tools.isFrontendToolInvokeResult)(result.value)) {
+      return result.value;
+    }
+    return {
+      status: "success",
+      content: result.value
+    };
+  }
+});

package/dist/ai/tools/formFiller.js

@@ -48,16 +48,17 @@ var formFiller_default = (0, import_ai.defineTools)({
   execution: "frontend",
   introduction: {
     title: `{{t("Form filler", { ns: "${import_package.default.name}" })}}`,
-    about: `{{t("Fill the form with the given content", { ns: "${import_package.default.name}" })}}`
+    about: `{{t("Fill form fields with the given content. This tool only writes values into the form UI; it does not submit or save the form.", { ns: "${import_package.default.name}" })}}`
   },
   definition: {
     name: "formFiller",
-    description: "Fill the form with the given content",
+    description: "Fill form fields with the given content. This tool only writes values into the form UI; it does not submit, save, create, or update records. After using it, tell the user to review the filled values and manually submit the form.",
     schema: import_zod.z.object({
       form: import_zod.z.string().describe("The UI Schema ID of the target form to be filled."),
       data: import_zod.z.object({}).catchall(import_zod.z.any()).describe(
         `Structured key-value pairs matching the form's JSON Schema,
        to be assigned to form.values.
+       This only populates fields in the form UI and does not submit, save, create, or update records.
        Example: { "username": "alice", "email": "alice@example.com", "age": 30 }`
       )
     })
@@ -65,7 +66,7 @@ var formFiller_default = (0, import_ai.defineTools)({
   invoke: async () => {
     return {
       status: "success",
-      content: "I have filled the form with the provided data."
+      content: "I have filled the form with the provided data. Please review the values and manually submit the form to save the data."
     };
   }
 });

package/dist/ai/tools/loadFrontendTool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+declare const _default: import("@nocobase/ai").ToolsOptions;
+export default _default;

package/dist/ai/tools/loadFrontendTool.js

@@ -0,0 +1,99 @@
+/**
+ * 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 __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 loadFrontendTool_exports = {};
+__export(loadFrontendTool_exports, {
+  default: () => loadFrontendTool_default
+});
+module.exports = __toCommonJS(loadFrontendTool_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var import_frontend_tools = require("../../common/frontend-tools");
+var import_frontend_tools2 = require("../../server/frontend-tools");
+var import_package = __toESM(require("../../../package.json"));
+var loadFrontendTool_default = (0, import_ai.defineTools)({
+  scope: "GENERAL",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("Load frontend tool", { ns: "${import_package.default.name}" })}}`,
+    about: `{{t("Load the input schema of a frontend tool provided by the selected block.", { ns: "${import_package.default.name}" })}}`
+  },
+  definition: {
+    name: import_frontend_tools.LOAD_FRONTEND_TOOL_NAME,
+    description: 'Load the complete input schema for one frontend tool. This is not a tool discovery API: only call it with an exact tool id copied from the current frontendToolCatalog, and never invent an id such as "current-workspace". After loading a suitable tool, call executeFrontendTool with arguments that match the returned schema.',
+    schema: import_zod.z.object({
+      toolId: import_zod.z.string().describe("The exact tool id from the current frontendToolCatalog.")
+    })
+  },
+  invoke: async (ctx, args, runtime) => {
+    const tool = await (0, import_frontend_tools2.findCurrentFrontendTool)(ctx, args.toolId);
+    if (!tool) {
+      return {
+        status: "error",
+        content: {
+          message: "Frontend tool is unavailable in the current conversation."
+        }
+      };
+    }
+    const result = await (0, import_frontend_tools2.readFrontendToolResult)(ctx, runtime.toolCallId);
+    if (!(result == null ? void 0 : result.provided)) {
+      return {
+        status: "error",
+        content: "Frontend tool manifest was not returned."
+      };
+    }
+    if ((0, import_frontend_tools.isFrontendToolInvokeResult)(result.value)) {
+      return result.value;
+    }
+    if (!(0, import_frontend_tools.isFrontendToolManifest)(result.value) || result.value.id !== args.toolId) {
+      return {
+        status: "error",
+        content: "Frontend tool returned an invalid manifest."
+      };
+    }
+    return {
+      status: "success",
+      content: {
+        id: result.value.id,
+        name: result.value.name,
+        title: result.value.title,
+        description: result.value.description,
+        inputSchema: result.value.inputSchema
+      }
+    };
+  }
+});

package/dist/ai/tools/subAgentWebSearch.js

@@ -40,9 +40,12 @@ var subAgentWebSearch_default = (0, import_ai.defineTools)({
   },
   definition: {
     name: "subAgentWebSearch",
-    description: "Use the query to search the web and return concise, relevant findings with source links.",
+    description: "Search the web for current information. Put all independent search queries needed for this turn into one call so they can run in parallel. Do not call this tool repeatedly with similar queries unless the previous results are clearly insufficient for a critical missing fact.",
     schema: import_zod.z.object({
-      query: import_zod.z.array(import_zod.z.string(), "A clear and specific web search query describing the information to retrieve.")
+      query: import_zod.z.array(
+        import_zod.z.string(),
+        "A list of clear, specific, non-overlapping web search queries. Include all independent queries needed for this answer in a single tool call so they can run in parallel."
+      )
     })
   },
   invoke: async (ctx, args, id) => {
@@ -51,7 +54,8 @@ var subAgentWebSearch_default = (0, import_ai.defineTools)({
     const { model } = ((_b = (_a = ctx.action) == null ? void 0 : _a.params) == null ? void 0 : _b.values) ?? {};
     const { provider } = await pluginAI.aiManager.getLLMService({
       ...model,
-      webSearch: true
+      webSearch: true,
+      reasoning: { mode: "off" }
     });
     if (!((_c = args.query) == null ? void 0 : _c.length)) {
       return {
@@ -85,19 +89,20 @@ var subAgentWebSearch_default = (0, import_ai.defineTools)({
     };
   }
 });
-const WEB_SEARCH_SYSTEM_PROMPT = `You are a web search assistant.
+const WEB_SEARCH_SYSTEM_PROMPT = `You are a web search retrieval assistant.
 
-Your primary task is to retrieve up-to-date information from the internet based on the user's input query.
+Your output is for another AI model, not the final user-facing answer.
 
 Requirements:
-1. Actively attempt web retrieval first. Use internet search to find relevant and recent information.
-2. Summarize and synthesize findings clearly and concisely.
-3. Explicitly cite sources for key points whenever possible (for example: website/publication name, article title, and URL if available).
-4. Distinguish confirmed facts from uncertain or incomplete information.
-5. Do not fabricate search results, sources, or real-time data.
-6. If you cannot access reliable real-time information from the internet, clearly and honestly state that real-time retrieval was not possible, then provide the best available general information with that limitation noted.
+1. Retrieve current, relevant information for the query.
+2. Return concise findings only. Do not write a polished final answer.
+3. Include source title, publisher/site, URL, and publication or update date when available.
+4. Prefer authoritative and recent sources.
+5. Distinguish confirmed facts from uncertain or incomplete information.
+6. Do not fabricate results, sources, dates, or URLs.
+7. If results are weak, say exactly what is missing instead of broadening the search yourself.
 
-Output style:
-- Start with a brief direct answer.
-- Then provide a structured summary of findings.
-- End with a "Sources" section listing the origin of the information used.`;
+Output format:
+- Findings: 3-6 concise bullet points.
+- Sources: numbered list with title, site, URL, and date when available.
+- Gaps: one short sentence if important information could not be verified.`;

package/dist/client/23.65ea8c37cd4b884b.js

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+
+"use strict";(self.webpackChunk_nocobase_plugin_ai=self.webpackChunk_nocobase_plugin_ai||[]).push([["23"],{8178:function(e,t,r){r.r(t),r.d(t,{BusinessReportModal:function(){return j},BusinessReportModalFooter:function(){return P}});var n=r(9155),o=r.n(n),a=r(2059),i=r(7375),l=r(3485),u=r(9488),c=r(9305),s=r(1020);function d(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 p(e,t,r,n,o,a,i){try{var l=e[a](i),u=l.value}catch(e){r(e);return}l.done?t(u):Promise.resolve(u).then(n,o)}function f(e){return function(){var t=this,r=arguments;return new Promise(function(n,o){var a=e.apply(t,r);function i(e){p(a,n,o,i,l,"next",e)}function l(e){p(a,n,o,i,l,"throw",e)}i(void 0)})}}function y(e,t){for(var r=0;r<t.length;r++){var n=t[r];n.enumerable=n.enumerable||!1,n.configurable=!0,"value"in n&&(n.writable=!0),Object.defineProperty(e,n.key,n)}}function m(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function v(e){return(v=Object.setPrototypeOf?Object.getPrototypeOf:function(e){return e.__proto__||Object.getPrototypeOf(e)})(e)}function b(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){m(e,t,r[t])})}return e}function g(e,t){return t=null!=t?t:{},Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):(function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t.push.apply(t,r)}return t})(Object(t)).forEach(function(r){Object.defineProperty(e,r,Object.getOwnPropertyDescriptor(t,r))}),e}function h(e,t){return(h=Object.setPrototypeOf||function(e,t){return e.__proto__=t,e})(e,t)}function w(e,t){return function(e){if(Array.isArray(e))return e}(e)||function(e,t){var r,n,o=null==e?null:"u">typeof Symbol&&e[Symbol.iterator]||e["@@iterator"];if(null!=o){var a=[],i=!0,l=!1;try{for(o=o.call(e);!(i=(r=o.next()).done)&&(a.push(r.value),!t||a.length!==t);i=!0);}catch(e){l=!0,n=e}finally{try{i||null==o.return||o.return()}finally{if(l)throw n}}return a}}(e,t)||function(e,t){if(e){if("string"==typeof e)return d(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 d(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 k(){try{var e=!Boolean.prototype.valueOf.call(Reflect.construct(Boolean,[],function(){}))}catch(e){}return(k=function(){return!!e})()}function O(e,t){var r,n,o,a={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype),l=Object.defineProperty;return l(i,"next",{value:u(0)}),l(i,"throw",{value:u(1)}),l(i,"return",{value:u(2)}),"function"==typeof Symbol&&l(i,Symbol.iterator,{value:function(){return this}}),i;function u(l){return function(u){var c=[l,u];if(r)throw TypeError("Generator is already executing.");for(;i&&(i=0,c[0]&&(a=0)),a;)try{if(r=1,n&&(o=2&c[0]?n.return:c[0]?n.throw||((o=n.return)&&o.call(n),0):n.next)&&!(o=o.call(n,c[1])).done)return o;switch(n=0,o&&(c=[2&c[0],o.value]),c[0]){case 0:case 1:o=c;break;case 4:return a.label++,{value:c[1],done:!1};case 5:a.label++,n=c[1],c=[0];continue;case 7:c=a.ops.pop(),a.trys.pop();continue;default:if(!(o=(o=a.trys).length>0&&o[o.length-1])&&(6===c[0]||2===c[0])){a=0;continue}if(3===c[0]&&(!o||c[1]>o[0]&&c[1]<o[3])){a.label=c[1];break}if(6===c[0]&&a.label<o[1]){a.label=o[1],o=c;break}if(o&&a.label<o[2]){a.label=o[2],a.ops.push(c);break}o[2]&&a.ops.pop(),a.trys.pop();continue}c=t.call(e,a)}catch(e){c=[6,e],n=0}finally{r=o=0}if(5&c[0])throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}}var E=function(e){var t,r;if("function"!=typeof e&&null!==e)throw TypeError("Super expression must either be null or a function");function n(){var e,t,r;if(!(this instanceof n))throw TypeError("Cannot call a class as a function");return t=n,r=arguments,t=v(t),m(e=function(e,t){var r;if(t&&("object"==((r=t)&&"u">typeof Symbol&&r.constructor===Symbol?"symbol":typeof r)||"function"==typeof t))return t;if(void 0===e)throw ReferenceError("this hasn't been initialised - super() hasn't been called");return e}(this,k()?Reflect.construct(t,r||[],v(this).constructor):t.apply(this,r)),"state",{error:null,resetKey:e.props.resetKey}),e}return n.prototype=Object.create(e&&e.prototype,{constructor:{value:n,writable:!0,configurable:!0}}),e&&h(n,e),t=[{key:"render",value:function(){return this.state.error?this.props.fallback(this.state.error):this.props.children}}],r=[{key:"getDerivedStateFromError",value:function(e){return{error:e}}},{key:"getDerivedStateFromProps",value:function(e,t){return e.resetKey!==t.resetKey?{error:null,resetKey:e.resetKey}:null}}],t&&y(n.prototype,t),r&&y(n,r),n}(o().Component),S=function(e){var t,r,d,p,y,m,v,h,k,E,S,P,j,M,T,B,R,x,A=e.tool,_=(0,u.kj)(),C=a.theme.useToken().token,L=(t=(0,u.kj)(),r=(0,l.useApp)().apiClient.auth.getLocale(),d=(0,n.useMemo)(function(){return(0,s.cZ)(g(b({},null==A?void 0:A.args),{generatedAt:null==A?void 0:A.invokeEndTime}))},[null==A?void 0:A.args,null==A?void 0:A.invokeEndTime]),p=!["done","confirmed"].includes(A.invokeStatus),y=!!((null==d?void 0:d.title)||(null==d?void 0:d.summary)||(null==d?void 0:d.markdown)),v=(m=w((0,n.useState)(null),2))[0],h=m[1],E=(k=w((0,n.useState)(null),2))[0],S=k[1],P=(0,n.useMemo)(function(){return JSON.stringify({title:(null==d?void 0:d.title)||"",summary:(null==d?void 0:d.summary)||"",markdown:(null==d?void 0:d.markdown)||"",charts:(null==d?void 0:d.charts)||[],generatedAt:(null==d?void 0:d.generatedAt)||null})},[d]),(0,n.useEffect)(function(){h(null),S(null)},[A.id]),(0,n.useEffect)(function(){"success"===A.status&&"done"===A.invokeStatus&&y&&P!==E&&(h(d),S(P))},[y,d,P,E,A.invokeStatus,A.status]),M=(null==(j=v||d)?void 0:j.title)||t("Business analysis report"),T=(0,n.useMemo)(function(){return(0,s.wP)(j,{locale:"string"==typeof r?r:void 0,t:t})},[j,r,t]),B=(0,n.useMemo)(function(){return(0,s.e4)(j)},[j]),R=(0,n.useMemo)(function(){return p?g(b({},j),{charts:[]}):j},[j,p]),x=(0,n.useMemo)(function(){return{content:(null==R?void 0:R.markdown)?(0,s.wP)(R,{locale:"string"==typeof r?r:void 0,t:t}):"# ".concat(M,"\n\n").concat((null==j?void 0:j.summary)||t("Generating business analysis report...")),type:"text",messageId:A.id}},[null==j?void 0:j.summary,r,R,t,M,A.id]),!y&&p?{displayReport:j,isGenerating:p,markdown:T,fileName:B,previewMessage:x,title:M,locale:"string"==typeof r?r:void 0,invalid:!1,loading:!0}:{displayReport:j,isGenerating:p,markdown:T,fileName:B,previewMessage:x,title:M,locale:"string"==typeof r?r:void 0,invalid:!(null==j?void 0:j.title)&&!(null==j?void 0:j.markdown)&&!p,loading:!1}),G=L.previewMessage,F=L.displayReport,D=L.isGenerating,I=L.title,K=L.invalid,N=L.loading,H=L.markdown,X="calc(100vh - ".concat(C.controlHeightLG+6*C.marginXXL,"px)"),J=w((0,n.useState)(""),2),U=J[0],W=J[1],z=(0,n.useMemo)(function(){return JSON.stringify({title:(null==F?void 0:F.title)||"",summary:(null==F?void 0:F.summary)||"",markdown:(null==F?void 0:F.markdown)||"",charts:(null==F?void 0:F.charts)||[],generatedAt:(null==F?void 0:F.generatedAt)||null})},[F]);return((0,n.useEffect)(function(){var e=!1;return f(function(){var t,r;return O(this,function(n){switch(n.label){case 0:if(!(null==F?void 0:F.markdown)||D)return W(""),[2];n.label=1;case 1:return n.trys.push([1,3,,4]),[4,(0,s.UV)(F,{locale:L.locale,t:_})];case 2:if(t=n.sent(),e)return[2];return W(function(e){return e===t?e:t}),[3,4];case 3:return r=n.sent(),e||(console.error("Failed to build business report HTML:",r),W("")),[3,4];case 4:return[2]}})})(),function(){e=!0}},[F,z,D,L.locale,_]),N)?o().createElement(a.Result,{icon:o().createElement(i.LoadingOutlined,{spin:!0}),title:_("Generating business analysis report..."),subTitle:_("The report modal will update in real time as new content arrives.")}):K?o().createElement(a.Alert,{type:"error",showIcon:!0,message:_("Invalid report definition")}):o().createElement("div",null,o().createElement("div",null,o().createElement("div",{style:{paddingRight:C.paddingSM}},o().createElement(a.Typography.Title,{level:4,style:{marginBottom:C.marginXXS}},I,D?o().createElement(a.Spin,{indicator:o().createElement(i.LoadingOutlined,{spin:!0}),size:"small",style:{marginLeft:C.marginSM}}):null),F.summary?o().createElement(a.Typography.Paragraph,{type:"secondary",style:{marginBottom:0}},F.summary):D?o().createElement(a.Typography.Paragraph,{type:"secondary",style:{marginBottom:0}},_("The report modal will update in real time as new content arrives.")):null)),o().createElement(a.Tabs,{style:{height:X},tabBarStyle:{marginBottom:C.marginSM},items:[{key:"preview",label:_("Preview"),children:o().createElement("div",{style:{height:X,overflow:"auto",padding:C.padding,border:"".concat(C.lineWidth,"px ").concat(C.lineType," ").concat(C.colorBorderSecondary),borderRadius:C.borderRadiusLG,background:C.colorBgContainer,color:C.colorText,boxShadow:"inset 0 ".concat(C.lineWidth,"px 0 ").concat(C.colorFillQuaternary)}},o().createElement(c.oz,{message:G},G.content))},{key:"markdown",label:_("Markdown"),children:o().createElement("pre",{style:{height:X,overflow:"auto",padding:C.padding,borderRadius:C.borderRadiusLG,background:C.colorText,color:C.colorBgContainer,whiteSpace:"pre-wrap",wordBreak:"break-word"}},H||_("Generating business analysis report..."))},{key:"html",label:_("HTML"),children:U?o().createElement("iframe",{title:I,srcDoc:U,style:{width:"100%",height:X,border:"".concat(C.lineWidth,"px ").concat(C.lineType," ").concat(C.colorBorderSecondary),borderRadius:C.borderRadiusLG,background:C.colorBgContainer}}):o().createElement(a.Result,{icon:o().createElement(i.LoadingOutlined,{spin:!0}),title:_("Generating business analysis report...")})}]}))},P=function(e){var t=e.tool,r=(0,u.kj)(),c=(0,l.useApp)(),d=a.App.useApp().message,p=c.apiClient.auth.getLocale(),y=(0,n.useMemo)(function(){return(0,s.cZ)(g(b({},null==t?void 0:t.args),{generatedAt:null==t?void 0:t.invokeEndTime}))},[null==t?void 0:t.args,null==t?void 0:t.invokeEndTime]),m=!["done","confirmed"].includes(t.invokeStatus),v=(0,n.useMemo)(function(){return(0,s.wP)(y,{locale:"string"==typeof p?p:void 0,t:r})},[p,y,r]),h=(0,n.useMemo)(function(){return(0,s.e4)(y)},[y]),k=w((0,n.useState)(!1),2),E=k[0],S=k[1],P=!!(null==y?void 0:y.markdown);return o().createElement(a.Space,{wrap:!0,style:{justifyContent:"flex-end",width:"100%"}},o().createElement(a.Button,{icon:o().createElement(i.FileMarkdownOutlined,null),disabled:m||!P,onClick:function(){return(0,s.MT)("".concat(h,".md"),v,"text/markdown;charset=utf-8")}},r("Download Markdown")),o().createElement(a.Button,{icon:o().createElement(i.FileTextOutlined,null),disabled:m||!P||E,onClick:function(){return f(function(){var e;return O(this,function(t){switch(t.label){case 0:S(!0),t.label=1;case 1:return t.trys.push([1,,3,4]),[4,(0,s.UV)(y,{printMode:!0,locale:"string"==typeof p?p:void 0,t:r})];case 2:return e=t.sent(),(0,s.MT)("".concat(h,".html"),e,"text/html;charset=utf-8"),[3,4];case 3:return S(!1),[7];case 4:return[2]}})})()}},r("Download HTML")),o().createElement(a.Button,{type:"primary",icon:o().createElement(i.FilePdfOutlined,null),loading:E,disabled:m||!P||E,onClick:function(){return f(function(){return O(this,function(e){switch(e.label){case 0:S(!0),e.label=1;case 1:return e.trys.push([1,3,4,5]),[4,(0,s.Y_)(y,{locale:"string"==typeof p?p:void 0,t:r})];case 2:return e.sent()||d.error(r("Popup blocked. Please allow popups and try again.")),[3,5];case 3:return console.error("Failed to print business report:",e.sent()),d.error(r("Popup blocked. Please allow popups and try again.")),[3,5];case 4:return S(!1),[7];case 5:return[2]}})})()}},r("Print PDF")))},j=function(e){var t=e.tool,r=(0,u.kj)(),n="".concat(t.id,":").concat(t.invokeStatus,":").concat(JSON.stringify(t.args));return o().createElement(E,{resetKey:n,fallback:function(e){return o().createElement(a.Alert,{type:"error",showIcon:!0,message:r("Invalid report definition"),description:e.message})}},o().createElement(S,{tool:t}))};j.displayName="BusinessReportModal",P.displayName="BusinessReportModalFooter"}}]);