@aglyn/plugins-ai 1.0.0-beta.237 → 1.0.0-beta.239

package/src/lib/jobs/ai-job-form-dataset.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { pluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts';
+import type { NodesMap } from '@aglyn/aglyn/types/nodes';
+import type { AiSiteInventory } from '../model/ai-site-inventory';
+/**
+ * A FORM THAT WRITES TO A DATASET (AGL-3616; Zach, 2026-10-10: Aglyn AI's
+ * forms can write to datasets — a volunteer sign-up into a Volunteers
+ * dataset, an RSVP into an event's attendees, a catering inquiry into
+ * Inquiries).
+ *
+ * The plan says which dataset a form writes to (`writesTo` on its creation);
+ * it is never inferred from what a section places. The dataset is built
+ * first — a site start's dataset unit, a build's dataset item, or one the
+ * site already has — and the form step binds the form it generated the way a
+ * person binds one on the Form element: the form node's `datasetId`, and
+ * each Form Field's `datasetFieldId` where the dataset has a field of the
+ * same name and a type the submitted value can be stored as. A field the
+ * dataset lacks is left unbound, as the Form element's mapping leaves one:
+ * its value stays in the Inbox copy, and a form never adds a field to a
+ * dataset.
+ *
+ * The gates are the platform's. The binding is made only where the plan
+ * includes the data store (`dataStore`), the data plugin's writer is loaded
+ * here and reads the dataset, and the dataset is one this job made or one the
+ * site's inventory shows. Records, their allowance and storage are held at
+ * each submission by the data plugin's own record target. Anywhere else the
+ * form is the form it always was, its submissions in the Inbox.
+ */
+/** The unit input a dataset this job made for the form rides in, by id. */
+export declare const AI_FORM_DATASET_MADE_INPUT = "formDatasetMade";
+/** One field of the dataset a form writes to, as its writer reports it: storage type words. */
+export interface AiFormDatasetField {
+    id: string;
+    name: string;
+    type: string;
+}
+/** The dataset a form writes to, with the fields a submission may fill. */
+export interface AiFormDataset {
+    id: string;
+    name: string;
+    fields: AiFormDatasetField[];
+}
+/** A field name as two spellings of it compare: `fullName`, `full_name` and "Full name" are one. */
+export declare function aiFormFieldKey(name: string): string;
+/**
+ * Whether a submitted value of this form field type can be stored in a
+ * dataset field of this storage type. Every value a form submits is text, so
+ * a text field takes any of them and a number field takes a rating; any
+ * other pairing is left unbound rather than refused at every submission.
+ */
+export declare function aiFormFieldFitsDataset(fieldType: string, datasetType: string): boolean;
+/** What a binding came to: the fields bound, and the fields the dataset has no place for. */
+export interface AiFormDatasetBinding {
+    bound: string[];
+    unbound: string[];
+}
+/**
+ * Binds a form design to a dataset, in place: the form node's `datasetId`,
+ * and `datasetFieldId` on each Form Field the dataset has a field for, by its
+ * `fieldName` or its label, each dataset field taken once. The platform's
+ * consent field is never bound. A binding the design already carried is
+ * replaced, so what the model drew never chooses where a record lands.
+ */
+export declare function aiBindFormToDataset(nodes: NodesMap, formNodeId: string, dataset: AiFormDataset): AiFormDatasetBinding;
+export interface AiFormDatasetReadDeps {
+    writerFor?: typeof pluginResourceDraftWriter;
+}
+/**
+ * The dataset a form may write to, or `null` where it may not: the plan
+ * includes no data store, the data plugin's writer is not loaded here, the
+ * dataset is neither one this job made nor one the site's inventory shows,
+ * or it has no field a submission could fill.
+ */
+export declare function aiReadFormDataset(input: {
+    hostId: string;
+    id: string | null | undefined;
+    org: object | null;
+    inventory: Pick<AiSiteInventory, 'datasets'> | null;
+    /** The dataset this job made for the form, by id. */
+    madeId?: unknown;
+}, deps?: AiFormDatasetReadDeps): Promise<AiFormDataset | null>;
+/** What the form's generation is told about the dataset it writes to. */
+export declare function aiFormDatasetPromptLine(dataset: AiFormDataset): string;
+/** What the form's row says about where its submissions are also saved. */
+export declare function aiFormDatasetNote(dataset: AiFormDataset, binding: AiFormDatasetBinding): string;

package/src/lib/jobs/ai-job-form-dataset.js

@@ -0,0 +1,161 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { checkEntitlement } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { collectFormFieldNodeIds, FORM_COMPONENT_ID, isMarketingConsentFieldName } from "@aglyn/aglyn/app-utils/forms";
+import { pluginResourceDraftWriter } from "@aglyn/aglyn/plugin-manager/plugin-resource-drafts";
+import { AI_DATASET_DRAFT_RESOURCE } from "./ai-build-unit-outcome.js";
+/**
+ * A FORM THAT WRITES TO A DATASET (AGL-3616; Zach, 2026-10-10: Aglyn AI's
+ * forms can write to datasets — a volunteer sign-up into a Volunteers
+ * dataset, an RSVP into an event's attendees, a catering inquiry into
+ * Inquiries).
+ *
+ * The plan says which dataset a form writes to (`writesTo` on its creation);
+ * it is never inferred from what a section places. The dataset is built
+ * first — a site start's dataset unit, a build's dataset item, or one the
+ * site already has — and the form step binds the form it generated the way a
+ * person binds one on the Form element: the form node's `datasetId`, and
+ * each Form Field's `datasetFieldId` where the dataset has a field of the
+ * same name and a type the submitted value can be stored as. A field the
+ * dataset lacks is left unbound, as the Form element's mapping leaves one:
+ * its value stays in the Inbox copy, and a form never adds a field to a
+ * dataset.
+ *
+ * The gates are the platform's. The binding is made only where the plan
+ * includes the data store (`dataStore`), the data plugin's writer is loaded
+ * here and reads the dataset, and the dataset is one this job made or one the
+ * site's inventory shows. Records, their allowance and storage are held at
+ * each submission by the data plugin's own record target. Anywhere else the
+ * form is the form it always was, its submissions in the Inbox.
+ */ /** The unit input a dataset this job made for the form rides in, by id. */ export const AI_FORM_DATASET_MADE_INPUT = 'formDatasetMade';
+/** A field name as two spellings of it compare: `fullName`, `full_name` and "Full name" are one. */ export function aiFormFieldKey(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1 $2').toLowerCase().replace(/[^a-z0-9]+/g, '');
+}
+const NUMBER_TYPES = new Set([
+    'float',
+    'int32',
+    'int64',
+    'number',
+    'integer'
+]);
+/**
+ * Whether a submitted value of this form field type can be stored in a
+ * dataset field of this storage type. Every value a form submits is text, so
+ * a text field takes any of them and a number field takes a rating; any
+ * other pairing is left unbound rather than refused at every submission.
+ */ export function aiFormFieldFitsDataset(fieldType, datasetType) {
+    if (datasetType === 'text') return true;
+    if (NUMBER_TYPES.has(datasetType)) return fieldType === 'rating';
+    return false;
+}
+/**
+ * Binds a form design to a dataset, in place: the form node's `datasetId`,
+ * and `datasetFieldId` on each Form Field the dataset has a field for, by its
+ * `fieldName` or its label, each dataset field taken once. The platform's
+ * consent field is never bound. A binding the design already carried is
+ * replaced, so what the model drew never chooses where a record lands.
+ */ export function aiBindFormToDataset(nodes, formNodeId, dataset) {
+    var _form_props;
+    const result = {
+        bound: [],
+        unbound: []
+    };
+    const form = nodes[formNodeId];
+    if ((form == null ? void 0 : form.componentId) !== FORM_COMPONENT_ID) return result;
+    const props = _extends({}, (_form_props = form.props) != null ? _form_props : {});
+    delete props['datasetName'];
+    props['datasetId'] = dataset.id;
+    form.props = props;
+    const taken = new Set();
+    for (const id of collectFormFieldNodeIds(nodes, formNodeId)){
+        var _field_props, _fieldProps_fieldName, _fieldProps_label, _fieldProps_fieldType, _matching;
+        const field = nodes[id];
+        if (!field) continue;
+        const fieldProps = _extends({}, (_field_props = field.props) != null ? _field_props : {});
+        delete fieldProps['datasetFieldId'];
+        field.props = fieldProps;
+        const fieldName = String((_fieldProps_fieldName = fieldProps['fieldName']) != null ? _fieldProps_fieldName : '').trim();
+        if (!fieldName || isMarketingConsentFieldName(fieldName)) continue;
+        const label = String((_fieldProps_label = fieldProps['label']) != null ? _fieldProps_label : '').trim();
+        const fieldType = String((_fieldProps_fieldType = fieldProps['fieldType']) != null ? _fieldProps_fieldType : 'text');
+        // Its name first, then its label: `fullName` is "Full name" before "Your name" is.
+        const matching = (key)=>key ? dataset.fields.find((one)=>!taken.has(one.id) && aiFormFieldKey(one.name) === key && aiFormFieldFitsDataset(fieldType, one.type)) : undefined;
+        const match = (_matching = matching(aiFormFieldKey(fieldName))) != null ? _matching : matching(aiFormFieldKey(label));
+        if (!match) {
+            result.unbound.push(label || fieldName);
+            continue;
+        }
+        taken.add(match.id);
+        fieldProps['datasetFieldId'] = match.id;
+        result.bound.push(fieldName);
+    }
+    return result;
+}
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/**
+ * The dataset a form may write to, or `null` where it may not: the plan
+ * includes no data store, the data plugin's writer is not loaded here, the
+ * dataset is neither one this job made nor one the site's inventory shows,
+ * or it has no field a submission could fill.
+ */ export async function aiReadFormDataset(input, deps = {}) {
+    var _ref, _deps_writerFor, _record_facts;
+    var _input_inventory;
+    const id = str(input.id);
+    if (!id) return null;
+    if (!checkEntitlement(input.org, 'dataStore')) return null;
+    const known = id === str(input.madeId) || ((_ref = (_input_inventory = input.inventory) == null ? void 0 : _input_inventory.datasets) != null ? _ref : []).some((row)=>row.id === id);
+    if (!known) return null;
+    const keeper = ((_deps_writerFor = deps.writerFor) != null ? _deps_writerFor : pluginResourceDraftWriter)(AI_DATASET_DRAFT_RESOURCE);
+    if (!keeper) return null;
+    const record = await keeper.writer.read({
+        hostId: input.hostId,
+        id
+    }).catch((error)=>{
+        console.error('ai form: the dataset it writes to could not be read', {
+            hostId: input.hostId,
+            id,
+            error
+        });
+        return null;
+    });
+    if (!record) return null;
+    const facts = (_record_facts = record.facts) != null ? _record_facts : {};
+    const address = str(facts.addressField);
+    const fields = (Array.isArray(facts.fields) ? facts.fields : []).map((raw)=>raw && typeof raw === 'object' ? raw : {}).map((raw)=>({
+            id: str(raw['id']),
+            name: str(raw['name']),
+            type: str(raw['type']) || 'text'
+        })).filter((field)=>field.id && field.name && field.id !== address);
+    if (!fields.length) return null;
+    return {
+        id,
+        name: str(record.name) || 'dataset',
+        fields
+    };
+}
+/** What the form's generation is told about the dataset it writes to. */ export function aiFormDatasetPromptLine(dataset) {
+    const fields = dataset.fields.map((field)=>`${field.name} (${NUMBER_TYPES.has(field.type) ? 'a number' : 'text'})`);
+    return `Each submission is also saved as a record of the dataset “${dataset.name}”, whose fields are: ${fields.join(', ')}. Draw a field for each one a visitor can answer, labeled with the field's name.`;
+}
+/** What the form's row says about where its submissions are also saved. */ export function aiFormDatasetNote(dataset, binding) {
+    const kept = `Each submission is also saved as a record of the “${dataset.name}” dataset, in Data.`;
+    if (!binding.unbound.length) return kept;
+    const one = binding.unbound.length === 1;
+    return `${kept} The dataset has no field for ${binding.unbound.map((name)=>`“${name}”`).join(', ')}, so ${one ? 'that answer stays' : 'those answers stay'} in the Inbox only.`;
+}
+
+//# sourceMappingURL=ai-job-form-dataset.js.map

package/src/lib/jobs/ai-job-form-dataset.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-form-dataset.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { checkEntitlement } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport {\n  collectFormFieldNodeIds,\n  FORM_COMPONENT_ID,\n  isMarketingConsentFieldName,\n} from '@aglyn/aglyn/app-utils/forms'\nimport { pluginResourceDraftWriter } from '@aglyn/aglyn/plugin-manager/plugin-resource-drafts'\nimport type { NodesMap } from '@aglyn/aglyn/types/nodes'\nimport type { AiSiteInventory } from '../model/ai-site-inventory'\nimport { AI_DATASET_DRAFT_RESOURCE } from './ai-build-unit-outcome'\n\n/**\n * A FORM THAT WRITES TO A DATASET (AGL-3616; Zach, 2026-10-10: Aglyn AI's\n * forms can write to datasets — a volunteer sign-up into a Volunteers\n * dataset, an RSVP into an event's attendees, a catering inquiry into\n * Inquiries).\n *\n * The plan says which dataset a form writes to (`writesTo` on its creation);\n * it is never inferred from what a section places. The dataset is built\n * first — a site start's dataset unit, a build's dataset item, or one the\n * site already has — and the form step binds the form it generated the way a\n * person binds one on the Form element: the form node's `datasetId`, and\n * each Form Field's `datasetFieldId` where the dataset has a field of the\n * same name and a type the submitted value can be stored as. A field the\n * dataset lacks is left unbound, as the Form element's mapping leaves one:\n * its value stays in the Inbox copy, and a form never adds a field to a\n * dataset.\n *\n * The gates are the platform's. The binding is made only where the plan\n * includes the data store (`dataStore`), the data plugin's writer is loaded\n * here and reads the dataset, and the dataset is one this job made or one the\n * site's inventory shows. Records, their allowance and storage are held at\n * each submission by the data plugin's own record target. Anywhere else the\n * form is the form it always was, its submissions in the Inbox.\n */\n\n/** The unit input a dataset this job made for the form rides in, by id. */\nexport const AI_FORM_DATASET_MADE_INPUT = 'formDatasetMade'\n\n/** One field of the dataset a form writes to, as its writer reports it: storage type words. */\nexport interface AiFormDatasetField {\n  id: string\n  name: string\n  type: string\n}\n\n/** The dataset a form writes to, with the fields a submission may fill. */\nexport interface AiFormDataset {\n  id: string\n  name: string\n  fields: AiFormDatasetField[]\n}\n\n/** A field name as two spellings of it compare: `fullName`, `full_name` and \"Full name\" are one. */\nexport function aiFormFieldKey(name: string): string {\n  return name\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '')\n}\n\nconst NUMBER_TYPES = new Set(['float', 'int32', 'int64', 'number', 'integer'])\n\n/**\n * Whether a submitted value of this form field type can be stored in a\n * dataset field of this storage type. Every value a form submits is text, so\n * a text field takes any of them and a number field takes a rating; any\n * other pairing is left unbound rather than refused at every submission.\n */\nexport function aiFormFieldFitsDataset(fieldType: string, datasetType: string): boolean {\n  if (datasetType === 'text') return true\n  if (NUMBER_TYPES.has(datasetType)) return fieldType === 'rating'\n  return false\n}\n\n/** What a binding came to: the fields bound, and the fields the dataset has no place for. */\nexport interface AiFormDatasetBinding {\n  bound: string[]\n  unbound: string[]\n}\n\n/**\n * Binds a form design to a dataset, in place: the form node's `datasetId`,\n * and `datasetFieldId` on each Form Field the dataset has a field for, by its\n * `fieldName` or its label, each dataset field taken once. The platform's\n * consent field is never bound. A binding the design already carried is\n * replaced, so what the model drew never chooses where a record lands.\n */\nexport function aiBindFormToDataset(\n  nodes: NodesMap,\n  formNodeId: string,\n  dataset: AiFormDataset,\n): AiFormDatasetBinding {\n  const result: AiFormDatasetBinding = { bound: [], unbound: [] }\n  const form = nodes[formNodeId]\n  if (form?.componentId !== FORM_COMPONENT_ID) return result\n  const props = { ...((form.props ?? {}) as Record<string, unknown>) }\n  delete props['datasetName']\n  props['datasetId'] = dataset.id\n  form.props = props as never\n  const taken = new Set<string>()\n  for (const id of collectFormFieldNodeIds(nodes as never, formNodeId)) {\n    const field = nodes[id]\n    if (!field) continue\n    const fieldProps = { ...((field.props ?? {}) as Record<string, unknown>) }\n    delete fieldProps['datasetFieldId']\n    field.props = fieldProps as never\n    const fieldName = String(fieldProps['fieldName'] ?? '').trim()\n    if (!fieldName || isMarketingConsentFieldName(fieldName)) continue\n    const label = String(fieldProps['label'] ?? '').trim()\n    const fieldType = String(fieldProps['fieldType'] ?? 'text')\n    // Its name first, then its label: `fullName` is \"Full name\" before \"Your name\" is.\n    const matching = (key: string) =>\n      key\n        ? dataset.fields.find((one) => !taken.has(one.id) && aiFormFieldKey(one.name) === key && aiFormFieldFitsDataset(fieldType, one.type))\n        : undefined\n    const match = matching(aiFormFieldKey(fieldName)) ?? matching(aiFormFieldKey(label))\n    if (!match) {\n      result.unbound.push(label || fieldName)\n      continue\n    }\n    taken.add(match.id)\n    fieldProps['datasetFieldId'] = match.id\n    result.bound.push(fieldName)\n  }\n  return result\n}\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\nexport interface AiFormDatasetReadDeps {\n  writerFor?: typeof pluginResourceDraftWriter\n}\n\n/**\n * The dataset a form may write to, or `null` where it may not: the plan\n * includes no data store, the data plugin's writer is not loaded here, the\n * dataset is neither one this job made nor one the site's inventory shows,\n * or it has no field a submission could fill.\n */\nexport async function aiReadFormDataset(\n  input: {\n    hostId: string\n    id: string | null | undefined\n    org: object | null\n    inventory: Pick<AiSiteInventory, 'datasets'> | null\n    /** The dataset this job made for the form, by id. */\n    madeId?: unknown\n  },\n  deps: AiFormDatasetReadDeps = {},\n): Promise<AiFormDataset | null> {\n  const id = str(input.id)\n  if (!id) return null\n  if (!checkEntitlement(input.org as never, 'dataStore')) return null\n  const known = id === str(input.madeId) || (input.inventory?.datasets ?? []).some((row) => row.id === id)\n  if (!known) return null\n  const keeper = (deps.writerFor ?? pluginResourceDraftWriter)(AI_DATASET_DRAFT_RESOURCE)\n  if (!keeper) return null\n  const record = await keeper.writer.read({ hostId: input.hostId, id }).catch((error: unknown) => {\n    console.error('ai form: the dataset it writes to could not be read', { hostId: input.hostId, id, error })\n    return null\n  })\n  if (!record) return null\n  const facts = (record.facts ?? {}) as { fields?: unknown; addressField?: unknown }\n  const address = str(facts.addressField)\n  const fields = (Array.isArray(facts.fields) ? (facts.fields as unknown[]) : [])\n    .map((raw) => (raw && typeof raw === 'object' ? (raw as Record<string, unknown>) : {}))\n    .map((raw) => ({ id: str(raw['id']), name: str(raw['name']), type: str(raw['type']) || 'text' }))\n    .filter((field) => field.id && field.name && field.id !== address)\n  if (!fields.length) return null\n  return { id, name: str(record.name) || 'dataset', fields }\n}\n\n/** What the form's generation is told about the dataset it writes to. */\nexport function aiFormDatasetPromptLine(dataset: AiFormDataset): string {\n  const fields = dataset.fields.map((field) => `${field.name} (${NUMBER_TYPES.has(field.type) ? 'a number' : 'text'})`)\n  return `Each submission is also saved as a record of the dataset “${dataset.name}”, whose fields are: ${fields.join(', ')}. Draw a field for each one a visitor can answer, labeled with the field's name.`\n}\n\n/** What the form's row says about where its submissions are also saved. */\nexport function aiFormDatasetNote(dataset: AiFormDataset, binding: AiFormDatasetBinding): string {\n  const kept = `Each submission is also saved as a record of the “${dataset.name}” dataset, in Data.`\n  if (!binding.unbound.length) return kept\n  const one = binding.unbound.length === 1\n  return `${kept} The dataset has no field for ${binding.unbound.map((name) => `“${name}”`).join(', ')}, so ${\n    one ? 'that answer stays' : 'those answers stay'\n  } in the Inbox only.`\n}\n"],"names":["checkEntitlement","collectFormFieldNodeIds","FORM_COMPONENT_ID","isMarketingConsentFieldName","pluginResourceDraftWriter","AI_DATASET_DRAFT_RESOURCE","AI_FORM_DATASET_MADE_INPUT","aiFormFieldKey","name","replace","toLowerCase","NUMBER_TYPES","Set","aiFormFieldFitsDataset","fieldType","datasetType","has","aiBindFormToDataset","nodes","formNodeId","dataset","form","result","bound","unbound","componentId","props","id","taken","field","fieldProps","matching","fieldName","String","trim","label","key","fields","find","one","type","undefined","match","push","add","str","value","aiReadFormDataset","input","deps","record","org","known","madeId","inventory","datasets","some","row","keeper","writerFor","writer","read","hostId","catch","error","console","facts","address","addressField","Array","isArray","map","raw","filter","length","aiFormDatasetPromptLine","join","aiFormDatasetNote","binding","kept"],"mappings":"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"}

package/src/lib/jobs/ai-job-form-step.d.ts

@@ -24,6 +24,7 @@ import type { AiDoctrineViolation } from '../runtime/ai-doctrine-validators';
 import type { AiSystemBlock, AiTool } from '../runtime/ai-runtime';
 import { readSiteInventory } from '../runtime/site-inventory';
 import { type AiJobAdmission } from './ai-job-admission';
+import { type AiFormDataset, type AiFormDatasetBinding, type AiFormDatasetReadDeps } from './ai-job-form-dataset';
 import type { AiJobStepRunner } from './ai-job-text-step';
 /**
  * The form step (AGL-2913): the generation step of a `form` job, run once a
@@ -140,18 +141,26 @@ export interface AiFormDraft {
     consentFieldName: string | null;
     routing: FormRouting | null;
     answer: AiFormAnswer;
+    /** The dataset its submissions are also written to, and what was bound (AGL-3616). */
+    dataset?: {
+        dataset: AiFormDataset;
+        binding: AiFormDatasetBinding;
+    };
 }
 /**
  * The draft a validated design and its answer make: the form node bound to
- * `formId` and captioned `name`, no dataset binding, the platform's consent
- * field when the fields can yield an email address, the canvas root above,
- * and the declaration read off the result. Pure; the input tree is not
+ * `formId` and captioned `name`, the platform's consent field when the
+ * fields can yield an email address, the canvas root above, and the
+ * declaration read off the result. A dataset binding is made only where the
+ * plan said the form writes to one this step may bind (`identity.dataset`,
+ * AGL-3616); any the model drew is dropped. Pure; the input tree is not
  * changed.
  */
 export declare function aiFormDraft(tree: Pick<AiValidatedTree, 'rootId' | 'nodes'>, answer: Record<string, unknown>, identity: {
     formId: string;
     name: string;
     decisions?: AiFormDecisions;
+    dataset?: AiFormDataset | null;
 }): AiFormDraft;
 /**
  * What a draft would break once published, as building-rule violations
@@ -170,6 +179,7 @@ export declare function aiFormDraftCheck(identity: {
     formId: string;
     name: string;
     decisions?: AiFormDecisions;
+    dataset?: AiFormDataset | null;
 }): {
     extend: (tree: AiValidatedTree, answer: Record<string, unknown>) => AiDoctrineViolation[];
     draftFor: (tree: AiValidatedTree) => AiFormDraft | undefined;
@@ -280,6 +290,8 @@ export interface AiJobFormStepDeps {
     readInventory?: typeof readSiteInventory;
     /** The platform's duplicate module, for a plan that starts from a copy. */
     duplicate?: typeof duplicateResource;
+    /** The data plugin's writer lookup the form's dataset is read through (AGL-3616); specs hand in a fake. */
+    datasetWriterFor?: AiFormDatasetReadDeps['writerFor'];
 }
 export declare function createAiJobFormStep(deps?: AiJobFormStepDeps): AiJobStepRunner;
 export declare const runAiJobFormStep: AiJobStepRunner;

