@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/runtime/site-inventory.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @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 AiInventoryTheme, type AiSiteInventory } from '../model/ai-site-inventory';
+/**
+ * The reader behind the site inventory (AGL-2935): one site's components,
+ * layouts, templates, forms, datasets, content collections, screens and
+ * theme, read as projections through the Admin SDK and reduced to the
+ * compact shape `model/ai-site-inventory.ts` describes.
+ *
+ * Every kind is a projection (`select`) of the fields the inventory names —
+ * never a node map, never a record's content — read one row past the cap so
+ * a full page is told apart from a cut one. Retired rows (soft-deleted,
+ * archived, a component never published) are filtered after the read, so a
+ * site with many retired rows can list fewer than the cap; the kind is still
+ * marked truncated when the read was cut, which is the honest answer.
+ *
+ * The window is WIDER than the prompt lists (AGL-2937). The prompt block
+ * lists `AI_SITE_INVENTORY_LISTED_PER_KIND` records of a kind because every
+ * character of it is billed on every attempt; the rest of the window is what
+ * the lookup tool searches, and a record never read cannot be found. The
+ * difference is paid in document reads rather than tokens — a projection of
+ * a few fields, once per job step — which is the cheaper of the two by some
+ * orders of magnitude.
+ */
+type Firestore = FirebaseFirestore.Firestore;
+type Data = Record<string, unknown>;
+export interface ReadSiteInventoryOptions {
+    /** The Admin SDK handle; the platform's default app when absent. */
+    firestore?: Firestore;
+    /** Rows read per kind; `AI_SITE_INVENTORY_MAX_PER_KIND` when absent, and never above it. */
+    maxPerKind?: number;
+}
+/** The theme a site renders with, reduced to what a plan and an email can act on. */
+export declare function aiInventoryTheme(host: Data | null): AiInventoryTheme | null;
+/**
+ * Read one site's inventory for a generation.
+ *
+ * SCOPED before anything is read. The job names a site and an org, and
+ * nothing the reader is handed proves the site belongs to the org, so it asks
+ * the host index first and refuses a pairing it does not record: another
+ * workspace's component names are not this workspace's prompt. Datasets are
+ * org-owned and narrowed to what this site may see.
+ *
+ * Throws `AiInventoryScopeError` for a site outside the org, and lets a
+ * Firestore failure propagate: a planner handed an empty inventory by
+ * mistake would create everything the site already has.
+ */
+export declare function readSiteInventory(orgId: string, hostId: string, options?: ReadSiteInventoryOptions): Promise<AiSiteInventory>;
+export {};

package/src/lib/runtime/site-inventory.js

