@aglyn/plugins-ai 1.0.0-beta.250 → 1.0.0-beta.252

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

@@ -0,0 +1,78 @@
+/**
+ * @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 type { AiJob } from '../model/ai-jobs.types';
+import { type AiDraftRecord } from './ai-job-drafts';
+/**
+ * A FORM ANOTHER BUILD JUST MADE, PLACED INSTEAD OF REFUSED (AGL-3765).
+ *
+ * Two page jobs started from one brief on a Free site, minutes apart, were
+ * each planned while the site had no form, and each planned a new one. The
+ * first to reach its form step made the site's one Free form; the second
+ * reached its own ten seconds later, was refused at the band, and stopped
+ * without the page it was asked for. A third job, planned after the form
+ * existed, placed it by id and was built.
+ *
+ * So a form UNIT — the form a page, a guided start or a build makes before
+ * the page that places it — that the band refuses looks for a form another AI
+ * job made on the same site, and reports that form as what the unit built.
+ * The page then binds it by id, exactly as it binds a form the site always
+ * had. Another job's form qualifies when the site holds it now, in use, and it
+ * was made in the last {@link AI_FORM_REUSE_WINDOW_MS}, or by a job of the
+ * same brief. Which job made it is read from what the jobs record: the
+ * form's id is the id a job's plan minted for its form creation before the
+ * write (`AiBuildPlanCreate.id`), and the output the job recorded after it.
+ *
+ * A job the member asked for a form by itself never borrows one: it was asked
+ * for a new form, not for a page that needs one.
+ */
+/** How recently another job must have made a form for a refused unit to place it. */
+export declare const AI_FORM_REUSE_WINDOW_MS: number;
+/** What the unit's output says when it placed another build's form. */
+export declare const AI_FORM_REUSED_NOTE = "Reused the form another build just made.";
+/** How many of the site's newest jobs are read for the form's maker. */
+export declare const AI_FORM_REUSE_JOBS_READ = 20;
+/** The fields of a job this module reads. */
+export type AiFormReuseJob = Pick<AiJob, '$id' | 'hostId' | 'brief' | 'outputs' | 'plan'>;
+/**
+ * The forms other jobs on this site made or were about to make, each with
+ * whether its job had the same brief as the job the member started. Read off
+ * each job's recorded outputs and its plan's minted form ids; the job the
+ * member started is never another job.
+ */
+export declare function aiSiblingJobFormIds(jobs: readonly AiFormReuseJob[], input: {
+    hostId: string;
+    originJobId: string;
+}): Map<string, {
+    sameBrief: boolean;
+}>;
+export interface AiSiblingJobFormDeps {
+    /** The site's newest jobs; the machine's list otherwise. */
+    listJobs?: (firestore: FirebaseFirestore.Firestore, orgId: string, options: {
+        hostId: string;
+        limit: number;
+    }) => Promise<readonly AiFormReuseJob[]>;
+}
+/**
+ * The form another AI job made on this site that a refused form unit places
+ * instead (AGL-3765), as the draft record the unit reports; `null` when the
+ * job is not a unit, or no other job's form qualifies. The newest qualifying
+ * form wins.
+ */
+export declare function aiSiblingJobForm(firestore: FirebaseFirestore.Firestore, input: {
+    job: Pick<AiJob, '$id' | 'orgId' | 'hostId' | 'inputs'>;
+    now: Date;
+}, deps?: AiSiblingJobFormDeps): Promise<AiDraftRecord | null>;

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