package/src/lib/jobs/ai-job-form-step.js

@@ -14,7 +14,8 @@ import { _ as _extends } from "@swc/helpers/_/_extends";
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- */ import { checkFormContract, formFieldsCanYieldAnEmail } from "@aglyn/aglyn/app-utils/form-contract";
+ */ import { throwIfAiJobCanceled } from "./ai-job-cancel.js";
+import { checkFormContract, formFieldsCanYieldAnEmail } from "@aglyn/aglyn/app-utils/form-contract";
 import { collectFormFieldNodeIds, FORM_COMPONENT_ID, FORM_FIELD_COMPONENT_ID, FORM_ID_PROP, formFieldDeclsFromNodes, formNodeIdIn, isMarketingConsentFieldName, MARKETING_CONSENT_FORM_FIELD } from "@aglyn/aglyn/app-utils/forms";
 import { decodeStoredNodes } from "@aglyn/aglyn/app-utils/stored-nodes";
 import { CANVAS_ROOT_ELEMENT_ID } from "@aglyn/aglyn/foundation/constants/canvas";
@@ -27,6 +28,7 @@ import { aiDoctrineTreeTool, runValidatedGeneration } from "../runtime/ai-doctri
 import { AI_PALETTE } from "../runtime/ai-palette.generated.js";
 import { readSiteInventory } from "../runtime/site-inventory.js";
 import { registerAiJobAdmission } from "./ai-job-admission.js";
