@shwfed/config 2.12.0 → 2.12.1

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.month/config.vue

@@ -2,6 +2,7 @@
 import { Icon } from "@iconify/vue";
 import { computed } from "vue";
 import { format as formatDate } from "date-fns";
+import { DISABLE_DATE_EDITOR_RESULT, INPUT_DATE_VARS } from "../../../../../share/disabled-date";
 import { Button } from "../../../../ui/button";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
@@ -492,6 +493,27 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
       </Field>
     </div>
 
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template #tooltip>
+          <Markdown
+            :source="fieldDescription('disabledDate')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("disabledDate") }}
+      </FieldLabel>
+      <ExpressionEditor
+        :model-value="value.disabledDate ?? ''"
+        placeholder="例：input < now"
+        :result-type="[...DISABLE_DATE_EDITOR_RESULT]"
+        :extra-vars="INPUT_DATE_VARS"
+        class="min-h-10"
+        @update:model-value="(v) => value = { ...value, disabledDate: v.length > 0 ? v : void 0 }"
+      />
+    </Field>
+
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">
         <template #tooltip>

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.month/config.vue.d.ts

@@ -41,6 +41,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";
@@ -103,6 +104,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly validations?: readonly {
             readonly message: readonly [{
                 readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.month/runtime.vue

@@ -5,6 +5,7 @@ import { computed, ref } from "vue";
 import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { makeDisabledDatePredicate } from "../../../../../utils/disabled-date";
 import { getLocalizedText } from "../../../../../share/locale";
 import { DatePicker, DATE_PICKER_DEFAULT_FORMATS } from "../../../../ui/date-picker";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
@@ -70,6 +71,9 @@ const shortcuts = computed(() => {
     }
   }));
 });