@@ -0,0 +1,136 @@
+/**
+ * @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 { isFormArchived } from "@aglyn/aglyn/app-utils/forms";
+import { aiOriginJobId } from "./ai-job-draft-ids.js";
+import { aiDraftInstantMs, aiSiteSubdomain } from "./ai-job-drafts.js";
+import { listAiJobs } from "./ai-jobs.js";
+/**
+ * A FORM ANOTHER BUILD JUST MADE, PLACED INSTEAD OF REFUSED (AGL-3765).
+ *
+ * Two page jobs started from one brief on a Free site, minutes apart, were
+ * each planned while the site had no form, and each planned a new one. The
+ * first to reach its form step made the site's one Free form; the second
+ * reached its own ten seconds later, was refused at the band, and stopped
+ * without the page it was asked for. A third job, planned after the form
+ * existed, placed it by id and was built.
+ *
+ * So a form UNIT — the form a page, a guided start or a build makes before
+ * the page that places it — that the band refuses looks for a form another AI
+ * job made on the same site, and reports that form as what the unit built.
+ * The page then binds it by id, exactly as it binds a form the site always
+ * had. Another job's form qualifies when the site holds it now, in use, and it
+ * was made in the last {@link AI_FORM_REUSE_WINDOW_MS}, or by a job of the
+ * same brief. Which job made it is read from what the jobs record: the
+ * form's id is the id a job's plan minted for its form creation before the
+ * write (`AiBuildPlanCreate.id`), and the output the job recorded after it.
+ *
+ * A job the member asked for a form by itself never borrows one: it was asked
+ * for a new form, not for a page that needs one.
+ */ /** How recently another job must have made a form for a refused unit to place it. */ export const AI_FORM_REUSE_WINDOW_MS = 15 * 60000;
+/** What the unit's output says when it placed another build's form. */ export const AI_FORM_REUSED_NOTE = 'Reused the form another build just made.';
+/** How many of the site's newest jobs are read for the form's maker. */ export const AI_FORM_REUSE_JOBS_READ = 20;
+/** A brief as two jobs of the same brief share it: case and spacing aside. */ function briefKey(brief) {
+    return (brief != null ? brief : '').trim().replace(/\s+/g, ' ').toLowerCase();
+}
+/**
+ * The forms other jobs on this site made or were about to make, each with
+ * whether its job had the same brief as the job the member started. Read off
+ * each job's recorded outputs and its plan's minted form ids; the job the
+ * member started is never another job.
+ */ export function aiSiblingJobFormIds(jobs, input) {
+    const origin = jobs.find((job)=>job.$id === input.originJobId);
+    const brief = origin ? briefKey(origin.brief) : '';
+    const found = new Map();
+    for (const job of jobs){
+        var _job_outputs, _ref;
+        var _job_plan;
+        if (job.$id === input.originJobId || job.hostId !== input.hostId) continue;
+        const sameBrief = Boolean(brief) && briefKey(job.brief) === brief;
+        const ids = [
+            ...((_job_outputs = job.outputs) != null ? _job_outputs : []).filter((output)=>{
+                var _output_hostId;
+                return output.resource === 'form' && ((_output_hostId = output.hostId) != null ? _output_hostId : input.hostId) === input.hostId;
+            }).map((output)=>output.id),
+            ...((_ref = (_job_plan = job.plan) == null ? void 0 : _job_plan.create) != null ? _ref : []).filter((entry)=>entry.kind === 'form').map((entry)=>entry.id)
+        ];
+        for (const id of ids){
+            var _ref1;
+            var _found_get;
+            if (!id) continue;
+            found.set(id, {
+                sameBrief: sameBrief || ((_ref1 = (_found_get = found.get(id)) == null ? void 0 : _found_get.sameBrief) != null ? _ref1 : false)
+            });
+        }
+    }
+    return found;
+}
+/**
+ * The form another AI job made on this site that a refused form unit places
+ * instead (AGL-3765), as the draft record the unit reports; `null` when the
+ * job is not a unit, or no other job's form qualifies. The newest qualifying
+ * form wins.
+ */ export async function aiSiblingJobForm(firestore, input, deps = {}) {
+    var _deps_listJobs;
+    const { job } = input;
+    const hostId = job.hostId;
+    const originJobId = aiOriginJobId(job);
+    // Only a unit of a job that places the form; a form job builds its own.
+    if (!hostId || originJobId === job.$id) return null;
+    const listJobs = (_deps_listJobs = deps.listJobs) != null ? _deps_listJobs : listAiJobs;
+    const jobs = await listJobs(firestore, job.orgId, {
+        hostId,
+        limit: AI_FORM_REUSE_JOBS_READ
+    });
+    const candidates = aiSiblingJobFormIds(jobs, {
+        hostId,
+        originJobId
+    });
+    candidates.delete(job.$id);
+    if (!candidates.size) return null;
+    const forms = firestore.collection('hosts').doc(hostId).collection('forms');
+    const read = await Promise.all([
+        ...candidates.entries()
+    ].map(async ([id, { sameBrief }])=>({
+            id,
+            sameBrief,
+            doc: await forms.doc(id).get()
+        })));
+    const now = input.now.getTime();
+    const qualifying = read.filter(({ doc })=>doc.exists && !isFormArchived({
+            archivedAt: doc.get('archivedAt')
+        })).map(({ id, sameBrief, doc })=>{
+        var _doc_get;
+        return {
+            id,
+            sameBrief,
+            name: String((_doc_get = doc.get('displayName')) != null ? _doc_get : ''),
+            createdAt: aiDraftInstantMs(doc.get('createdAt'))
+        };
+    }).filter((form)=>form.sameBrief || form.createdAt !== null && now - form.createdAt <= AI_FORM_REUSE_WINDOW_MS).sort((a, b)=>{
+        var _b_createdAt, _a_createdAt;
+        return ((_b_createdAt = b.createdAt) != null ? _b_createdAt : 0) - ((_a_createdAt = a.createdAt) != null ? _a_createdAt : 0);
+    });
+    const [form] = qualifying;
+    if (!form) return null;
+    return {
+        id: form.id,
+        versionId: null,
+        name: form.name,
+        hostSubdomain: await aiSiteSubdomain(firestore, hostId)
+    };
+}
+
+//# sourceMappingURL=ai-job-form-reuse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/jobs/ai-job-form-reuse.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 { isFormArchived } from '@aglyn/aglyn/app-utils/forms'\nimport type { AiJob } from '../model/ai-jobs.types'\nimport { aiOriginJobId } from './ai-job-draft-ids'\nimport { aiDraftInstantMs, aiSiteSubdomain, type AiDraftRecord } from './ai-job-drafts'\nimport { listAiJobs } from './ai-jobs'\n\n/**\n * A FORM ANOTHER BUILD JUST MADE, PLACED INSTEAD OF REFUSED (AGL-3765).\n *\n * Two page jobs started from one brief on a Free site, minutes apart, were\n * each planned while the site had no form, and each planned a new one. The\n * first to reach its form step made the site's one Free form; the second\n * reached its own ten seconds later, was refused at the band, and stopped\n * without the page it was asked for. A third job, planned after the form\n * existed, placed it by id and was built.\n *\n * So a form UNIT — the form a page, a guided start or a build makes before\n * the page that places it — that the band refuses looks for a form another AI\n * job made on the same site, and reports that form as what the unit built.\n * The page then binds it by id, exactly as it binds a form the site always\n * had. Another job's form qualifies when the site holds it now, in use, and it\n * was made in the last {@link AI_FORM_REUSE_WINDOW_MS}, or by a job of the\n * same brief. Which job made it is read from what the jobs record: the\n * form's id is the id a job's plan minted for its form creation before the\n * write (`AiBuildPlanCreate.id`), and the output the job recorded after it.\n *\n * A job the member asked for a form by itself never borrows one: it was asked\n * for a new form, not for a page that needs one.\n */\n\n/** How recently another job must have made a form for a refused unit to place it. */\nexport const AI_FORM_REUSE_WINDOW_MS = 15 * 60_000\n\n/** What the unit's output says when it placed another build's form. */\nexport const AI_FORM_REUSED_NOTE = 'Reused the form another build just made.'\n\n/** How many of the site's newest jobs are read for the form's maker. */\nexport const AI_FORM_REUSE_JOBS_READ = 20\n\n/** The fields of a job this module reads. */\nexport type AiFormReuseJob = Pick<AiJob, '$id' | 'hostId' | 'brief' | 'outputs' | 'plan'>\n\n/** A brief as two jobs of the same brief share it: case and spacing aside. */\nfunction briefKey(brief: string | null | undefined): string {\n  return (brief ?? '').trim().replace(/\\s+/g, ' ').toLowerCase()\n}\n\n/**\n * The forms other jobs on this site made or were about to make, each with\n * whether its job had the same brief as the job the member started. Read off\n * each job's recorded outputs and its plan's minted form ids; the job the\n * member started is never another job.\n */\nexport function aiSiblingJobFormIds(\n  jobs: readonly AiFormReuseJob[],\n  input: { hostId: string; originJobId: string },\n): Map<string, { sameBrief: boolean }> {\n  const origin = jobs.find((job) => job.$id === input.originJobId)\n  const brief = origin ? briefKey(origin.brief) : ''\n  const found = new Map<string, { sameBrief: boolean }>()\n  for (const job of jobs) {\n    if (job.$id === input.originJobId || job.hostId !== input.hostId) continue\n    const sameBrief = Boolean(brief) && briefKey(job.brief) === brief\n    const ids = [\n      ...(job.outputs ?? [])\n        .filter((output) => output.resource === 'form' && (output.hostId ?? input.hostId) === input.hostId)\n        .map((output) => output.id),\n      ...(job.plan?.create ?? []).filter((entry) => entry.kind === 'form').map((entry) => entry.id),\n    ]\n    for (const id of ids) {\n      if (!id) continue\n      found.set(id, { sameBrief: sameBrief || (found.get(id)?.sameBrief ?? false) })\n    }\n  }\n  return found\n}\n\nexport interface AiSiblingJobFormDeps {\n  /** The site's newest jobs; the machine's list otherwise. */\n  listJobs?: (\n    firestore: FirebaseFirestore.Firestore,\n    orgId: string,\n    options: { hostId: string; limit: number },\n  ) => Promise<readonly AiFormReuseJob[]>\n}\n\n/**\n * The form another AI job made on this site that a refused form unit places\n * instead (AGL-3765), as the draft record the unit reports; `null` when the\n * job is not a unit, or no other job's form qualifies. The newest qualifying\n * form wins.\n */\nexport async function aiSiblingJobForm(\n  firestore: FirebaseFirestore.Firestore,\n  input: { job: Pick<AiJob, '$id' | 'orgId' | 'hostId' | 'inputs'>; now: Date },\n  deps: AiSiblingJobFormDeps = {},\n): Promise<AiDraftRecord | null> {\n  const { job } = input\n  const hostId = job.hostId\n  const originJobId = aiOriginJobId(job)\n  // Only a unit of a job that places the form; a form job builds its own.\n  if (!hostId || originJobId === job.$id) return null\n  const listJobs = deps.listJobs ?? listAiJobs\n  const jobs = await listJobs(firestore, job.orgId, { hostId, limit: AI_FORM_REUSE_JOBS_READ })\n  const candidates = aiSiblingJobFormIds(jobs, { hostId, originJobId })\n  candidates.delete(job.$id)\n  if (!candidates.size) return null\n  const forms = firestore.collection('hosts').doc(hostId).collection('forms')\n  const read = await Promise.all(\n    [...candidates.entries()].map(async ([id, { sameBrief }]) => ({ id, sameBrief, doc: await forms.doc(id).get() })),\n  )\n  const now = input.now.getTime()\n  const qualifying = read\n    .filter(({ doc }) => doc.exists && !isFormArchived({ archivedAt: doc.get('archivedAt') }))\n    .map(({ id, sameBrief, doc }) => ({\n      id,\n      sameBrief,\n      name: String(doc.get('displayName') ?? ''),\n      createdAt: aiDraftInstantMs(doc.get('createdAt')),\n    }))\n    .filter(\n      (form) =>\n        form.sameBrief || (form.createdAt !== null && now - form.createdAt <= AI_FORM_REUSE_WINDOW_MS),\n    )\n    .sort((a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0))\n  const [form] = qualifying\n  if (!form) return null\n  return {\n    id: form.id,\n    versionId: null,\n    name: form.name,\n    hostSubdomain: await aiSiteSubdomain(firestore, hostId),\n  }\n}\n"],"names":["isFormArchived","aiOriginJobId","aiDraftInstantMs","aiSiteSubdomain","listAiJobs","AI_FORM_REUSE_WINDOW_MS","AI_FORM_REUSED_NOTE","AI_FORM_REUSE_JOBS_READ","briefKey","brief","trim","replace","toLowerCase","aiSiblingJobFormIds","jobs","input","origin","find","job","$id","originJobId","found","Map","hostId","sameBrief","Boolean","ids","outputs","filter","output","resource","map","id","plan","create","entry","kind","set","get","aiSiblingJobForm","firestore","deps","listJobs","orgId","limit","candidates","delete","size","forms","collection","doc","read","Promise","all","entries","now","getTime","qualifying","exists","archivedAt","name","String","createdAt","form","sort","a","b","versionId","hostSubdomain"],"mappings":"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"}

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

