@nocobase/plugin-flow-engine 2.1.0-alpha.1 → 2.1.0-beta.1

package/dist/ai/docs/runjs/resource/single-record-resource.md

@@ -0,0 +1,169 @@
+# SingleRecordResource
+
+Resource for **single records**: data is one object; supports get by primary key, create/update (save), and destroy. Use for detail, form, and other "single record" scenarios. Unlike [MultiRecordResource](./multi-record-resource.md), SingleRecordResource's `getData()` returns a single object; use `setFilterByTk(id)` for primary key; `save()` auto-calls create or update based on `isNewRecord`.
+
+**Inheritance**: FlowResource → APIResource → BaseRecordResource → SingleRecordResource.
+
+**Create with**: `ctx.makeResource('SingleRecordResource')` or `ctx.initResource('SingleRecordResource')`. Before use call `setResourceName('collectionName')`; for operations by primary key call `setFilterByTk(id)`; RunJS injects `ctx.api`.
+
+---
+
+## Use cases
+
+| Scenario | Description |
+|----------|-------------|
+| **Detail block** | Detail block uses SingleRecordResource by default; loads single record by primary key |
+| **Form block** | Create/edit forms use SingleRecordResource; `save()` auto-distinguishes create vs update |
+| **JSBlock detail** | Load single user, order, etc. in JSBlock and render custom UI |
+| **Association resources** | Load associated single record with `users.profile`; requires `setSourceId(parentRecordId)` |
+
+---
+
+## Data format
+
+- `getData()` returns a **single record object**, i.e. the get API `data` field
+- `getMeta()` returns metadata (if any)
+
+---
+
+## Resource name and primary key
+
+| Method | Description |
+|--------|-------------|
+| `setResourceName(name)` / `getResourceName()` | Resource name, e.g. `'users'`, `'users.profile'` (association) |
+| `setSourceId(id)` / `getSourceId()` | Parent record id for association resources (e.g. `users.profile` needs users primary key) |
+| `setDataSourceKey(key)` / `getDataSourceKey()` | Data source key (for multiple data sources) |
+| `setFilterByTk(tk)` / `getFilterByTk()` | Current record primary key; after set, `isNewRecord` is false |
+
+---
+
+## State
+
+| Property/Method | Description |
+|-----------------|-------------|
+| `isNewRecord` | Whether in "create" state (true when filterByTk not set or just created) |
+
+---
+
+## Request params (filter / fields)
+
+| Method | Description |
+|--------|-------------|
+| `setFilter(filter)` / `getFilter()` | Filter (when not new) |
+| `setFields(fields)` / `getFields()` | Requested fields |
+| `setAppends(appends)` / `getAppends()` / `addAppends` / `removeAppends` | Association expansion |
+
+---
+
+## CRUD
+
+| Method | Description |
+|--------|-------------|
+| `refresh()` | Request get with current `filterByTk`; update `getData()`. No request when in new state. |
+| `save(data, options?)` | Create when new, otherwise update; optional `{ refresh: false }` to skip auto refresh |
+| `destroy(options?)` | Delete by current `filterByTk` and clear local data |
+| `runAction(actionName, options)` | Call any resource action |
+
+---
+
+## Config and events
+
+| Method | Description |
+|--------|-------------|
+| `setSaveActionOptions(options)` | Request config for save |
+| `on('refresh', fn)` / `on('saved', fn)` | Fired when refresh completes or after save |
+
+---
+
+## Examples
+
+### Basic get and update
+
+```js
+ctx.initResource('SingleRecordResource');
+ctx.resource.setResourceName('users');
+ctx.resource.setFilterByTk(1);
+await ctx.resource.refresh();
+const user = ctx.resource.getData();
+
+// Update
+await ctx.resource.save({ name: 'Jane' });
+```
+
+### Create record
+
+```js
+const newRes = ctx.makeResource('SingleRecordResource');
+newRes.setResourceName('users');
+await newRes.save({ name: 'Bob', email: 'bob@example.com' });
+```
+
+### Delete record
+
+```js
+ctx.resource.setResourceName('users');
+ctx.resource.setFilterByTk(1);
+await ctx.resource.destroy();
+// After destroy, getData() is null
+```
+
+### Association expansion and fields
+
+```js
+ctx.resource.setResourceName('users');
+ctx.resource.setFilterByTk(1);
+ctx.resource.setFields(['id', 'nickname', 'email']);
+ctx.resource.setAppends(['profile', 'roles']);
+await ctx.resource.refresh();
+const user = ctx.resource.getData();
+```
+
+### Association resource (e.g. users.profile)
+
+```js
+const res = ctx.makeResource('SingleRecordResource');
+res.setResourceName('users.profile');
+res.setSourceId(ctx.record?.id); // Parent record primary key
+res.setFilterByTk(profileId);    // Can omit filterByTk if profile is hasOne
+await res.refresh();
+const profile = res.getData();
+```
+
+### save without auto refresh
+
+```js
+await ctx.resource.save({ status: 'active' }, { refresh: false });
+// After save, no refresh; getData() keeps previous value
+```
+
+### Listen to refresh / saved events
+
+```js
+ctx.resource?.on?.('refresh', () => {
+  const data = ctx.resource.getData();
+  ctx.render(<div>User: {data?.nickname}</div>);
+});
+ctx.resource?.on?.('saved', (savedData) => {
+  ctx.message.success('Saved');
+});
+await ctx.resource?.refresh?.();
+```
+
+---
+
+## Notes
+
+- **setResourceName required**: Must call `setResourceName('collectionName')` before use; otherwise request URL cannot be built.
+- **filterByTk and isNewRecord**: When `setFilterByTk` is not set, `isNewRecord` is true; `refresh()` does not send request; `save()` does create.
+- **Association resources**: When resource name is `parent.child` (e.g. `users.profile`), call `setSourceId(parentPrimaryKey)` first.
+- **getData is object**: Single record API returns `data` as record object; `getData()` returns that object; after `destroy()` it is null.
+
+---
+
+## Related
+
+- [ctx.resource](../context/resource.md) - Resource instance in current context
+- [ctx.initResource()](../context/init-resource.md) - Initialize and bind to ctx.resource
+- [ctx.makeResource()](../context/make-resource.md) - Create resource instance without binding
+- [APIResource](./api-resource.md) - Generic API resource, request by URL
+- [MultiRecordResource](./multi-record-resource.md) - For data tables/lists, CRUD, pagination