+import { AI_FORM_DATASET_MADE_INPUT, aiBindFormToDataset, aiFormDatasetNote, aiFormDatasetPromptLine, aiReadFormDataset } from "./ai-job-form-dataset.js";
 import { aiJobPlanCreationsRefusal } from "./ai-job-plan-creations.js";
 import { aiJobDraftId } from "./ai-job-draft-ids.js";
 import { aiDraftAdmissionRefusal, aiDraftAllowanceRefusal, aiSiteSubdomain, readAiDraft, writeAiDraft } from "./ai-job-drafts.js";
@@ -208,9 +210,11 @@ function oneLine(value, max) {
 }
 /**
  * The draft a validated design and its answer make: the form node bound to
- * `formId` and captioned `name`, no dataset binding, the platform's consent
- * field when the fields can yield an email address, the canvas root above,
- * and the declaration read off the result. Pure; the input tree is not
+ * `formId` and captioned `name`, the platform's consent field when the
+ * fields can yield an email address, the canvas root above, and the
+ * declaration read off the result. A dataset binding is made only where the
+ * plan said the form writes to one this step may bind (`identity.dataset`,
+ * AGL-3616); any the model drew is dropped. Pure; the input tree is not
  * changed.
  */ export function aiFormDraft(tree, answer, identity) {
     var _identity_decisions;
@@ -232,8 +236,8 @@ function oneLine(value, max) {
     let consentFieldName = null;
     if ((form == null ? void 0 : form.componentId) === FORM_COMPONENT_ID) {
         const props = form.props;
-        // A dataset binding decides where every submission is also written; it
-        // stays the person's choice, made on the Form element.
+        // A dataset binding decides where every submission is also written: the
+        // plan's to say (AGL-3616), bound below, never the model's to draw.
         delete props['datasetId'];
         delete props['datasetName'];
         props[FORM_ID_PROP] = identity.formId;
@@ -268,6 +272,12 @@ function oneLine(value, max) {
         }
         form.parentId = CANVAS_ROOT_ELEMENT_ID;
     }
+    // The dataset the plan says the form writes to (AGL-3616), bound as the
+    // Form element binds one.
+    const dataset = identity.dataset && (form == null ? void 0 : form.componentId) === FORM_COMPONENT_ID ? {
+        dataset: identity.dataset,
+        binding: aiBindFormToDataset(nodes, formNodeId, identity.dataset)
+    } : undefined;
     nodes[CANVAS_ROOT_ELEMENT_ID] = {
         $id: CANVAS_ROOT_ELEMENT_ID,
         componentId: 'div',
@@ -275,7 +285,7 @@ function oneLine(value, max) {
             formNodeId
         ]
     };
-    return {
+    return _extends({
         nodes,
         rootId: CANVAS_ROOT_ELEMENT_ID,
         formNodeId,
@@ -285,7 +295,9 @@ function oneLine(value, max) {
             lead: true
         } : null,
         answer: parsed
-    };
+    }, dataset ? {
+        dataset
+    } : {});
 }
 /**
  * What a draft would break once published, as building-rule violations
@@ -535,6 +547,7 @@ export function createAiJobFormStep(deps = {}) {
     const duplicate = (_deps_duplicate = deps.duplicate) != null ? _deps_duplicate : duplicateResource;
     return async ({ job, now, signal, firestore, modelFor })=>{
         var _ref, _orgSnapshot_data;
+        var _job_inputs;
         const hostId = job.hostId;
         if (!hostId) throw new Error('a form job names no site, and its admission refuses one');
         const output = (draft, extra = {})=>_extends({
@@ -661,10 +674,22 @@ export function createAiJobFormStep(deps = {}) {
             submissions: aiSiteSubmissions(job.inputs)
         };
         const { audience } = aiSiteWords(job.inputs);
+        // The dataset the plan says the form writes to (AGL-3616), where this
+        // workspace may bind one; otherwise the form is the form it always was.
+        const dataset = await aiReadFormDataset({
+            hostId,
+            id: creation == null ? void 0 : creation.writesTo,
+            org,
+            inventory,
+            madeId: (_job_inputs = job.inputs) == null ? void 0 : _job_inputs[AI_FORM_DATASET_MADE_INPUT]
+        }, deps.datasetWriterFor ? {
+            writerFor: deps.datasetWriterFor
+        } : {});
         const check = aiFormDraftCheck({
             formId: draftId,
             name,
-            decisions
+            decisions,
+            dataset
         });
         const result = await runValidatedGeneration('form', _extends({
             step: 'job.form',
@@ -679,7 +704,10 @@ export function createAiJobFormStep(deps = {}) {
                             audience,
                             submissions: decisions.submissions
                         }),
-                        ...sourceLines
+                        ...sourceLines,
+                        ...dataset ? [
+                            aiFormDatasetPromptLine(dataset)
+                        ] : []
                     ].join('\n')
                 }
             ],
@@ -699,6 +727,8 @@ export function createAiJobFormStep(deps = {}) {
         });
         const draft = check.draftFor(result.value);
         if (!draft) throw new Error('a form the doctrine admitted has no draft from its check');
+        // Never written once the job is canceled (AGL-3616).
+        throwIfAiJobCanceled(signal);
         const write = await writeAiDraft(firestore, {
             kind: 'form',
             hostId,
@@ -725,6 +755,7 @@ export function createAiJobFormStep(deps = {}) {
         // What the person decides next, then the facts the brief did not give (AGL-3056).
         const note = [
             aiFormOutputNote(draft.answer),
+            draft.dataset ? aiFormDatasetNote(draft.dataset.dataset, draft.dataset.binding) : null,
             aiBracketedFactsNote({
                 tree: {
                     rootId: result.value.rootId,