@@ -25,6 +25,7 @@ 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 { aiSiblingJobForm } from './ai-job-form-reuse';
 import type { AiJobStepRunner } from './ai-job-text-step';
 /**
  * The form step (AGL-2913): the generation step of a `form` job, run once a
@@ -64,6 +65,14 @@ import type { AiJobStepRunner } from './ai-job-text-step';
  * one (AGL-3024). A copy still bound to the form it was copied from is a
  * failure, never an output.
  *
+ * A site that holds every form its plan includes refuses the draft
+ * (AGL-3765). A form the step builds for a page (a unit of a page job, a
+ * guided start or a build) then places the form another AI job made on the
+ * site moments before (`ai-job-form-reuse.ts`), as two jobs started from one
+ * brief race to. Failing that, a site that still had room when the plan was
+ * confirmed stops the job on our side, its credits given back; one that was
+ * already full is the workspace's limit, for the member to change.
+ *
  * Like the other generation steps, it runs on the job beat, never at an inline
  * door: it registers the least time its lookup rounds, its answer and its
  * re-ask need (AGL-3035), and runs without extended thinking under the routing
@@ -301,6 +310,12 @@ export declare function aiJobFormPrompt(job: Pick<AiJob, 'brief'>, plan: AiJobPl
  * (AGL-3143 §15).
  */
 export declare const aiFormJobAdmission: AiJobAdmission;