package/dist/ai/docs/runjs/resource/sql-resource.md

@@ -0,0 +1,170 @@
+# SQLResource
+
+Resource that runs queries via **saved SQL config** or **dynamic SQL**; data comes from `flowSql:run` / `flowSql:runById`, etc. Use for reports, stats, custom SQL lists. Unlike [MultiRecordResource](./multi-record-resource.md), SQLResource does not depend on data tables and runs SQL directly; supports pagination, parameter binding, template variables (`{{ctx.xxx}}`), and result type control.
+
+**Inheritance**: FlowResource → APIResource → BaseRecordResource → SQLResource.
+
+**Create with**: `ctx.makeResource('SQLResource')` or `ctx.initResource('SQLResource')`. For saved-config execution call `setFilterByTk(uid)` (SQL template uid); for debugging use `setDebug(true)` + `setSQL(sql)` to run SQL directly; RunJS injects `ctx.api`.
+
+---
+
+## Use cases
+
+| Scenario | Description |
+|----------|-------------|
+| **Reports / stats** | Complex aggregations, cross-table queries, custom metrics |
+| **JSBlock custom list** | Use SQL for special filter, sort, or join; render custom UI |
+| **Chart block** | Save SQL template to drive chart data source; supports pagination |
+| **vs ctx.sql** | Use SQLResource when you need pagination, events, or reactive data; use `ctx.sql.run()` / `ctx.sql.runById()` for simple one-off queries |
+
+---
+
+## Data format
+
+- `getData()` returns different formats based on `setSQLType()`:
+  - `selectRows` (default): **array**, multiple rows
+  - `selectRow`: **single object**
+  - `selectVar`: **scalar value** (e.g. COUNT, SUM)
+- `getMeta()` returns pagination meta: `page`, `pageSize`, `count`, `totalPage`, etc.
+
+---
+
+## SQL config and execution mode
+
+| Method | Description |
+|--------|-------------|
+| `setFilterByTk(uid)` | SQL template uid to run (for runById; must be saved first) |
+| `setSQL(sql)` | Raw SQL (only in debug mode `setDebug(true)` for runBySQL) |
+| `setSQLType(type)` | Result type: `'selectVar'` / `'selectRow'` / `'selectRows'` |
+| `setDebug(enabled)` | When true, refresh uses `runBySQL()`; otherwise `runById()` |
+| `run()` | Calls `runBySQL()` or `runById()` depending on debug |
+| `runBySQL()` | Run current `setSQL` SQL (requires setDebug(true)) |
+| `runById()` | Run saved SQL template by current uid |
+
+---
+
+## Params and context
+
+| Method | Description |
+|--------|-------------|
+| `setBind(bind)` | Bound variables; object with `:name`, array with `?` |
+| `setLiquidContext(ctx)` | Template context (Liquid) for `{{ctx.xxx}}` |
+| `setFilter(filter)` | Extra filter (passed in request data) |
+| `setDataSourceKey(key)` | Data source key (for multiple data sources) |
+
+---
+
+## Pagination
+
+| Method | Description |
+|--------|-------------|
+| `setPage(page)` / `getPage()` | Current page (default 1) |
+| `setPageSize(size)` / `getPageSize()` | Page size (default 20) |
+| `next()` / `previous()` / `goto(page)` | Change page and trigger refresh |
+
+Use `{{ctx.limit}}` and `{{ctx.offset}}` in SQL for pagination; SQLResource injects `limit` and `offset` into context.
+
+---
+
+## Data fetch and events
+
+| Method | Description |
+|--------|-------------|
+| `refresh()` | Run SQL (runById or runBySQL); write result to `setData(data)` and update meta; emit `'refresh'` |
+| `runAction(actionName, options)` | Call underlying APIs (e.g. `getBind`, `run`, `runById`) |
+| `on('refresh', fn)` / `on('loading', fn)` | Fired when refresh completes or loading starts |
+
+---
+
+## Examples
+
+### Run by saved template (runById)
+
+```js
+ctx.initResource('SQLResource');
+ctx.resource.setFilterByTk('active-users-report'); // Saved SQL template uid
+ctx.resource.setBind({ status: 'active' });
+await ctx.resource.refresh();
+const data = ctx.resource.getData();
+const meta = ctx.resource.getMeta(); // page, pageSize, count, etc.
+```
+
+### Debug mode: run SQL directly (runBySQL)
+
+```js
+const res = ctx.makeResource('SQLResource');
+res.setDebug(true);
+res.setSQL('SELECT * FROM users WHERE status = :status LIMIT {{ctx.limit}}');
+res.setBind({ status: 'active' });
+await res.refresh();
+const data = res.getData();
+```
+
+### Pagination and navigation
+
+```js
+ctx.resource.setFilterByTk('user-list-sql');
+ctx.resource.setPageSize(20);
+await ctx.resource.refresh();
+
+// Navigate pages
+await ctx.resource.next();
+await ctx.resource.previous();
+await ctx.resource.goto(3);
+```
+
+### Result types
+
+```js
+// Multiple rows (default)
+ctx.resource.setSQLType('selectRows');
+const rows = ctx.resource.getData(); // [{...}, {...}]
+
+// Single row
+ctx.resource.setSQLType('selectRow');
+const row = ctx.resource.getData(); // {...}
+
+// Single value (e.g. COUNT)
+ctx.resource.setSQLType('selectVar');
+const total = ctx.resource.getData(); // 42
+```
+
+### Use template variables
+
+```js
+ctx.defineProperty('minId', { get: () => 10 });
+const res = ctx.makeResource('SQLResource');
+res.setDebug(true);
+res.setSQL('SELECT * FROM users WHERE id > {{ctx.minId}} LIMIT {{ctx.limit}}');
+await res.refresh();
+```
+
+### Listen to refresh event
+
+```js
+ctx.resource?.on?.('refresh', () => {
+  const data = ctx.resource.getData();
+  ctx.render(<ul>{data?.map((r) => <li key={r.id}>{r.name}</li>)}</ul>);
+});
+await ctx.resource?.refresh?.();
+```
+
+---
+
+## Notes
+
+- **runById requires saved template**: `setFilterByTk(uid)` uid must be a saved SQL template ID; save via `ctx.sql.save({ uid, sql })`.
+- **Debug mode needs permission**: `setDebug(true)` uses `flowSql:run`; requires SQL config permission. `runById` only needs login.
+- **refresh debounce**: Multiple `refresh()` calls in the same event loop only run the last one to avoid duplicate requests.
+- **Parameter binding prevents injection**: Use `setBind()` with `:name` / `?` placeholders; avoid string concatenation to prevent SQL injection.
+
+---
+
+## Related
+
+- [ctx.sql](../context/sql.md) - SQL execution and management; `ctx.sql.runById` for simple one-off queries
+- [ctx.resource](../context/resource.md) - Resource instance in current context
+- [ctx.initResource()](../context/init-resource.md) - Initialize and bind to ctx.resource
+- [ctx.makeResource()](../context/make-resource.md) - Create resource instance without binding
+- [APIResource](./api-resource.md) - Generic API resource
+- [MultiRecordResource](./multi-record-resource.md) - For data tables/lists