+const disabledDate = computed(
+  () => makeDisabledDatePredicate(props.config.disabledDate, (input) => Effect.runSync($cel(props.config.disabledDate, { form: formScope.state.value ?? {}, input })))
+);
 const uncontrolled = ref(void 0);
 const model = computed({
   get: () => {
@@ -130,6 +134,7 @@ const model = computed({
       :value-format="config.valueFormat"
       :placeholder="placeholderText"
       :disabled="isDisabled"
+      :disabled-date="disabledDate"
       :shortcuts="shortcuts"
     />
     <FieldMessages

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.month/schema.d.ts

@@ -77,6 +77,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     binding: Schema.optional<Schema.refine<string, typeof Schema.String>>;
     disabled: Schema.optional<Schema.Schema<string, string, never>>;
     readonly: Schema.optional<Schema.Schema<string, string, never>>;
+    disabledDate: Schema.optional<Schema.Schema<string, string, never>>;
     derived: Schema.optional<Schema.Struct<{
         mode: Schema.Literal<["formula", "prefill"]>;
         expression: Schema.Schema<string, string, never>;

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.month/schema.js

@@ -1,4 +1,5 @@
 import { Schema } from "effect";
+import { DISABLE_DATE_RESULT, registerInputDateIfAbsent } from "../../../../../share/disabled-date.js";
 import { Expression } from "../../../../../share/expression.js";
 import { Locale } from "../../../../../share/locale.js";
 import { commonFieldFields, derivedField, FieldOrientationSchema } from "../../../utils/common.js";
@@ -28,6 +29,13 @@ export function presetSchema(configure) {
 }
 export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });
+  const DisabledDate = Expression({
+    configure: (env) => {
+      configure(env);
+      registerInputDateIfAbsent(env);
+    },
+    resultType: DISABLE_DATE_RESULT
+  });
   const Preset = presetSchema(configure);
   return Schema.Struct({
     type: Schema.Literal(type),
@@ -58,6 +66,10 @@ export function schema(configure) {
       title: "\u53EA\u8BFB\u6761\u4EF6",
       description: "\u8FD4\u56DE `true` \u65F6\u4EC5\u4EE5\u7EAF\u6587\u672C\u5C55\u793A\u5F53\u524D\u503C"
     })),
+    disabledDate: Schema.optional(DisabledDate.annotations({
+      title: "\u7981\u7528\u65E5\u671F",
+      description: "\u9010\u4E2A\u65E5\u671F\u5224\u5B9A\u662F\u5426\u53EF\u9009\uFF1B\u53D8\u91CF `input` \u4E3A\u5019\u9009\u6708\u4EFD\uFF08\u8BE5\u6708 1 \u53F7\uFF09\u3002\u8FD4\u56DE `true` \u65F6\u7981\u7528\uFF0C\u8FD4\u56DE `false`\u3001\u7A7A\u503C\u6216\u4E0D\u586B\u65F6\u53EF\u9009"
+    })),
     derived: derivedField(configure, "string"),
     format: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
       title: "\u5C55\u793A\u683C\u5F0F",

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/config.d.vue.ts

@@ -34,6 +34,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";
@@ -105,6 +106,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/config.vue

@@ -2,6 +2,7 @@
 import { Icon } from "@iconify/vue";
 import { format as formatDate } from "date-fns";
 import { computed } from "vue";
+import { DISABLE_DATE_EDITOR_RESULT, INPUT_DATE_VARS } from "../../../../../share/disabled-date";
 import { Button } from "../../../../ui/button";
 import { ExpressionEditor } from "../../../../ui/expression-editor";
 import DerivedValueEditor from "../../../DerivedValueEditor.vue";
@@ -644,6 +645,27 @@ const valueFormatExample = computed(() => previewFormat(value.value.valueFormat
       </Field>
     </div>
 
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template #tooltip>
+          <Markdown
+            :source="fieldDescription('disabledDate')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("disabledDate") }}
+      </FieldLabel>
+      <ExpressionEditor
+        :model-value="value.disabledDate ?? ''"
+        placeholder="例：input < now"
+        :result-type="[...DISABLE_DATE_EDITOR_RESULT]"
+        :extra-vars="INPUT_DATE_VARS"
+        class="min-h-10"
+        @update:model-value="(v) => value = { ...value, disabledDate: v.length > 0 ? v : void 0 }"
+      />
+    </Field>
+
     <Field orientation="vertical">
       <FieldLabel class="text-xs text-zinc-500">
         <template #tooltip>

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/config.vue.d.ts

@@ -34,6 +34,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";
@@ -105,6 +106,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {},
         } | undefined;
         readonly format?: string | undefined;
         readonly valueFormat?: string | undefined;
+        readonly disabledDate?: string | undefined;
         readonly rangeSeparatorIcon?: string | undefined;
         readonly startPlaceholder?: readonly [{
             readonly locale: "zh";

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/runtime.vue

@@ -5,6 +5,7 @@ import { computed, ref } from "vue";
 import { useI18n } from "vue-i18n";
 import { cel as _rawCel } from "../../../../../utils/cel";
 import { celBindings, injectCELContext } from "../../../../../utils/cel-context";
+import { makeDisabledDatePredicate } from "../../../../../utils/disabled-date";
 import { getLocalizedText } from "../../../../../share/locale";
 import { DATE_RANGE_PICKER_DEFAULT_FORMATS, DateRangePicker } from "../../../../ui/date-range-picker";
 import { Field, FieldLabel, FieldMessages } from "../../../../ui/field";
@@ -77,6 +78,9 @@ const shortcuts = computed(() => {
     }
   }));
 });
+const disabledDate = computed(
+  () => makeDisabledDatePredicate(props.config.disabledDate, (input) => Effect.runSync($cel(props.config.disabledDate, { form: formScope.state.value ?? {}, input })))
+);
 function asRange(raw) {
   if (!Array.isArray(raw) || raw.length !== 2) return void 0;
   const [a, b] = raw;
@@ -162,6 +166,7 @@ const readonlyText = computed(() => {
       :end-placeholder="endPlaceholderText"
       :range-separator-icon="config.rangeSeparatorIcon"
       :disabled="isDisabled"
+      :disabled-date="disabledDate"
       :shortcuts="shortcuts"
     />
     <FieldMessages

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/schema.d.ts

@@ -91,6 +91,7 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
     binding: Schema.optional<Schema.Union<[Schema.filter<typeof Schema.String>, Schema.filter<Schema.Tuple2<Schema.filter<typeof Schema.String>, Schema.filter<typeof Schema.String>>>]>>;
     disabled: Schema.optional<Schema.Schema<string, string, never>>;
     readonly: Schema.optional<Schema.Schema<string, string, never>>;
+    disabledDate: Schema.optional<Schema.Schema<string, string, never>>;
     derived: Schema.optional<Schema.Struct<{
         mode: Schema.Literal<["formula", "prefill"]>;
         expression: Schema.Schema<string, string, never>;

package/dist/runtime/components/form/fields/2026-05-24/com.shwfed.form.field.monthrange/schema.js

@@ -1,4 +1,5 @@
 import { Schema } from "effect";
+import { DISABLE_DATE_RESULT, registerInputDateIfAbsent } from "../../../../../share/disabled-date.js";
 import { Expression } from "../../../../../share/expression.js";
 import { Locale } from "../../../../../share/locale.js";
 import { commonFieldFields, derivedField, FieldOrientationSchema } from "../../../utils/common.js";
@@ -42,6 +43,13 @@ export function presetSchema(configure) {
 }
 export function schema(configure) {
   const CelBool = Expression({ configure, resultType: "bool" });
+  const DisabledDate = Expression({
+    configure: (env) => {
+      configure(env);
+      registerInputDateIfAbsent(env);
+    },
+    resultType: DISABLE_DATE_RESULT
+  });
   const Preset = presetSchema(configure);
   return Schema.Struct({
     type: Schema.Literal(type),
@@ -73,6 +81,10 @@ export function schema(configure) {
       title: "\u53EA\u8BFB\u6761\u4EF6",
       description: "\u8FD4\u56DE `true` \u65F6\u4EC5\u4EE5\u7EAF\u6587\u672C\u5C55\u793A\u5F53\u524D\u503C"
     })),
+    disabledDate: Schema.optional(DisabledDate.annotations({
+      title: "\u7981\u7528\u65E5\u671F",
+      description: "\u9010\u4E2A\u65E5\u671F\u5224\u5B9A\u662F\u5426\u53EF\u9009\uFF1B\u53D8\u91CF `input` \u4E3A\u5019\u9009\u6708\u4EFD\uFF08\u8BE5\u6708 1 \u53F7\uFF09\u3002\u8FD4\u56DE `true` \u65F6\u7981\u7528\uFF0C\u8FD4\u56DE `false`\u3001\u7A7A\u503C\u6216\u4E0D\u586B\u65F6\u53EF\u9009"
+    })),
     derived: derivedField(configure, "dyn"),
     format: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
       title: "\u5C55\u793A\u683C\u5F0F",

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

@@ -0,0 +1,11 @@
+import type { Environment } from '../../../vendor/cel-js/lib/index.js';
+import type { AgenticTool } from '../../../utils/ai/index.js';
+type AnyRecord = Record<string, any>;
+export interface QueryFieldToolDeps {
+    readonly read: () => AnyRecord | undefined;
+    readonly write: (next: AnyRecord) => void;
+    readonly configure: (env: Environment) => void;
+    readonly genUuid: () => string;
+}
+export declare function createQueryFieldTools(deps: QueryFieldToolDeps): AgenticTool[];
+export {};

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

@@ -0,0 +1,282 @@
+import { JSONSchema, ParseResult, Schema } from "effect";
+import { coerceFromString } from "../../../share/coerce-from-string.js";
+import { Area } from "../../../share/layout.js";
+import { defaultFormConfig } from "../schema.js";
+import { registerFormVariablesIfAbsent } from "./form-vars.js";
+import { activeFields } from "./resolve.js";
+const HARNESS_KEYS = ["id", "compatibilityDate"];
+const PlaceInput = Schema.Struct({
+  id: Schema.String.pipe(Schema.minLength(1)),
+  area: Area
+});
+function formScope(configure) {
+  return (env) => {
+    registerFormVariablesIfAbsent(env);
+    configure(env);
+  };
+}
+function publicFieldSchema(entry, configure) {
+  return entry.schema(formScope(configure)).pipe(Schema.omit(...HARNESS_KEYS));
+}
+function decode(schema, input) {
+  const result = Schema.decodeUnknownEither(schema)(coerceFromString(input, schema));
+  if (result._tag === "Right") return { ok: true, value: result.right };
+  const issues = ParseResult.ArrayFormatter.formatErrorSync(result.left);
+  const report = issues.map((i) => `- ${i.path.map(String).join(".") || "(root)"}: ${i.message}`).join("\n");
+  return { ok: false, report };
+}
+function overlaps(a, b) {
+  return a[0][0] < b[1][0] && a[1][0] > b[0][0] && a[0][1] < b[1][1] && a[1][1] > b[0][1];
+}
+function growColumns(layout) {
+  let maxCol = typeof layout.columns === "number" ? layout.columns : 1;
+  const placements = layout.placements ?? {};
+  for (const p of Object.values(placements)) {
+    const x2 = p.area[1][0];
+    if (x2 - 1 > maxCol) maxCol = x2 - 1;
+  }
+  layout.columns = Math.max(1, maxCol);
+}
+function ensureFormConfig(deps) {
+  return deps.read() ?? defaultFormConfig();
+}
+export function createQueryFieldTools(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.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false
+      },
+      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;
+        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.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {
+          type: { type: "string", description: "A `type` value from `list_available_query_field_types`." }
+        },
+        required: ["type"],
+        additionalProperties: false
+      },
+      execute: (input) => {
+        const { type } = input ?? {};
+        if (typeof type !== "string" || type.length === 0) {
+          return "describe failed: `type` must be a non-empty string.";
+        }
+        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.`;
+        }
+        const publicSchema = publicFieldSchema(entry, deps.configure);
+        let jsonSchema;
+        try {
+          jsonSchema = JSONSchema.make(publicSchema);
+        } catch {
+          jsonSchema = "(schema unavailable)";
+        }
+        return {
+          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.)
+          w: entry.metadata.w,
+          h: entry.metadata.h
+        };
+      }
+    },
+    {
+      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`.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false
+      },
+      execute: () => {
+        const fc = deps.read();
+        if (!fc) return { fields: [], grid: null };
+        const fields = Array.isArray(fc.fields) ? fc.fields : [];
+        const layout = Array.isArray(fc.layouts) ? fc.layouts[0]?.layout : void 0;
+        const placements = layout?.placements ?? {};
+        return {
+          fields: fields.map((f) => ({
+            ...f,
+            placement: placements[f.id]?.area ?? null
+          })),
+          grid: layout ? { columns: layout.columns ?? null } : null
+        };
+      }
+    },
+    // ---- 配置 ----
+    {
+      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.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {
+          type: { type: "string", description: "The field type to insert." }
+        },
+        required: ["type"],
+        additionalProperties: true
+      },
+      execute: (input) => {
+        const raw = input ?? {};
+        const { type, ...rest } = raw;
+        if (typeof type !== "string" || type.length === 0) {
+          return "insert failed: `type` must be a non-empty string.";
+        }
+        for (const k of HARNESS_KEYS) {
+          if (k in rest) {
+            return `insert failed: do not pass \`${k}\` \u2014 the harness assigns it.`;
+          }
+        }
+        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.`;
+        }
+        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:
+${verdict.report}`;
+        }
+        const fc = ensureFormConfig(deps);
+        const fields = Array.isArray(fc.fields) ? fc.fields : [];
+        const newField = {
+          id: deps.genUuid(),
+          compatibilityDate: entry.compatibilityDate,
+          ...verdict.value
+        };
+        fc.fields = [...fields, newField];
+        deps.write(fc);
+        return { id: newField.id, type };
+      }
+    },
+    {
+      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).",
+      inputJsonSchema: {
+        type: "object",
+        properties: {
+          ids: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            minItems: 1,
+            description: "Field ids to delete. Get them from `list_query_fields` first."
+          }
+        },
+        required: ["ids"],
+        additionalProperties: false
+      },
+      execute: (input) => {
+        const raw = input ?? {};
+        const ids = raw.ids;
+        if (!Array.isArray(ids) || ids.length === 0) {
+          return "delete failed: `ids` must be a non-empty array of field ids.";
+        }
+        for (const id of ids) {
+          if (typeof id !== "string" || id.length === 0) {
+            return "delete failed: every `ids` entry must be a non-empty string.";
+          }
+        }
+        const seen = /* @__PURE__ */ new Set();
+        for (const id of ids) {
+          if (seen.has(id)) {
+            return `delete failed: duplicate id "${id}" in input \u2014 dedupe and call again.`;
+          }
+          seen.add(id);
+        }
+        const fc = deps.read();
+        const fields = fc && Array.isArray(fc.fields) ? fc.fields : [];
+        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.`;
+          }
+        }
+        const cfg = fc;
+        const deleted = new Set(ids);
+        cfg.fields = fields.filter((f) => !deleted.has(f.id));
+        if (Array.isArray(cfg.layouts)) {
+          cfg.layouts = cfg.layouts.map((ls) => {
+            const placements = ls?.layout?.placements;
+            if (!placements) return ls;
+            const next = Object.fromEntries(
+              Object.entries(placements).filter(([pid]) => !deleted.has(pid))
+            );
+            return { ...ls, layout: { ...ls.layout, placements: next } };
+          });
+        }
+        deps.write(cfg);
+        return { deleted: ids, count: ids.length };
+      }
+    },
+    {
+      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.",
+      inputJsonSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "The field id to place (from `list_query_fields`)." },
+          area: {
+            type: "array",
+            description: "Grid area `[[x1,y1],[x2,y2]]`, 1-based grid lines, bottom-right exclusive.",
+            items: { type: "array", items: { type: "integer", minimum: 1 }, minItems: 2, maxItems: 2 },
+            minItems: 2,
+            maxItems: 2
+          }
+        },
+        required: ["id", "area"],
+        additionalProperties: false
+      },
+      execute: (input) => {
+        const verdict = decode(PlaceInput, input ?? {});
+        if (!verdict.ok) {
+          return `place failed. Fix these and call place_query_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.";
+        }
+        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.`;
+        }
+        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.";
+        }
+        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.`;
+          }
+        }
+        placements[id] = { area };
+        const nextLayout = { ...ls.layout, placements };
+        growColumns(nextLayout);
+        fc.layouts = [{ ...ls, layout: nextLayout }, ...layouts.slice(1)];
+        deps.write(fc);
+        return { id, area, columns: nextLayout.columns };
+      }
+    }
+  ];
+}

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