@@ -0,0 +1,230 @@
+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 { hostCollectionKind } from "@aglyn/aglyn/app-utils/collection-kind";
+import { effectiveDatasetModel } from "@aglyn/aglyn/app-utils/dataset-models";
+import { datasetDisplayName } from "@aglyn/aglyn/app-utils/datasets";
+import { isFormArchived } from "@aglyn/aglyn/app-utils/forms";
+import { describeTheme, resolveSiteTheme } from "@aglyn/aglyn/app-utils/marketplace-theme";
+import { SCREEN_KIND_TEMPLATE } from "@aglyn/aglyn/app-utils/screen-route";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin/server/firebase-admin";
+import { resolveOrgIdForHost, scopedToHost } from "@aglyn/tenant-data-admin/server/organizations";
+import { AI_INVENTORY_KINDS, AI_SITE_INVENTORY_MAX_PER_KIND, AiInventoryScopeError } from "../model/ai-site-inventory.js";
+import { aiBracketedFacts } from "./ai-doctrine-validators.js";
+function text(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/** A record's name, or its id when it was saved without one. */ function nameOf(data, id, ...fields) {
+    for (const field of fields){
+        const value = text(data[field]);
+        if (value) return value;
+    }
+    return id;
+}
+/** The flat `path → color` leaves of one scheme, e.g. `primary.main`. */ function schemeColors(scheme) {
+    const colors = {};
+    const visit = (value, path)=>{
+        if (typeof value === 'string') {
+            if (path) colors[path] = value;
+            return;
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value)) return;
+        for (const [key, inner] of Object.entries(value)){
+            visit(inner, path ? `${path}.${key}` : key);
+        }
+    };
+    visit(scheme, '');
+    return colors;
+}
+/** The theme a site renders with, reduced to what a plan and an email can act on. */ export function aiInventoryTheme(host) {
+    var _theme_fonts;
+    var _theme_colorSchemes;
+    const theme = resolveSiteTheme(host);
+    if (!theme) return null;
+    const fonts = new Set();
+    for (const font of (_theme_fonts = theme.fonts) != null ? _theme_fonts : []){
+        if (text(font == null ? void 0 : font.family)) fonts.add(text(font.family));
+    }
+    return {
+        summary: describeTheme(theme),
+        colors: schemeColors((_theme_colorSchemes = theme.colorSchemes) == null ? void 0 : _theme_colorSchemes.light),
+        fonts: [
+            ...fonts
+        ]
+    };
+}
+async function readWindow(query, fields, cap, map) {
+    const snapshot = await query.select(...fields).limit(cap + 1).get();
+    const rows = [];
+    for (const doc of snapshot.docs.slice(0, cap)){
+        var _doc_data;
+        const row = map(doc.id, (_doc_data = doc.data()) != null ? _doc_data : {});
+        if (row) rows.push(row);
+    }
+    return {
+        rows,
+        truncated: snapshot.docs.length > cap
+    };
+}
+/**
+ * Read one site's inventory for a generation.
+ *
+ * SCOPED before anything is read. The job names a site and an org, and
+ * nothing the reader is handed proves the site belongs to the org, so it asks
+ * the host index first and refuses a pairing it does not record: another
+ * workspace's component names are not this workspace's prompt. Datasets are
+ * org-owned and narrowed to what this site may see.
+ *
+ * Throws `AiInventoryScopeError` for a site outside the org, and lets a
+ * Firestore failure propagate: a planner handed an empty inventory by
+ * mistake would create everything the site already has.
+ */ export async function readSiteInventory(orgId, hostId, options = {}) {
+    var _options_firestore, _options_maxPerKind, _hostDoc_data;
+    const owner = await resolveOrgIdForHost(hostId);
+    if (!owner || owner !== orgId) throw new AiInventoryScopeError(hostId);
+    const firestore = (_options_firestore = options.firestore) != null ? _options_firestore : firebaseAdmin.app().firestore();
+    const cap = Math.min(AI_SITE_INVENTORY_MAX_PER_KIND, Math.max(1, Math.floor((_options_maxPerKind = options.maxPerKind) != null ? _options_maxPerKind : AI_SITE_INVENTORY_MAX_PER_KIND)));
+    const host = firestore.collection('hosts').doc(hostId);
+    const [components, layouts, templates, forms, datasets, collections, screens, hostDoc] = await Promise.all([
+        readWindow(host.collection('components'), [
+            'displayName',
+            'props',
+            'rootId',
+            'versionId',
+            'deletedAt'
+        ], cap, (id, data)=>{
+            // Soft-deleted, or never published: an instance of either renders nothing.
+            if (data['deletedAt'] || !(data['rootId'] || data['versionId'])) return null;
+            const props = {};
+            const bracketedDefaults = {};
+            for (const prop of Array.isArray(data['props']) ? data['props'] : []){
+                const name = text(prop == null ? void 0 : prop['name']);
+                if (!name) continue;
+                props[name] = text(prop['type']) || 'text';
+                const facts = aiBracketedFacts([
+                    text(prop['defaultValue'])
+                ]);
+                if (facts.length) bracketedDefaults[name] = facts;
+            }
+            return _extends({
+                id,
+                name: nameOf(data, id, 'displayName'),
+                props
+            }, Object.keys(bracketedDefaults).length ? {
+                bracketedDefaults
+            } : {});
+        }),
+        readWindow(host.collection('layouts'), [
+            'displayName',
+            'layoutId',
+            'deletedAt'
+        ], cap, (id, data)=>data['deletedAt'] ? null : {
+                id,
+                name: nameOf(data, id, 'displayName'),
+                parentId: text(data['layoutId']) || null
+            }),
+        readWindow(host.collection('templates'), [
+            'displayName',
+            'kind',
+            'deletedAt'
+        ], cap, (id, data)=>data['deletedAt'] ? null : {
+                id,
+                name: nameOf(data, id, 'displayName'),
+                kind: text(data['kind']) || 'page'
+            }),
+        readWindow(host.collection('forms'), [
+            'displayName',
+            'slug',
+            'fields',
+            'archivedAt'
+        ], cap, (id, data)=>isFormArchived(data) ? null : {
+                id,
+                name: nameOf(data, id, 'displayName', 'slug'),
+                fields: (Array.isArray(data['fields']) ? data['fields'] : []).map((field)=>text(field == null ? void 0 : field['fieldName'])).filter(Boolean)
+            }),
+        readWindow(scopedToHost(firestore.collection('orgs').doc(orgId).collection('datasets'), hostId), [
+            'displayName',
+            'name',
+            'fields',
+            'model',
+            'deletedAt'
+        ], cap, (id, data)=>{
+            if (data['deletedAt']) return null;
+            const model = effectiveDatasetModel(data);
+            const fields = model.order.map((fieldId)=>{
+                var _model_fields_fieldId;
+                return text((_model_fields_fieldId = model.fields[fieldId]) == null ? void 0 : _model_fields_fieldId.name) || fieldId;
+            }).filter(Boolean);
+            return {
+                id,
+                name: datasetDisplayName(data) || id,
+                fields
+            };
+        }),
+        readWindow(host.collection('collections'), [
+            'displayName',
+            'name',
+            'slug',
+            'kind'
+        ], cap, (id, data)=>hostCollectionKind(data) !== 'content' ? null : {
+                id,
+                name: nameOf(data, id, 'displayName', 'name', 'slug'),
+                slug: text(data['slug'])
+            }),
+        readWindow(host.collection('screens'), [
+            'displayName',
+            'slug',
+            'layoutId',
+            'kind',
+            'deletedAt'
+        ], cap, (id, data)=>{
+            const kind = text(data['kind']);
+            // An email design and an error body are not pages a plan links or duplicates.
+            if (data['deletedAt'] || kind && kind !== SCREEN_KIND_TEMPLATE) return null;
+            return {
+                id,
+                name: nameOf(data, id, 'displayName', 'slug'),
+                slug: text(data['slug']),
+                layoutId: text(data['layoutId']) || null,
+                template: kind === SCREEN_KIND_TEMPLATE
+            };
+        }),
+        host.get()
+    ]);
+    const windows = {
+        components,
+        layouts,
+        templates,
+        forms,
+        datasets,
+        collections,
+        screens
+    };
+    return {
+        hostId,
+        components: components.rows,
+        layouts: layouts.rows,
+        templates: templates.rows,
+        forms: forms.rows,
+        datasets: datasets.rows,
+        collections: collections.rows,
+        screens: screens.rows,
+        theme: aiInventoryTheme(hostDoc.exists ? (_hostDoc_data = hostDoc.data()) != null ? _hostDoc_data : {} : null),
+        truncated: AI_INVENTORY_KINDS.filter((kind)=>windows[kind].truncated)
+    };
+}
+
+//# sourceMappingURL=site-inventory.js.map