package/dist/ai/docs/runjs/window.md

@@ -0,0 +1,20 @@
+# window
+
+The following are available on `window`:
+
+* `setTimeout` / `clearTimeout`
+* `setInterval` / `clearInterval`
+* `console`
+* `Math`
+* `Date`
+* `FormData`
+* `addEventListener`
+* `open` (only `http:`, `https:`, or `about:blank` allowed)
+* `location` (read-only, safe navigation)
+* `navigator`
+
+Only basic, safe DOM query and creation are supported:
+
+* `createElement(tagName)`
+* `querySelector(selectors)`
+* `querySelectorAll(selectors)`

package/dist/ai/tools/getContextApis.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/getContextApis.js

@@ -0,0 +1,62 @@
+/**
+ * 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 getContextApis_exports = {};
+__export(getContextApis_exports, {
+  default: () => getContextApis_default
+});
+module.exports = __toCommonJS(getContextApis_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var getContextApis_default = (0, import_ai.defineTools)({
+  scope: "SPECIFIED",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("ai.tools.getContextApis.title")}}`,
+    about: `{{t("ai.tools.getContextApis.about")}}`
+  },
+  definition: {
+    name: "getContextApis",
+    description: "Get available API methods from context",
+    schema: import_zod.z.object({})
+  },
+  invoke: async (ctx, _args, id) => {
+    const { toolCallResults } = ctx.action.params.values || {};
+    const { result } = (toolCallResults == null ? void 0 : toolCallResults.find((item) => item.id === id)) ?? {};
+    if (toolCallResults && result) {
+      return {
+        status: "success",
+        content: JSON.stringify(result)
+      };
+    } else {
+      return {
+        status: "success",
+        content: "{}"
+      };
+    }
+  }
+});

package/dist/ai/tools/getContextEnvs.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/getContextEnvs.js

@@ -0,0 +1,62 @@
+/**
+ * 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 getContextEnvs_exports = {};
+__export(getContextEnvs_exports, {
+  default: () => getContextEnvs_default
+});
+module.exports = __toCommonJS(getContextEnvs_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var getContextEnvs_default = (0, import_ai.defineTools)({
+  scope: "SPECIFIED",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("ai.tools.getContextEnvs.title")}}`,
+    about: `{{t("ai.tools.getContextEnvs.about")}}`
+  },
+  definition: {
+    name: "getContextEnvs",
+    description: "Get current page/block/flow model metadata from context",
+    schema: import_zod.z.object({})
+  },
+  invoke: async (ctx, _args, id) => {
+    const { toolCallResults } = ctx.action.params.values || {};
+    const { result } = (toolCallResults == null ? void 0 : toolCallResults.find((item) => item.id === id)) ?? {};
+    if (toolCallResults && result) {
+      return {
+        status: "success",
+        content: JSON.stringify(result)
+      };
+    } else {
+      return {
+        status: "success",
+        content: "{}"
+      };
+    }
+  }
+});

package/dist/ai/tools/getContextVars.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/getContextVars.js

@@ -0,0 +1,78 @@
+/**
+ * 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 getContextVars_exports = {};
+__export(getContextVars_exports, {
+  default: () => getContextVars_default
+});
+module.exports = __toCommonJS(getContextVars_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var getContextVars_default = (0, import_ai.defineTools)({
+  scope: "SPECIFIED",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("ai.tools.getContextVars.title")}}`,
+    about: `{{t("ai.tools.getContextVars.about")}}`
+  },
+  definition: {
+    name: "getContextVars",
+    description: `Available variables from context.
+
+Variables are references only and do not contain actual values.
+You must explicitly resolve values via \`await ctx.getVar(path)\`.
+
+The \`path\` supports progressive drilling (dot-notation).
+When you only need a specific field, prefer a more precise path
+instead of fetching the entire object, e.g.
+\`await ctx.getVar('ctx.popup.record.id')\` rather than
+\`await ctx.getVar('ctx.popup.record')\`.`,
+    schema: import_zod.z.object({
+      path: import_zod.z.string().optional().describe(
+        "Dot-notated variable path. Supports progressive drilling. Prefer the most specific path when only a subset of data is needed."
+      ),
+      depth: import_zod.z.number().optional().describe(
+        "Maximum traversal depth when exploring variables. Default is 3. Use smaller depth when the target structure is known."
+      )
+    })
+  },
+  invoke: async (ctx, _args, id) => {
+    const { toolCallResults } = ctx.action.params.values || {};
+    const { result } = (toolCallResults == null ? void 0 : toolCallResults.find((item) => item.id === id)) ?? {};
+    if (toolCallResults && result) {
+      return {
+        status: "success",
+        content: JSON.stringify(result)
+      };
+    } else {
+      return {
+        status: "success",
+        content: "{}"
+      };
+    }
+  }
+});

package/dist/ai/tools/lintAndTestJS.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/lintAndTestJS.js

@@ -0,0 +1,64 @@
+/**
+ * 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 lintAndTestJS_exports = {};
+__export(lintAndTestJS_exports, {
+  default: () => lintAndTestJS_default
+});
+module.exports = __toCommonJS(lintAndTestJS_exports);
+var import_ai = require("@nocobase/ai");
+var import_zod = require("zod");
+var lintAndTestJS_default = (0, import_ai.defineTools)({
+  scope: "SPECIFIED",
+  execution: "frontend",
+  defaultPermission: "ALLOW",
+  introduction: {
+    title: `{{t("ai.tools.lintAndTestJS.title")}}`,
+    about: `{{t("ai.tools.lintAndTestJS.about")}}`
+  },
+  definition: {
+    name: "lintAndTestJS",
+    description: "Lint, sandbox-check and trial-run a JavaScript snippet. Returns success/failure with diagnostics. Call this tool BEFORE outputting final code to verify it works.",
+    schema: import_zod.z.object({
+      code: import_zod.z.string().describe("The JavaScript/JSX code to preview and validate")
+    })
+  },
+  invoke: async (ctx, _args, id) => {
+    const { toolCallResults } = ctx.action.params.values || {};
+    const { result } = (toolCallResults == null ? void 0 : toolCallResults.find((item) => item.id === id)) ?? {};
+    if (toolCallResults && result) {
+      return {
+        status: result.status ?? "error",
+        content: JSON.stringify(result.content ?? {})
+      };
+    } else {
+      return {
+        status: "error",
+        content: JSON.stringify({ success: false, message: "Preview execution failed: no result returned" })
+      };
+    }
+  }
+});