@@ -118,6 +118,21 @@ export type FieldEntry = Readonly<{
 }>;
 export declare const FIELDS: ReadonlyArray<FieldEntry>;
 export declare function allFieldSchemas(configure: (env: Environment) => void): ReadonlyArray<AnySchema>;
+export declare function latestFieldByType(): ReadonlyArray<FieldEntry>;
+/**
+ * AI 工具可见的字段集合：按 `type` 取最新版本 + 排除 `deprecated`。镜像
+ * `table/utils/resolve.ts` 的 `activeColumns()`。
+ *
+ * 两层过滤的原因：
+ *   (a) `latestFieldByType()` 解决同 `type` 多版本时只留最新版——避免 AI 拿到
+ *       已被新版本替代的旧 `compatibilityDate`（我们对 AI 隐藏 compDate）；
+ *   (b) `!deprecated` 同时屏蔽两类情况：同 type 旧日期（已由 (a) 消除），以及
+ *       跨类型迁移的源条目（`deriveEntryExtras` 给被 `migrateFrom` 指名的源都
+ *       打了 `deprecated: true`）。
+ *
+ * 人类 picker 仍走 `FIELDS`（含废弃）—— picker 要让用户选到旧字段再触发迁移。
+ */
+export declare function activeFields(): ReadonlyArray<FieldEntry>;
 export declare function findField(type: string, compatibilityDate: string): FieldEntry | undefined;
 /**
  * Finds the registry entry that has declared `(type, compatibilityDate)` as a

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

@@ -120,6 +120,19 @@ export function allFieldSchemas(configure) {
     identifier: `${entry.type}@${entry.compatibilityDate}`
   }));
 }
+export function latestFieldByType() {
+  const byType = /* @__PURE__ */ new Map();
+  for (const r of getFields()) {
+    const prev = byType.get(r.type);
+    if (!prev || r.compatibilityDate > prev.compatibilityDate) {
+      byType.set(r.type, r);
+    }
+  }
+  return [...byType.values()];
+}
+export function activeFields() {
+  return latestFieldByType().filter((e) => !e.deprecated);
+}
 export function findField(type, compatibilityDate) {
   return getFields().find((f) => f.type === type && f.compatibilityDate === compatibilityDate);
 }