+/**
+ * What a form step says when the site's last form was taken after its plan
+ * was confirmed (AGL-3765): by another build running beside it, or by a
+ * member. The failure is ours, so what the job spent is given back.
+ */
+export declare const AI_FORM_BAND_TAKEN_COPY = "Another build on this site used the last form your plan includes while this one was running, so this one stopped. Describe it again to build it with the form the site has now.";
 export interface AiJobFormStepDeps {
     /** The inventory reader; specs hand in a fake. */
     readInventory?: typeof readSiteInventory;
@@ -308,6 +323,8 @@ export interface AiJobFormStepDeps {
     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'];
+    /** The form another build just made that a refused unit places (AGL-3765); specs hand in a fake. */
+    siblingForm?: typeof aiSiblingJobForm;
 }
 export declare function createAiJobFormStep(deps?: AiJobFormStepDeps): AiJobStepRunner;
 export declare const runAiJobFormStep: AiJobStepRunner;

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

@@ -31,7 +31,8 @@ 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";
+import { aiDraftAdmissionRefusal, aiDraftAllowanceRefusal, aiSiteSubdomain, readAiDraft, readAiDraftBandTakenSince, writeAiDraft } from "./ai-job-drafts.js";
+import { AI_FORM_REUSED_NOTE, aiSiblingJobForm } from "./ai-job-form-reuse.js";
 import { aiBracketedFactsNote, aiConfirmedPlan, aiDoctrineReview, aiGenerationSpent, aiJobBriefLine, aiLimitReview, aiModelNodeIds, aiPlanCreation, aiPlanReferenceLines, aiUnspentOutcome } from "./ai-job-generation.js";
 import { aiJobStepBudget } from "./ai-job-budget.js";
 import { registerAiJobStep } from "./ai-jobs.js";
@@ -73,6 +74,14 @@ import { registerAiJobStep } from "./ai-jobs.js";
  * one (AGL-3024). A copy still bound to the form it was copied from is a
  * failure, never an output.
  *
+ * A site that holds every form its plan includes refuses the draft
+ * (AGL-3765). A form the step builds for a page (a unit of a page job, a
+ * guided start or a build) then places the form another AI job made on the
+ * site moments before (`ai-job-form-reuse.ts`), as two jobs started from one
+ * brief race to. Failing that, a site that still had room when the plan was
+ * confirmed stops the job on our side, its credits given back; one that was
+ * already full is the workspace's limit, for the member to change.
+ *
  * Like the other generation steps, it runs on the job beat, never at an inline
  * door: it registers the least time its lookup rounds, its answer and its
  * re-ask need (AGL-3035), and runs without extended thinking under the routing
@@ -611,10 +620,16 @@ function listOf(items) {
         org: context.org,
         ownCheck: (hostId)=>aiJobPlanCreationsRefusal('form', context, hostId)
     });