package/src/lib/runtime/site-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/runtime/site-inventory.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 { hostCollectionKind } from '@aglyn/aglyn/app-utils/collection-kind'\nimport { effectiveDatasetModel } from '@aglyn/aglyn/app-utils/dataset-models'\nimport { datasetDisplayName } from '@aglyn/aglyn/app-utils/datasets'\nimport { isFormArchived } from '@aglyn/aglyn/app-utils/forms'\nimport {\n  describeTheme,\n  resolveSiteTheme,\n  type ThemeHostDocument,\n} from '@aglyn/aglyn/app-utils/marketplace-theme'\nimport { SCREEN_KIND_TEMPLATE } from '@aglyn/aglyn/app-utils/screen-route'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin/server/firebase-admin'\nimport {\n  resolveOrgIdForHost,\n  scopedToHost,\n} from '@aglyn/tenant-data-admin/server/organizations'\nimport {\n  AI_INVENTORY_KINDS,\n  AI_SITE_INVENTORY_MAX_PER_KIND,\n  AiInventoryScopeError,\n  type AiComponentPropTypes,\n  type AiInventoryCollection,\n  type AiInventoryComponent,\n  type AiInventoryDataset,\n  type AiInventoryForm,\n  type AiInventoryKind,\n  type AiInventoryLayout,\n  type AiInventoryScreen,\n  type AiInventoryTemplate,\n  type AiInventoryTheme,\n  type AiSiteInventory,\n} from '../model/ai-site-inventory'\nimport { aiBracketedFacts } from './ai-doctrine-validators'\n\n/**\n * The reader behind the site inventory (AGL-2935): one site's components,\n * layouts, templates, forms, datasets, content collections, screens and\n * theme, read as projections through the Admin SDK and reduced to the\n * compact shape `model/ai-site-inventory.ts` describes.\n *\n * Every kind is a projection (`select`) of the fields the inventory names —\n * never a node map, never a record's content — read one row past the cap so\n * a full page is told apart from a cut one. Retired rows (soft-deleted,\n * archived, a component never published) are filtered after the read, so a\n * site with many retired rows can list fewer than the cap; the kind is still\n * marked truncated when the read was cut, which is the honest answer.\n *\n * The window is WIDER than the prompt lists (AGL-2937). The prompt block\n * lists `AI_SITE_INVENTORY_LISTED_PER_KIND` records of a kind because every\n * character of it is billed on every attempt; the rest of the window is what\n * the lookup tool searches, and a record never read cannot be found. The\n * difference is paid in document reads rather than tokens — a projection of\n * a few fields, once per job step — which is the cheaper of the two by some\n * orders of magnitude.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\ntype Data = Record<string, unknown>\n\nexport interface ReadSiteInventoryOptions {\n  /** The Admin SDK handle; the platform's default app when absent. */\n  firestore?: Firestore\n  /** Rows read per kind; `AI_SITE_INVENTORY_MAX_PER_KIND` when absent, and never above it. */\n  maxPerKind?: number\n}\n\nfunction text(value: unknown): string {\n  return typeof value === 'string' ? value.trim() : ''\n}\n\n/** A record's name, or its id when it was saved without one. */\nfunction nameOf(data: Data, id: string, ...fields: string[]): string {\n  for (const field of fields) {\n    const value = text(data[field])\n    if (value) return value\n  }\n  return id\n}\n\n/** The flat `path → color` leaves of one scheme, e.g. `primary.main`. */\nfunction schemeColors(scheme: unknown): Record<string, string> {\n  const colors: Record<string, string> = {}\n  const visit = (value: unknown, path: string) => {\n    if (typeof value === 'string') {\n      if (path) colors[path] = value\n      return\n    }\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return\n    for (const [key, inner] of Object.entries(value as Data)) {\n      visit(inner, path ? `${path}.${key}` : key)\n    }\n  }\n  visit(scheme, '')\n  return colors\n}\n\n/** The theme a site renders with, reduced to what a plan and an email can act on. */\nexport function aiInventoryTheme(host: Data | null): AiInventoryTheme | null {\n  const theme = resolveSiteTheme(host as ThemeHostDocument | null)\n  if (!theme) return null\n  const fonts = new Set<string>()\n  for (const font of theme.fonts ?? []) {\n    if (text(font?.family)) fonts.add(text(font.family))\n  }\n  return {\n    summary: describeTheme(theme),\n    colors: schemeColors(theme.colorSchemes?.light),\n    fonts: [...fonts],\n  }\n}\n\ninterface Window<T> {\n  rows: T[]\n  truncated: boolean\n}\n\nasync function readWindow<T>(\n  query: FirebaseFirestore.Query,\n  fields: string[],\n  cap: number,\n  map: (id: string, data: Data) => T | null,\n): Promise<Window<T>> {\n  const snapshot = await query\n    .select(...fields)\n    .limit(cap + 1)\n    .get()\n  const rows: T[] = []\n  for (const doc of snapshot.docs.slice(0, cap)) {\n    const row = map(doc.id, (doc.data() ?? {}) as Data)\n    if (row) rows.push(row)\n  }\n  return { rows, truncated: snapshot.docs.length > cap }\n}\n\n/**\n * Read one site's inventory for a generation.\n *\n * SCOPED before anything is read. The job names a site and an org, and\n * nothing the reader is handed proves the site belongs to the org, so it asks\n * the host index first and refuses a pairing it does not record: another\n * workspace's component names are not this workspace's prompt. Datasets are\n * org-owned and narrowed to what this site may see.\n *\n * Throws `AiInventoryScopeError` for a site outside the org, and lets a\n * Firestore failure propagate: a planner handed an empty inventory by\n * mistake would create everything the site already has.\n */\nexport async function readSiteInventory(\n  orgId: string,\n  hostId: string,\n  options: ReadSiteInventoryOptions = {},\n): Promise<AiSiteInventory> {\n  const owner = await resolveOrgIdForHost(hostId)\n  if (!owner || owner !== orgId) throw new AiInventoryScopeError(hostId)\n  const firestore = options.firestore ?? firebaseAdmin.app().firestore()\n  const cap = Math.min(\n    AI_SITE_INVENTORY_MAX_PER_KIND,\n    Math.max(1, Math.floor(options.maxPerKind ?? AI_SITE_INVENTORY_MAX_PER_KIND)),\n  )\n  const host = firestore.collection('hosts').doc(hostId)\n\n  const [components, layouts, templates, forms, datasets, collections, screens, hostDoc] =\n    await Promise.all([\n      readWindow<AiInventoryComponent>(\n        host.collection('components'),\n        ['displayName', 'props', 'rootId', 'versionId', 'deletedAt'],\n        cap,\n        (id, data) => {\n          // Soft-deleted, or never published: an instance of either renders nothing.\n          if (data['deletedAt'] || !(data['rootId'] || data['versionId'])) return null\n          const props: AiComponentPropTypes = {}\n          const bracketedDefaults: Record<string, string[]> = {}\n          for (const prop of Array.isArray(data['props']) ? (data['props'] as Data[]) : []) {\n            const name = text(prop?.['name'])\n            if (!name) continue\n            props[name] = text(prop['type']) || 'text'\n            const facts = aiBracketedFacts([text(prop['defaultValue'])])\n            if (facts.length) bracketedDefaults[name] = facts\n          }\n          return {\n            id,\n            name: nameOf(data, id, 'displayName'),\n            props,\n            ...(Object.keys(bracketedDefaults).length ? { bracketedDefaults } : {}),\n          }\n        },\n      ),\n      readWindow<AiInventoryLayout>(\n        host.collection('layouts'),\n        ['displayName', 'layoutId', 'deletedAt'],\n        cap,\n        (id, data) =>\n          data['deletedAt']\n            ? null\n            : {\n                id,\n                name: nameOf(data, id, 'displayName'),\n                parentId: text(data['layoutId']) || null,\n              },\n      ),\n      readWindow<AiInventoryTemplate>(\n        host.collection('templates'),\n        ['displayName', 'kind', 'deletedAt'],\n        cap,\n        (id, data) =>\n          data['deletedAt']\n            ? null\n            : { id, name: nameOf(data, id, 'displayName'), kind: text(data['kind']) || 'page' },\n      ),\n      readWindow<AiInventoryForm>(\n        host.collection('forms'),\n        ['displayName', 'slug', 'fields', 'archivedAt'],\n        cap,\n        (id, data) =>\n          isFormArchived(data as { archivedAt?: unknown })\n            ? null\n            : {\n                id,\n                name: nameOf(data, id, 'displayName', 'slug'),\n                fields: (Array.isArray(data['fields']) ? (data['fields'] as Data[]) : [])\n                  .map((field) => text(field?.['fieldName']))\n                  .filter(Boolean),\n              },\n      ),\n      readWindow<AiInventoryDataset>(\n        scopedToHost(firestore.collection('orgs').doc(orgId).collection('datasets'), hostId),\n        ['displayName', 'name', 'fields', 'model', 'deletedAt'],\n        cap,\n        (id, data) => {\n          if (data['deletedAt']) return null\n          const model = effectiveDatasetModel(\n            data as Parameters<typeof effectiveDatasetModel>[0],\n          )\n          const fields = model.order\n            .map((fieldId) => text(model.fields[fieldId]?.name) || fieldId)\n            .filter(Boolean)\n          return { id, name: datasetDisplayName(data) || id, fields }\n        },\n      ),\n      readWindow<AiInventoryCollection>(\n        host.collection('collections'),\n        ['displayName', 'name', 'slug', 'kind'],\n        cap,\n        (id, data) =>\n          hostCollectionKind(data) !== 'content'\n            ? null\n            : {\n                id,\n                name: nameOf(data, id, 'displayName', 'name', 'slug'),\n                slug: text(data['slug']),\n              },\n      ),\n      readWindow<AiInventoryScreen>(\n        host.collection('screens'),\n        ['displayName', 'slug', 'layoutId', 'kind', 'deletedAt'],\n        cap,\n        (id, data) => {\n          const kind = text(data['kind'])\n          // An email design and an error body are not pages a plan links or duplicates.\n          if (data['deletedAt'] || (kind && kind !== SCREEN_KIND_TEMPLATE)) return null\n          return {\n            id,\n            name: nameOf(data, id, 'displayName', 'slug'),\n            slug: text(data['slug']),\n            layoutId: text(data['layoutId']) || null,\n            template: kind === SCREEN_KIND_TEMPLATE,\n          }\n        },\n      ),\n      host.get(),\n    ])\n\n  const windows: Record<AiInventoryKind, Window<unknown>> = {\n    components,\n    layouts,\n    templates,\n    forms,\n    datasets,\n    collections,\n    screens,\n  }\n  return {\n    hostId,\n    components: components.rows,\n    layouts: layouts.rows,\n    templates: templates.rows,\n    forms: forms.rows,\n    datasets: datasets.rows,\n    collections: collections.rows,\n    screens: screens.rows,\n    theme: aiInventoryTheme(hostDoc.exists ? ((hostDoc.data() ?? {}) as Data) : null),\n    truncated: AI_INVENTORY_KINDS.filter((kind) => windows[kind].truncated),\n  }\n}\n"],"names":["hostCollectionKind","effectiveDatasetModel","datasetDisplayName","isFormArchived","describeTheme","resolveSiteTheme","SCREEN_KIND_TEMPLATE","firebaseAdmin","resolveOrgIdForHost","scopedToHost","AI_INVENTORY_KINDS","AI_SITE_INVENTORY_MAX_PER_KIND","AiInventoryScopeError","aiBracketedFacts","text","value","trim","nameOf","data","id","fields","field","schemeColors","scheme","colors","visit","path","Array","isArray","key","inner","Object","entries","aiInventoryTheme","host","theme","fonts","Set","font","family","add","summary","colorSchemes","light","readWindow","query","cap","map","snapshot","select","limit","get","rows","doc","docs","slice","row","push","truncated","length","readSiteInventory","orgId","hostId","options","hostDoc","owner","firestore","app","Math","min","max","floor","maxPerKind","collection","components","layouts","templates","forms","datasets","collections","screens","Promise","all","props","bracketedDefaults","prop","name","facts","keys","parentId","kind","filter","Boolean","model","order","fieldId","slug","layoutId","template","windows","exists"],"mappings":"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"}

package/src/lib/server/ai-admin-org.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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 StaffOrgAiJobs } from '../usage/staff-org-ai';
+/** Test seam: drop every cached Stripe answer. */
+export declare function resetAddonSinceCache(): void;
+/**
+ * The month's generation jobs, summarized (AGL-2904's collection).
+ *
+ * Reads `orgs/{orgId}/aiJobs` by `createdAt` from the first instant of the
+ * month, newest first, up to `JOBS_SCAN`. An org with no such collection
+ * answers an empty snapshot, which is the honest "no generation jobs yet";
+ * a read that FAILED answers `null`, which the card renders as a failure
+ * rather than as an idle org. The field names are the ones `AiJob` declares
+ * in `ai-jobs.types.ts`: `kind`, `status`, `creditsReserved`, `creditsSpent`,
+ * `createdAt`, `createdBy`.
+ */
+export declare function readOrgAiJobsSummary(firestore: FirebaseFirestore.Firestore, orgId: string, month: string): Promise<StaffOrgAiJobs | null>;
+declare function handler(request: Request): Promise<Response>;
+export { handler as GET };