package/dist/runtime/components/table/ai-generate.system.md

@@ -93,3 +93,9 @@ http
 对于日期、时间类型的字段：使用日期类型的列；对于时间，设置列宽为 140；对于日期，设置列宽为 120；将其 `align` 设置为 `center`。
 
 对于用户名、ID、各种类型等较短字段，酌情将其 `align` 设置为 `center`。
+
+### 配置搜索条件
+
+你应该根据 API 文档配置其支持的搜索条件。搜索条件应该排除分页、排序相关信息，仅包含业务逻辑。
+
+你应该首要考虑文本输入、数字输入、数字范围输入、日期范围输入、日期时间范围输入。如果你遇到了从多个值中选取一个或多个，考虑单选或者多选。如果你不能确定单选和多选的选项，向用户提问。当你不确定选项时，向用户所要配置选项的相关信息。

package/dist/runtime/components/table/ai-generate.vue

@@ -125,22 +125,6 @@ function stop() {
          rather than growing the editor pane; the fixed outer height is what lets
          the inner `flex-1` message area bound and scroll. -->
     <div class="flex h-[48rem] flex-col bg-transparent">
-      <!-- New-conversation control: a quiet ghost button pinned top-right that
-           clears the dialogue (and its sessionStorage). Disabled while a turn
-           streams or when there's nothing to clear. -->
-      <div class="flex items-center justify-end pb-1">
-        <Button
-          type="button"
-          variant="ghost"
-          size="sm"
-          :disabled="!canClear"
-          @click="newConversation"
-        >
-          <Icon icon="fluent:add-20-regular" />
-          新对话
-        </Button>
-      </div>
-
       <ChatMessages
         :messages="displayMessages"
         :pending="pending"
@@ -165,7 +149,24 @@ function stop() {
           :status="status"
           @submit="send"
           @stop="stop"
-        />
+        >
+          <!-- New-conversation control lives at the composer's block-end left
+               edge (beside the send button): a quiet ghost button that clears
+               the dialogue (and its sessionStorage). Disabled while a turn
+               streams or when there's nothing to clear. -->
+          <template #actions>
+            <Button
+              type="button"
+              variant="ghost"
+              size="sm"
+              :disabled="!canClear"
+              @click="newConversation"
+            >
+              <Icon icon="fluent:add-20-regular" />
+              新对话
+            </Button>
+          </template>
+        </ChatPrompt>
       </div>
     </div>
   </div>