+/**
+ * What a form step says when the site's last form was taken after its plan
+ * was confirmed (AGL-3765): by another build running beside it, or by a
+ * member. The failure is ours, so what the job spent is given back.
+ */ export const AI_FORM_BAND_TAKEN_COPY = 'Another build on this site used the last form your plan includes while this one was running, so this one stopped. Describe it again to build it with the form the site has now.';
 export function createAiJobFormStep(deps = {}) {
-    var _deps_readInventory, _deps_duplicate;
+    var _deps_readInventory, _deps_duplicate, _deps_siblingForm;
     const readInventory = (_deps_readInventory = deps.readInventory) != null ? _deps_readInventory : readSiteInventory;
     const duplicate = (_deps_duplicate = deps.duplicate) != null ? _deps_duplicate : duplicateResource;
+    const siblingForm = (_deps_siblingForm = deps.siblingForm) != null ? _deps_siblingForm : aiSiblingJobForm;
     return async ({ job, now, signal, firestore, modelFor })=>{
         var _ref, _orgSnapshot_data;
         var _job_inputs;
@@ -656,6 +671,49 @@ export function createAiJobFormStep(deps = {}) {
         const plan = aiConfirmedPlan(job);
         const creation = aiPlanCreation(plan, 'form');
         const name = (creation == null ? void 0 : creation.name) || AI_JOB_FORM_DEFAULT_NAME;
+        // The site holds every form its plan includes (AGL-3765). A unit places a
+        // form another build on this site just made, as its page would place any
+        // form the site has. Otherwise a site that had room when the plan was
+        // confirmed and was filled since stopped this job on our side, given
+        // back; one that was already full is the workspace's limit to change. A
+        // lookup that fails leaves the refusal as it was.
+        const refused = async (refusal, spent)=>{
+            const lookup = async (read, fallback)=>{
+                try {
+                    return await read();
+                } catch (error) {
+                    console.error('ai form step: band refusal lookup failed', {
+                        jobId: job.$id,
+                        hostId,
+                        error
+                    });
+                    return fallback;
+                }
+            };
+            const reused = await lookup(()=>siblingForm(firestore, {
+                    job,
+                    now
+                }), null);
+            if (reused) return _extends({}, spent, {
+                outputs: [
+                    output(reused, {
+                        note: AI_FORM_REUSED_NOTE
+                    })
+                ]
+            });
+            const taken = await lookup(()=>readAiDraftBandTakenSince(firestore, {
+                    kind: 'form',
+                    hostId,
+                    org,
+                    since: plan == null ? void 0 : plan.confirmedAt
+                }), false);
+            if (taken) return _extends({}, spent, {
+                failure: AI_FORM_BAND_TAKEN_COPY
+            });
+            return _extends({}, spent, {
+                review: aiLimitReview(refusal)
+            });
+        };
         // The plan starts from a copy of a form the site has (rule 15): the copy
         // is the draft, and nothing is generated. A source gone since the plan
         // was made is built from the brief instead, and one that does not collect
@@ -725,9 +783,7 @@ export function createAiJobFormStep(deps = {}) {
                 });
             }
             if (copy.ok === false && copy.status === 403) {
-                return aiUnspentOutcome(model, {
-                    review: aiLimitReview(copy.error)
-                });
+                return refused(copy.error, aiUnspentOutcome(model));
             }
         }
         const allowance = await aiDraftAllowanceRefusal(firestore, {
@@ -735,9 +791,7 @@ export function createAiJobFormStep(deps = {}) {
             hostId,
             org
         });
-        if (allowance) return aiUnspentOutcome(model, {
-            review: aiLimitReview(allowance)
-        });
+        if (allowance) return refused(allowance, aiUnspentOutcome(model));
         // What the person answered about this form, where they were asked
         // (AGL-2918): a scaffold's form unit carries the guided start's inputs.
         const decisions = {
@@ -818,9 +872,7 @@ export function createAiJobFormStep(deps = {}) {
         });
         if (write.ok === false) {
             if (write.status === 404) throw new Error(`site ${hostId} vanished while its form was generated`);
-            return _extends({}, spent, {
-                review: aiLimitReview(write.error)
-            });
+            return refused(write.error, spent);
         }
         // What the person decides next, then the facts the brief did not give (AGL-3056).
         const note = [