@shwfed/config 3.0.6 → 3.0.8

package/dist/runtime/components/form/utils/ai-field-tools.js

@@ -1,8 +1,11 @@
 import { JSONSchema, ParseResult, Schema } from "effect";
 import { coerceFromString } from "../../../share/coerce-from-string.js";
 import { Area } from "../../../share/layout.js";
+import { renderCelScope } from "../../../utils/cel-context.js";
+import { getCelCatalog } from "../../../utils/cel-catalog.js";
 import { defaultFormConfig } from "../schema.js";
 import { registerFormVariablesIfAbsent } from "./form-vars.js";
+import { buildFormCelScope } from "./cel-scope.js";
 import { activeFields } from "./resolve.js";
 const HARNESS_KEYS = ["id", "compatibilityDate"];
 const PlaceInput = Schema.Struct({
@@ -40,12 +43,12 @@ function growColumns(layout) {
 function ensureFormConfig(deps) {
   return deps.read() ?? defaultFormConfig();
 }
-export function createQueryFieldTools(deps) {
+export function createFormFieldTools(deps) {
   return [
     // ---- 信息获取 ----
     {
-      name: "list_available_query_field_types",
-      description: "List the form field types you can insert into the table's search-condition form. Returns each type's name. Use this first to discover what fields exist; for a field's full field contract and defaults, follow up with `describe_specific_query_field_type`. Deprecated types are hidden.",
+      name: "list_available_field_types",
+      description: "List the form field types you can insert into this form. Returns each type's name and, when set, a one-line description of when to use it. Use this first to discover what fields exist; for a field's full field contract and defaults, follow up with `describe_specific_field_type`. Deprecated types are hidden.",
       inputJsonSchema: {
         type: "object",
         properties: {},
@@ -53,18 +56,17 @@ export function createQueryFieldTools(deps) {
       },
       execute: () => activeFields().map((f) => {
         const entry = { type: f.type, name: f.metadata.name };
-        const description = f.metadata.description;
-        if (description !== void 0) entry.description = description;
+        if (f.metadata.description !== void 0) entry.description = f.metadata.description;
         return entry;
       })
     },
     {
-      name: "describe_specific_query_field_type",
-      description: "Return, for one search-condition field type: the JSON Schema (without `id`/`compatibilityDate` \u2014 managed by the harness), the default values, and the default placement size `w`/`h` (each `{ initial, min, max }`; `w` is in grid columns, `h` in rows). Call this before `insert_query_field` / `place_query_field` to learn the field contract and how big to place it \u2014 use `w.initial` / `h.initial` as the placed area's width / height. Deprecated types are not accepted.",
+      name: "describe_specific_field_type",
+      description: "Return, for one form field type: the JSON Schema (without `id`/`compatibilityDate` \u2014 managed by the harness), the default values, the default placement size `w`/`h` (each `{ initial, min, max }`; `w` is in grid columns, `h` in rows), and \u2014 when the type has one \u2014 a prose `guide` (when to use it, config recipe, gotchas). Call this before `insert_field` / `place_field` to learn the field contract and how big to place it \u2014 use `w.initial` / `h.initial` as the placed area's width / height. Deprecated types are not accepted.",
       inputJsonSchema: {
         type: "object",
         properties: {
-          type: { type: "string", description: "A `type` value from `list_available_query_field_types`." }
+          type: { type: "string", description: "A `type` value from `list_available_field_types`." }
         },
         required: ["type"],
         additionalProperties: false
@@ -76,7 +78,7 @@ export function createQueryFieldTools(deps) {
         }
         const entry = activeFields().find((f) => f.type === type);
         if (!entry) {
-          return `describe failed: query field type "${type}" is not available. Call list_available_query_field_types to see what is.`;
+          return `describe failed: field type "${type}" is not available. Call list_available_field_types to see what is.`;
         }
         const publicSchema = publicFieldSchema(entry, deps.configure);
         let jsonSchema;
@@ -85,22 +87,37 @@ export function createQueryFieldTools(deps) {
         } catch {
           jsonSchema = "(schema unavailable)";
         }
-        return {
+        const result = {
           schema: jsonSchema,
           defaults: entry.defaults?.() ?? null,
           // Default placement size from the field's registry metadata. The
           // system prompt requires the model to use `w.initial` / `h.initial`
           // as the placed area's width / height; `min`/`max` bound what it may
-          // adjust to. (`place_query_field` itself only guards overlap — the
-          // "use the initial size" rule lives in the prompt, not the tool.)
+          // adjust to. (`place_field` itself only guards overlap — the "use the
+          // initial size" rule lives in the prompt, not the tool.)
           w: entry.metadata.w,
           h: entry.metadata.h
         };
+        if (entry.prompt !== void 0) result.guide = entry.prompt;
+        return result;
       }
     },
     {
-      name: "list_query_fields",
-      description: "Return the search-condition form's current fields (each with its `id`) joined with its placement: `placement` is the field's grid area `[[x1,y1],[x2,y2]]`, or `null` when the field exists but has NOT been placed yet (unplaced fields are not rendered). `grid` reports the layout's current column count. Use this to discover ids, see what still needs placing, and find a free area before calling `place_query_field`.",
+      name: "describe_form_settings",
+      description: "Return the form's CEL scope for the current context: `celScope` lists every variable available to this form's expressions (name / type / description \u2014 e.g. `form` for sibling field values, `now`, plus any host variables), and `celFunctions` is the CEL operator & function catalog. Call this before writing any CEL in a field (default values, visibility, options, validation) so what you write matches what the editor validates against.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false
+      },
+      execute: () => ({
+        celScope: renderCelScope(buildFormCelScope(deps.configure)),
+        celFunctions: getCelCatalog()
+      })
+    },
+    {
+      name: "list_fields",
+      description: "Return the form's current fields (each with its `id`) joined with its placement: `placement` is the field's grid area `[[x1,y1],[x2,y2]]`, or `null` when the field exists but has NOT been placed yet (unplaced fields are not rendered). `grid` reports the layout's current column count. Use this to discover ids, see what still needs placing, and find a free area before calling `place_field`.",
       inputJsonSchema: {
         type: "object",
         properties: {},
@@ -123,8 +140,8 @@ export function createQueryFieldTools(deps) {
     },
     // ---- 配置 ----
     {
-      name: "insert_query_field",
-      description: "Insert one new field into the table's search-condition form. Provide `type` (from `list_available_query_field_types`) plus the field's fields as described by `describe_specific_query_field_type`. Do NOT include `id` or `compatibilityDate` \u2014 the harness assigns them. The field is created UNPLACED: it exists but is not rendered until you place it with `place_query_field`. On validation failure the tool returns the issues; fix them and call again.",
+      name: "insert_field",
+      description: "Insert one new field into the form. Provide `type` (from `list_available_field_types`) plus the field's fields as described by `describe_specific_field_type`. Do NOT include `id` or `compatibilityDate` \u2014 the harness assigns them. The field is created UNPLACED: it exists but is not rendered until you place it with `place_field`. On validation failure the tool returns the issues; fix them and call again.",
       inputJsonSchema: {
         type: "object",
         properties: {
@@ -146,12 +163,12 @@ export function createQueryFieldTools(deps) {
         }
         const entry = activeFields().find((f) => f.type === type);
         if (!entry) {
-          return `insert failed: query field type "${type}" is not available. Call list_available_query_field_types to see what is.`;
+          return `insert failed: field type "${type}" is not available. Call list_available_field_types to see what is.`;
         }
         const publicSchema = publicFieldSchema(entry, deps.configure);
         const verdict = decode(publicSchema, raw);
         if (!verdict.ok) {
-          return `insert failed for type "${type}". Fix these and call insert_query_field again:
+          return `insert failed for type "${type}". Fix these and call insert_field again:
 ${verdict.report}`;
         }
         const fc = ensureFormConfig(deps);
@@ -167,8 +184,8 @@ ${verdict.report}`;
       }
     },
     {
-      name: "delete_query_fields",
-      description: "Delete one or more search-condition fields by id. Call `list_query_fields` first to obtain ids. Fields are matched by id only. On any unknown id the call is rejected without writing; fix and call again. Deleting a field also removes it from the layout (its placement is stripped).",
+      name: "delete_fields",
+      description: "Delete one or more fields by id. Call `list_fields` first to obtain ids. Fields are matched by id only. On any unknown id the call is rejected without writing; fix and call again. Deleting a field also removes it from the layout (its placement is stripped).",
       inputJsonSchema: {
         type: "object",
         properties: {
@@ -176,7 +193,7 @@ ${verdict.report}`;
             type: "array",
             items: { type: "string", minLength: 1 },
             minItems: 1,
-            description: "Field ids to delete. Get them from `list_query_fields` first."
+            description: "Field ids to delete. Get them from `list_fields` first."
           }
         },
         required: ["ids"],
@@ -205,7 +222,7 @@ ${verdict.report}`;
         const existing = new Set(fields.map((f) => f.id));
         for (const id of ids) {
           if (!existing.has(id)) {
-            return `delete failed: query field id "${id}" is not present. Call list_query_fields to see current ids.`;
+            return `delete failed: field id "${id}" is not present. Call list_fields to see current ids.`;
           }
         }
         const cfg = fc;
@@ -226,12 +243,12 @@ ${verdict.report}`;
       }
     },
     {
-      name: "place_query_field",
-      description: "Place a field into the search-condition layout at grid coordinates you choose. `area` is `[[x1,y1],[x2,y2]]` using 1-based grid lines (top-left inclusive, bottom-right exclusive); e.g. a field occupying columns 1\u20132 on row 1 is `[[1,1],[3,2]]`. The field must already exist (call `insert_query_field` first). The harness rejects an `area` that overlaps another field \u2014 pick a free spot (use `list_query_fields` to see current placements) and call again. Placing an already-placed field MOVES it. The layout column count grows to fit your placements; how many columns the search bar uses is up to you and the guidance you were given.",
+      name: "place_field",
+      description: "Place a field into the form layout at grid coordinates you choose. `area` is `[[x1,y1],[x2,y2]]` using 1-based grid lines (top-left inclusive, bottom-right exclusive); e.g. a field occupying columns 1\u20132 on row 1 is `[[1,1],[3,2]]`. The field must already exist (call `insert_field` first). The harness rejects an `area` that overlaps another field \u2014 pick a free spot (use `list_fields` to see current placements) and call again. Placing an already-placed field MOVES it. The layout column count grows to fit your placements; how many columns the form uses is up to you and the guidance you were given.",
       inputJsonSchema: {
         type: "object",
         properties: {
-          id: { type: "string", description: "The field id to place (from `list_query_fields`)." },
+          id: { type: "string", description: "The field id to place (from `list_fields`)." },
           area: {
             type: "array",
             description: "Grid area `[[x1,y1],[x2,y2]]`, 1-based grid lines, bottom-right exclusive.",
@@ -246,28 +263,28 @@ ${verdict.report}`;
       execute: (input) => {
         const verdict = decode(PlaceInput, input ?? {});
         if (!verdict.ok) {
-          return `place failed. Fix these and call place_query_field again:
+          return `place failed. Fix these and call place_field again:
 ${verdict.report}`;
         }
         const { id, area } = verdict.value;
         const fc = deps.read();
         if (!fc) {
-          return "place failed: there is no query form yet. Call insert_query_field first.";
+          return "place failed: there is no form yet. Call insert_field first.";
         }
         const fields = Array.isArray(fc.fields) ? fc.fields : [];
         if (!fields.some((f) => f.id === id)) {
-          return `place failed: query field id "${id}" is not present. Call list_query_fields to see ids.`;
+          return `place failed: field id "${id}" is not present. Call list_fields to see ids.`;
         }
         const layouts = Array.isArray(fc.layouts) ? fc.layouts : [];
         const ls = layouts[0];
         if (!ls || !ls.layout) {
-          return "place failed: the query form has no layout to place into.";
+          return "place failed: the form has no layout to place into.";
         }
         const placements = { ...ls.layout.placements ?? {} };
         for (const [pid, p] of Object.entries(placements)) {
           if (pid === id) continue;
           if (overlaps(area, p.area)) {
-            return `place failed: area overlaps field "${pid}" at ${JSON.stringify(p.area)}. Pick a free area (see list_query_fields) and call again.`;
+            return `place failed: area overlaps field "${pid}" at ${JSON.stringify(p.area)}. Pick a free area (see list_fields) and call again.`;
           }
         }
         placements[id] = { area };

package/dist/runtime/components/form/utils/resolve.d.ts

@@ -1,6 +1,7 @@
 import type { Component } from 'vue';
 import type { Effect, Schema } from 'effect';
 import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+import { type RegistryEdge } from '../../../share/define-registry.js';
 type AnySchema = Schema.Schema<any, any, never>;
 type SchemaFactory = (configure: (env: Environment) => void) => AnySchema;
 /**
@@ -54,6 +55,12 @@ export type FieldSizeRange = Readonly<{
 export type FieldMetadata = Readonly<{
     name: string;
     icon: string;
+    /**
+     * 一句话说明该字段的适用场景；AI 在 `list_available_field_types` 工具里看到。
+     * **可选** —— 缺失时工具返回里省略该字段（人类 picker / 旧调用点不受影响）。
+     * 镜像 `ColumnMetadata.description`。
+     */
+    description?: string;
     w: FieldSizeRange;
     h: FieldSizeRange;
     /**
@@ -115,6 +122,10 @@ export type FieldEntry = Readonly<{
      * the field is created with only `{ id, type, compatibilityDate }`.
      */
     defaults?: FieldDefaults;
+    /** The field's `prompt.md` (L2 fragment) raw text, when authored. */
+    prompt?: string;
+    /** Recursion edges the AI scope cursor walks (empty for leaf fields). */
+    edges: ReadonlyArray<RegistryEdge>;
 }>;
 export declare const FIELDS: ReadonlyArray<FieldEntry>;
 export declare function allFieldSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;

package/dist/runtime/components/form/utils/resolve.js

@@ -11,6 +11,10 @@ const runtimeModules = import.meta.glob(
   "../fields/*/*/runtime.vue",
   { eager: true, import: "default", exhaustive: true }
 );
+const promptModules = import.meta.glob(
+  "../fields/*/*/prompt.md",
+  { eager: true, query: "?raw", import: "default", exhaustive: true }
+);
 const sourceKey = (type, compatibilityDate) => `${type}@${compatibilityDate}`;
 const registry = defineRegistry({
   hostName: "shwfed-form",
@@ -18,6 +22,12 @@ const registry = defineRegistry({
   schemaModules,
   configModules,
   runtimeModules,
+  promptModules,
+  // Validate declared `edges` keys against the built schema (field.table /
+  // .list / .collapsible / .tabs / .actions declare them). Inert configure —
+  // the edge check only reads top-level field names.
+  buildSchemaForEdges: (mod) => mod.schema(() => {
+  }),
   // An entry is deprecated by one of two rules:
   //   (a) another entry shares its `type` with a strictly greater
   //       `compatibilityDate` — date-versioned supersession;
@@ -95,7 +105,9 @@ function getFields() {
     ...e.supersededBy !== void 0 ? { supersededBy: e.supersededBy } : {},
     migrate: e.module.migrate,
     ...e.module.migrateFrom !== void 0 ? { migrateFrom: e.module.migrateFrom } : {},
-    defaults: e.module.defaults
+    defaults: e.module.defaults,
+    ...e.prompt !== void 0 ? { prompt: e.prompt } : {},
+    edges: e.module.edges ?? []
   }));
   return _fields;
 }

package/dist/runtime/components/operations/2026-06-09/com.shwfed.operation.alert/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-09";
 export declare const metadata: {
     readonly name: "确认弹窗";
     readonly icon: "fluent:chat-warning-20-regular";
+    readonly description: "弹出确认弹窗；用户确认则继续执行后续操作，取消则中止本次触发链";
 };
 export declare function schema(_configure: (env: Environment) => void): Schema.Struct<{
     message: Schema.suspend<readonly [{

package/dist/runtime/components/operations/2026-06-09/com.shwfed.operation.alert/schema.js

@@ -5,7 +5,8 @@ export const type = "com.shwfed.operation.alert";
 export const compatibilityDate = "2026-06-09";
 export const metadata = {
   name: "\u786E\u8BA4\u5F39\u7A97",
-  icon: "fluent:chat-warning-20-regular"
+  icon: "fluent:chat-warning-20-regular",
+  description: "\u5F39\u51FA\u786E\u8BA4\u5F39\u7A97\uFF1B\u7528\u6237\u786E\u8BA4\u5219\u7EE7\u7EED\u6267\u884C\u540E\u7EED\u64CD\u4F5C\uFF0C\u53D6\u6D88\u5219\u4E2D\u6B62\u672C\u6B21\u89E6\u53D1\u94FE"
 };
 export function schema(_configure) {
   return Schema.Struct({

package/dist/runtime/components/operations/2026-06-11/com.shwfed.operation.http.request.json/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-11";
 export declare const metadata: {
     readonly name: "发送请求";
     readonly icon: "fluent:cloud-arrow-up-20-regular";
+    readonly description: "发送一个 HTTP 请求；其解析后的响应体作为链步输出，后续步骤可用 steps 引用";
     readonly output: "HTTP 响应（解析后的 JSON）";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{

package/dist/runtime/components/operations/2026-06-11/com.shwfed.operation.http.request.json/schema.js

@@ -7,6 +7,7 @@ export const compatibilityDate = "2026-06-11";
 export const metadata = {
   name: "\u53D1\u9001\u8BF7\u6C42",
   icon: "fluent:cloud-arrow-up-20-regular",
+  description: "\u53D1\u9001\u4E00\u4E2A HTTP \u8BF7\u6C42\uFF1B\u5176\u89E3\u6790\u540E\u7684\u54CD\u5E94\u4F53\u4F5C\u4E3A\u94FE\u6B65\u8F93\u51FA\uFF0C\u540E\u7EED\u6B65\u9AA4\u53EF\u7528 steps \u5F15\u7528",
   // This op publishes its parsed response as a chain-step output, so later
   // trigger rows can reference it via `steps[?"<row-id>"]`.
   output: "HTTP \u54CD\u5E94\uFF08\u89E3\u6790\u540E\u7684 JSON\uFF09"

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.http.download/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-15";
 export declare const metadata: {
     readonly name: "下载文件";
     readonly icon: "fluent:arrow-download-20-regular";
+    readonly description: "发起一个下载请求，把响应保存为文件";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     expression: Schema.Schema<string, string, never>;

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.http.download/schema.js

@@ -6,7 +6,8 @@ export const type = "com.shwfed.operation.http.download";
 export const compatibilityDate = "2026-06-15";
 export const metadata = {
   name: "\u4E0B\u8F7D\u6587\u4EF6",
-  icon: "fluent:arrow-download-20-regular"
+  icon: "fluent:arrow-download-20-regular",
+  description: "\u53D1\u8D77\u4E00\u4E2A\u4E0B\u8F7D\u8BF7\u6C42\uFF0C\u628A\u54CD\u5E94\u4FDD\u5B58\u4E3A\u6587\u4EF6"
   // NOTE: no `output` — a download saves a file; it publishes nothing for later
   // trigger rows to read back (unlike the request op, whose parsed JSON becomes
   // a chain-step output).

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.navigation/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-06-15";
 export declare const metadata: {
     readonly name: "导航";
     readonly icon: "fluent:link-20-regular";
+    readonly description: "导航到一个链接，可选当前页或新标签页打开";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     url: Schema.Schema<string, string, never>;

package/dist/runtime/components/operations/2026-06-15/com.shwfed.operation.navigation/schema.js

@@ -6,7 +6,8 @@ export const type = "com.shwfed.operation.navigation";
 export const compatibilityDate = "2026-06-15";
 export const metadata = {
   name: "\u5BFC\u822A",
-  icon: "fluent:link-20-regular"
+  icon: "fluent:link-20-regular",
+  description: "\u5BFC\u822A\u5230\u4E00\u4E2A\u94FE\u63A5\uFF0C\u53EF\u9009\u5F53\u524D\u9875\u6216\u65B0\u6807\u7B7E\u9875\u6253\u5F00"
   // NOTE: no `output` — navigation publishes nothing for later trigger rows
   // (it ends in a page navigation, not a value the chain can read back).
 };

package/dist/runtime/components/operations/2026-07-06/com.shwfed.operation.table.add-row/schema.d.ts

@@ -5,6 +5,7 @@ export declare const compatibilityDate: "2026-07-06";
 export declare const metadata: {
     readonly name: "新增一行";
     readonly icon: "fluent:add-20-regular";
+    readonly description: "向目标表格本地追加一行（不触发服务端请求）";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     newRow: Schema.optional<Schema.Schema<string, string, never>>;

package/dist/runtime/components/operations/2026-07-06/com.shwfed.operation.table.add-row/schema.js

@@ -5,7 +5,8 @@ export const type = "com.shwfed.operation.table.add-row";
 export const compatibilityDate = "2026-07-06";
 export const metadata = {
   name: "\u65B0\u589E\u4E00\u884C",
-  icon: "fluent:add-20-regular"
+  icon: "fluent:add-20-regular",
+  description: "\u5411\u76EE\u6807\u8868\u683C\u672C\u5730\u8FFD\u52A0\u4E00\u884C\uFF08\u4E0D\u89E6\u53D1\u670D\u52A1\u7AEF\u8BF7\u6C42\uFF09"
 };
 export function schema(configure) {
   const CelRow = Expression({ configure, resultType: "map" });

package/dist/runtime/components/operations/utils/resolve.d.ts

@@ -28,6 +28,11 @@ export type OperationHandler = (params: unknown, ctx: OperationContext) => Effec
 export type OperationMetadata = Readonly<{
     name: string;
     icon: string;
+    /**
+     * 一句话说明该操作的适用场景；供 AI trigger 接线工具显示。**可选** —— 缺失时
+     * 省略。镜像 `ColumnMetadata.description`。
+     */
+    description?: string;
     /**
      * Present iff this operation publishes a chain-step output (`ctx.step.publish`)
      * for later trigger rows to read via `steps[?"<row-id>"]` — the value is the
@@ -51,9 +56,21 @@ export type OperationEntry = Readonly<{
      * rather than exposing it through `operationHandlers`.
      */
     handler?: OperationHandler;
+    /**
+     * The op's `prompt.md` (L2 fragment) raw text, when authored. Surfaced by the
+     * AI `list_operations` tool as `guide` — operations have no per-type describe
+     * step (only 5 exist), so the fragment rides the listing.
+     */
+    prompt?: string;
 }>;
 export declare const OPERATIONS: ReadonlyArray<OperationEntry>;
 export declare function findOperation(type: string, compatibilityDate: string): OperationEntry | undefined;
+export declare function latestOperationByType(): ReadonlyArray<OperationEntry>;
+/**
+ * AI 工具可见的操作集合：按 `type` 取最新 `compatibilityDate`。镜像
+ * `activeColumns()`；操作目前无 deprecation 机制，所以「最新版本」即活跃集。
+ */
+export declare function activeOperations(): ReadonlyArray<OperationEntry>;
 /**
  * Build the `OperationHandlers` for a host's `provideEventTarget`, one per
  * parameterized operation the host declares it exposes. Each handler keys on

package/dist/runtime/components/operations/utils/resolve.js

@@ -3,6 +3,10 @@ const schemaModules = import.meta.glob(
   "../*/*/schema.{ts,js}",
   { eager: true, exhaustive: true }
 );
+const promptModules = import.meta.glob(
+  "../*/*/prompt.md",
+  { eager: true, query: "?raw", import: "default", exhaustive: true }
+);
 const runtimeModules = import.meta.glob(
   "../*/*/runtime.{ts,js}",
   { eager: true, exhaustive: true }
@@ -51,6 +55,7 @@ function compute() {
       throw new Error(`[shwfed-operations] compatibilityDate "${mod.compatibilityDate}" does not match folder "${date}"`);
     }
     const runtime = findSiblingOptional(runtimeModules, date, type, "runtime.ts");
+    const prompt = findSiblingOptional(promptModules, date, type, "prompt.md");
     entries.push({
       type: mod.type,
       compatibilityDate: mod.compatibilityDate,
@@ -58,7 +63,8 @@ function compute() {
       schema: mod.schema,
       defaults: mod.defaults,
       config: findSibling(configModules, date, type, "config.vue"),
-      handler: runtime?.handler
+      handler: runtime?.handler,
+      ...prompt !== void 0 ? { prompt } : {}
     });
   }
   cached = entries;
@@ -72,6 +78,17 @@ export const OPERATIONS = new Proxy([], {
 export function findOperation(type, compatibilityDate) {
   return compute().find((o) => o.type === type && o.compatibilityDate === compatibilityDate);
 }
+export function latestOperationByType() {
+  const byType = /* @__PURE__ */ new Map();
+  for (const o of compute()) {
+    const prev = byType.get(o.type);
+    if (!prev || o.compatibilityDate > prev.compatibilityDate) byType.set(o.type, o);
+  }
+  return [...byType.values()];
+}
+export function activeOperations() {
+  return latestOperationByType();
+}
 export function operationHandlers(exposed, ctx) {
   const handlers = {};
   for (const { type, compatibilityDate } of exposed) {

package/dist/runtime/components/table/ai-l1.md

@@ -0,0 +1,38 @@
+你正在配置一个「表格块」内嵌的 Table。表格由三部分组成：通用配置（数据源）、列、搜索条件。发现式推进：先 `describe_general_settings` / `list_available_column_types` 看清可用件，再逐项写入；配完 `leave_node` 返回页面。
+
+## 通用配置（数据源）
+
+`describe_general_settings` 查看 `dataSource`（request / data / total，各带自己的 CEL 作用域）、`rowKey`、分页，以及 CEL 函数目录；再用 `set_data_source` / `set_row_key` / `set_pagination` / `set_display_name` 写入。
+
+利用 API 名称配置 `displayName`（内部名称）。`dataSource`：
+
+- `request`：HTTP 请求表达式，形如
+  ```cel
+  http
+    .post('<完整 URL>')          // GET 用 .get；端点须为绝对 URL，用 hostname 变量拼接，勿写文档里的 {{env}}
+    .header('<key>', '<value>')  // 设置请求头
+    .query(query)                // query = 全部搜索条件，放在最前
+    .query('<key>', <value>)     // 值可为 string | number | optional<...>；同名 query 不覆盖而是并列
+    // 分页：如 .query('page_index', pageIndex + 1).query('page_size', pageSize)（pageIndex 从 0 开始）
+    // POST 且发 JSON：.header('Content-Type', 'application/json').body({ ... })
+  ```
+  API 文档里的示例查询参数只作演示，**不要**硬编码。
+- `data`：指向响应中的列表。例如响应 `{ "data": { "list": [...] } }`，`data` 设为 `json.?data.?list`（optional 语法，字段缺失时安全）。
+- `total`：指向响应中服务端**总数**，如 `json.?data.?total`。找不到就留空，并调用工具关闭分页。
+
+## 列
+
+找到最外层列表：每个元素是一行，其字段通常各成一列。用 `list_available_column_types` → `describe_specific_column_type` 选型（优先文本、数值、日期），`insert_column` 新增（不要传 `id` / `compatibilityDate`），`list_columns` / `delete_columns` 管理。
+
+- 只读列配 `accessor`，用 `row`（当前行）。accessor **相对列表元素**书写，用 optional 语法：例如元素 `{ "foo": "bar", "buz": { "bao": "zoo" } }`，展示 `bar` 用 `row.?foo`，展示 `zoo` 用 `row.?buz.?bao`。
+- 至少选一列设 `grow: true`。
+- 金额：用数值列，`align: right`、`displayMode: monoThousand`，宽度约 200 或 `grow`。
+- 普通数字：数值列，`align: center`。
+- 日期时间：日期列，时间列宽 140、日期列宽 120，`align: center`。
+- 用户名 / ID / 类型等短字段：酌情 `align: center`。
+
+## 搜索条件
+
+`table.query` 本质是一个表单，用通用表单字段族的工具增改字段：`list_available_field_types` → `describe_specific_field_type` 选型，`insert_field` 新增（字段创建后处于「未放置」态，不渲染），再 `place_field` 放入网格（`area` 用 `[[x1,y1],[x2,y2]]`，1 基、右下不含）。`list_fields` / `delete_fields` 管理。
+
+搜索条件应排除分页、排序，仅含业务字段。优先文本输入、数字（范围）输入、日期（时间）范围。遇到「多选一 / 多选多」考虑单选 / 多选；选项不确定时**向用户提问**。按钮触发目标（搜索 / 重置）用 `describe_event_targets` 查询后接线。

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.actions/schema.d.ts

@@ -5,9 +5,16 @@ import { registerRowVariablesIfAbsent } from '../../../utils/shared.js';
 import type { ColumnDefDeps } from '../../../utils/resolve.js';
 export declare const type: "com.shwfed.table.column.actions";
 export declare const compatibilityDate: "2026-04-14";
+export declare const edges: readonly [{
+    readonly key: "items";
+    readonly host: "actions";
+    readonly label: "操作列";
+    readonly self: true;
+}];
 export declare const metadata: {
     readonly name: "操作";
     readonly icon: "fluent:cursor-click-20-regular";
+    readonly description: "每行渲染一组操作按钮（按钮 CEL 可访问 `row` / `index`）";
 };
 export declare const registerRowVariables: typeof registerRowVariablesIfAbsent;
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.actions/schema.js

@@ -4,9 +4,13 @@ import { ActionSchemaFields } from "../../../../actions/schema.js";
 import { columnIdentityFields, registerRowVariablesIfAbsent } from "../../../utils/shared.js";
 export const type = "com.shwfed.table.column.actions";
 export const compatibilityDate = "2026-04-14";
+export const edges = [
+  { key: "items", host: "actions", label: "\u64CD\u4F5C\u5217", self: true }
+];
 export const metadata = {
   name: "\u64CD\u4F5C",
-  icon: "fluent:cursor-click-20-regular"
+  icon: "fluent:cursor-click-20-regular",
+  description: "\u6BCF\u884C\u6E32\u67D3\u4E00\u7EC4\u64CD\u4F5C\u6309\u94AE\uFF08\u6309\u94AE CEL \u53EF\u8BBF\u95EE `row` / `index`\uFF09"
 };
 export const registerRowVariables = registerRowVariablesIfAbsent;
 export function schema(configure) {

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.date/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-04-14";
 export declare const metadata: {
     readonly name: "日期";
     readonly icon: "fluent:calendar-ltr-20-regular";
+    readonly description: "按指定格式展示日期 / 时间的只读列";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     align: Schema.optionalWith<Schema.Literal<["left", "center", "right"]>, {

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.date/schema.js

@@ -5,7 +5,8 @@ export const type = "com.shwfed.table.column.date";
 export const compatibilityDate = "2026-04-14";
 export const metadata = {
   name: "\u65E5\u671F",
-  icon: "fluent:calendar-ltr-20-regular"
+  icon: "fluent:calendar-ltr-20-regular",
+  description: "\u6309\u6307\u5B9A\u683C\u5F0F\u5C55\u793A\u65E5\u671F / \u65F6\u95F4\u7684\u53EA\u8BFB\u5217"
 };
 export function schema(configure) {
   return Schema.Struct({

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.icon/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-04-14";
 export declare const metadata: {
     readonly name: "图标";
     readonly icon: "fluent:shapes-20-regular";
+    readonly description: "按 CEL 表达式展示一个 Iconify 图标（可配颜色）的只读列";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     accessor: Schema.optional<Schema.Schema<string, string, never>>;

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.icon/schema.js

@@ -4,7 +4,8 @@ export const type = "com.shwfed.table.column.icon";
 export const compatibilityDate = "2026-04-14";
 export const metadata = {
   name: "\u56FE\u6807",
-  icon: "fluent:shapes-20-regular"
+  icon: "fluent:shapes-20-regular",
+  description: "\u6309 CEL \u8868\u8FBE\u5F0F\u5C55\u793A\u4E00\u4E2A Iconify \u56FE\u6807\uFF08\u53EF\u914D\u989C\u8272\uFF09\u7684\u53EA\u8BFB\u5217"
 };
 export function schema(configure) {
   return Schema.Struct({

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.markdown/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-04-14";
 export declare const metadata: {
     readonly name: "MD";
     readonly icon: "fluent:markdown-20-regular";
+    readonly description: "渲染行内 Markdown（支持 `{{ 表达式 }}` 插值）的只读列";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     title: Schema.suspend<readonly [{

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.markdown/schema.js

@@ -5,7 +5,8 @@ export const type = "com.shwfed.table.column.markdown";
 export const compatibilityDate = "2026-04-14";
 export const metadata = {
   name: "MD",
-  icon: "fluent:markdown-20-regular"
+  icon: "fluent:markdown-20-regular",
+  description: "\u6E32\u67D3\u884C\u5185 Markdown\uFF08\u652F\u6301 `{{ \u8868\u8FBE\u5F0F }}` \u63D2\u503C\uFF09\u7684\u53EA\u8BFB\u5217"
 };
 const isCopyExpressionType = (t) => t === "string" || t === "dyn" || t.startsWith("optional");
 export function schema(configure) {

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.number/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-04-14";
 export declare const metadata: {
     readonly name: "数值";
     readonly icon: "fluent:number-symbol-20-regular";
+    readonly description: "数值只读列，支持千分位等宽 / 中文大写等展示模式与小数位控制";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     align: Schema.optionalWith<Schema.Literal<["left", "center", "right"]>, {

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.number/schema.js

@@ -4,7 +4,8 @@ export const type = "com.shwfed.table.column.number";
 export const compatibilityDate = "2026-04-14";
 export const metadata = {
   name: "\u6570\u503C",
-  icon: "fluent:number-symbol-20-regular"
+  icon: "fluent:number-symbol-20-regular",
+  description: "\u6570\u503C\u53EA\u8BFB\u5217\uFF0C\u652F\u6301\u5343\u5206\u4F4D\u7B49\u5BBD / \u4E2D\u6587\u5927\u5199\u7B49\u5C55\u793A\u6A21\u5F0F\u4E0E\u5C0F\u6570\u4F4D\u63A7\u5236"
 };
 export function schema(configure) {
   return Schema.Struct({

package/dist/runtime/components/table/columns/2026-04-14/com.shwfed.table.column.select/schema.d.ts

@@ -7,6 +7,7 @@ export declare const compatibilityDate: "2026-04-14";
 export declare const metadata: {
     readonly name: "选择";
     readonly icon: "fluent:checkbox-checked-20-regular";
+    readonly description: "行选择列（单选 / 多选勾选框），可按 CEL 控制行是否可选";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
     mode: Schema.optionalWith<Schema.Literal<["radio", "checkbox"]>, {