@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/insights/ai-insight-digest.js

@@ -0,0 +1,363 @@
+/**
+ * @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 { FieldPath } from "firebase-admin/firestore";
+import { INSIGHT_DIGESTS_FIELD, insightDigestSubscribed, notificationMuted } from "@aglyn/aglyn/app-utils/notifications";
+import { hostRoleFor } from "@aglyn/aglyn/app-utils/organizations";
+import { checkEntitlement, resolveBrandingProfile, resolveEffectivePlan } from "@aglyn/aglyn/app-utils/plan-entitlements";
+import { isReleaseFlagOnForOrg, parseOrgReleaseFlagOverrides } from "@aglyn/aglyn/app-utils/release-flags";
+import { AI_INSIGHTS_COLLECTION, aiInsightIsoWeek } from "../model/ai-insight.js";
+import { isAiOnForSite } from "../model/ai-site-switch.js";
+import { cancelAiJob, createAiJob, getAiJob } from "../jobs/ai-jobs.js";
+export const AI_INSIGHTS_DIGEST_CRON_ID = 'ai-insights-digest';
+export const AI_INSIGHTS_DIGEST_PATH = 'admin/ai-insights-digest';
+/** Orgs one call reads; a chunk that times out never advances the cursor, so the safe size is one that finishes. */ export const AI_INSIGHT_DIGEST_ORG_CHUNK = 25;
+/** Sites one workspace's digest covers a week. */ export const AI_INSIGHT_DIGEST_MAX_SITES = 5;
+/** Sites a workspace's sweep reads before it ranks them. */ export const AI_INSIGHT_DIGEST_HOST_READ_LIMIT = 50;
+/** Workspaces one run delivers to, per week. */ export const AI_INSIGHT_DIGEST_DELIVER_LIMIT = 100;
+/** How long a digest's job may take before its week is given up. */ export const AI_INSIGHT_DIGEST_DEADLINE_MS = 48 * 60 * 60000;
+/**
+ * The time one call works before it stops and leaves the rest to the next:
+ * inside the plugin dispatcher's 60 s function ceiling, with room for the
+ * reads before the first check and the reply after the last. A call killed
+ * mid-send could send one person a site's digest twice, because a send is
+ * stamped after it goes.
+ */ export const AI_INSIGHT_DIGEST_RUN_BUDGET_MS = 45000;
+export const AI_INSIGHT_DIGEST_MARKERS = 'aiInsightDigests';
+export const AI_INSIGHT_DIGEST_QUEUE = 'aiInsightDigestQueue';
+const str = (value)=>typeof value === 'string' ? value.trim() : '';
+/** The week a Monday digest covers: the week the run falls in. */ export function aiInsightDigestWeek(now) {
+    return aiInsightIsoWeek(now);
+}
+/** The week before, whose late digests a run still delivers. */ function previousWeek(now) {
+    return aiInsightIsoWeek(new Date(now.getTime() - 7 * 86400000));
+}
+/** A digest email's words: the insights, the site's Analytics page, and where to turn it off. */ export function aiInsightDigestEmailText(input) {
+    return [
+        `Here is what ${input.siteName}'s figures showed this week.`,
+        '',
+        ...input.insights.map((insight, index)=>`${index + 1}. ${insight.text}`),
+        '',
+        input.analyticsUrl ? `Each of these is traced to the figures it cites. See them in ${input.productName}: ${input.analyticsUrl}` : `Each of these is traced to the figures it cites. See them on the site's Analytics page in ${input.productName}.`,
+        '',
+        input.settingsUrl ? `You asked for weekly insights for this workspace. Turn them off in Notifications: ${input.settingsUrl}` : `You asked for weekly insights for this workspace. Turn them off in your Notifications settings.`
+    ].join('\n');
+}
+async function readUsers(firestore, uids) {
+    if (!uids.length) return new Map();
+    const docs = await firestore.getAll(...uids.map((uid)=>firestore.collection('users').doc(uid)));
+    return new Map(docs.map((doc)=>[
+            doc.id,
+            doc
+        ]));
+}
+/** Creates one workspace's digests for the week; answers how many jobs it created. */ async function createOrgDigest(deps, orgDoc, week) {
+    var _orgDoc_data;
+    const { firestore, now } = deps;
+    const orgId = orgDoc.id;
+    const org = (_orgDoc_data = orgDoc.data()) != null ? _orgDoc_data : {};
+    if (!checkEntitlement(org, 'aiGenerative')) return 0;
+    const flagOn = isReleaseFlagOnForOrg('release_ai_generative', deps.flagValue, orgId, parseOrgReleaseFlagOverrides(org['releaseFlags']), resolveEffectivePlan(org));
+    if (!flagOn || await deps.paused(orgId)) return 0;
+    const markerRef = orgDoc.ref.collection(AI_INSIGHT_DIGEST_MARKERS).doc(week);
+    if ((await markerRef.get()).exists) return 0;
+    const members = (await deps.listMembers(orgId)).filter((member)=>member.orgSuspended !== true);
+    const users = await readUsers(firestore, members.map((member)=>member.$id).sort());
+    const subscribers = members.filter((member)=>{
+        var _users_get;
+        return insightDigestSubscribed((_users_get = users.get(member.$id)) == null ? void 0 : _users_get.get(INSIGHT_DIGESTS_FIELD), orgId);
+    }).sort((a, b)=>a.$id.localeCompare(b.$id));
+    if (!subscribers.length) return 0;
+    const hosts = await firestore.collection('hosts').where('orgId', '==', orgId).limit(AI_INSIGHT_DIGEST_HOST_READ_LIMIT).get();
+    const yesterday = new Date(now.getTime() - 86400000).toISOString().slice(0, 10);
+    const candidates = [];
+    for (const host of hosts.docs){
+        var _host_data, _day_get;
+        const data = (_host_data = host.data()) != null ? _host_data : {};
+        if (!isAiOnForSite(org, data)) continue;
+        let creator = null;
+        for (const member of subscribers){
+            if (hostRoleFor(member, host.id) !== null && await deps.mayGenerate(orgId, host.id, member)) {
+                creator = member.$id;
+                break;
+            }
+        }
+        if (!creator) continue;
+        const day = await host.ref.collection('analytics').doc(yesterday).get();
+        candidates.push({
+            hostId: host.id,
+            name: str(data['displayName']) || str(data['name']) || str(data['subdomain']) || host.id,
+            creator,
+            views: Number((_day_get = day.get('total')) != null ? _day_get : 0) || 0
+        });
+    }
+    const chosen = candidates.sort((a, b)=>b.views - a.views || a.hostId.localeCompare(b.hostId)).slice(0, AI_INSIGHT_DIGEST_MAX_SITES);
+    if (!chosen.length) return 0;
+    const sites = {};
+    for (const site of chosen){
+        const job = await createAiJob(firestore, {
+            orgId,
+            hostId: site.hostId,
+            kind: 'insight',
+            brief: `Weekly insights for ${site.name}`,
+            inputs: {
+                surface: 'digest',
+                week
+            },
+            createdBy: site.creator
+        }, now);
+        sites[site.hostId] = {
+            jobId: job.$id,
+            name: site.name,
+            state: 'pending'
+        };
+    }
+    const marker = {
+        week,
+        createdAtMs: now.getTime(),
+        sites
+    };
+    await markerRef.set(marker);
+    await firestore.collection(AI_INSIGHT_DIGEST_QUEUE).doc(week).set({
+        week,
+        pending: {
+            [orgId]: true
+        }
+    }, {
+        merge: true
+    });
+    return chosen.length;
+}
+/** Delivers or settles one workspace's digests for a week; `deferred` when the send rate refused. */ async function deliverOrgDigest(deps, orgId, week, overBudget) {
+    var _data, _marker_sites;
+    const { firestore, now } = deps;
+    const orgRef = firestore.collection('orgs').doc(orgId);
+    const markerRef = orgRef.collection(AI_INSIGHT_DIGEST_MARKERS).doc(week);
+    const markerSnapshot = await markerRef.get();
+    const result = {
+        delivered: 0,
+        skipped: 0,
+        settled: true,
+        deferred: false
+    };
+    if (!markerSnapshot.exists) return result;
+    const marker = markerSnapshot.data();
+    const org = (_data = (await orgRef.get()).data()) != null ? _data : {};
+    let members = null;
+    const branding = resolveBrandingProfile(org);
+    for (const [hostId, site] of Object.entries((_marker_sites = marker.sites) != null ? _marker_sites : {})){
+        var _data1;
+        var _record_insights;
+        if (site.state !== 'pending') continue;
+        const settle = async (state)=>{
+            // Replaced whole rather than merged, which drops `sent`.
+            const settled = {
+                jobId: site.jobId,
+                name: site.name,
+                state
+            };
+            await markerRef.update({
+                [`sites.${hostId}`]: settled
+            });
+            if (state === 'delivered') result.delivered += 1;
+            else result.skipped += 1;
+        };
+        const job = await getAiJob(firestore, orgId, site.jobId);
+        if (!job || job.status === 'failed' || job.status === 'canceled') {
+            await settle('skipped');
+            continue;
+        }
+        if (job.status !== 'done') {
+            var _marker_createdAtMs;
+            const late = now.getTime() - Number((_marker_createdAtMs = marker.createdAtMs) != null ? _marker_createdAtMs : 0) > AI_INSIGHT_DIGEST_DEADLINE_MS;
+            // A job parked for credits — a Free workspace at its band — is given up
+            // rather than left to spend on a week that is already over.
+            if (job.status === 'needs_input' || late) {
+                await cancelAiJob(firestore, orgId, site.jobId, now);
+                await settle('skipped');
+            } else {
+                result.settled = false;
+            }
+            continue;
+        }
+        const answer = await orgRef.collection(AI_INSIGHTS_COLLECTION).doc(site.jobId).get();
+        const record = answer.exists ? answer.data() : null;
+        if (!(record == null ? void 0 : (_record_insights = record.insights) == null ? void 0 : _record_insights.length)) {
+            await settle('skipped');
+            continue;
+        }
+        members != null ? members : members = (await deps.listMembers(orgId)).filter((member)=>member.orgSuspended !== true);
+        const reaching = members.filter((member)=>hostRoleFor(member, hostId) !== null);
+        const users = await readUsers(firestore, reaching.map((member)=>member.$id).sort());
+        const host = (_data1 = (await firestore.collection('hosts').doc(hostId).get()).data()) != null ? _data1 : {};
+        const orgSlug = str(org['slug']);
+        const subdomain = str(host['subdomain']);
+        const origin = deps.consoleOrigin;
+        const analyticsUrl = origin && orgSlug && subdomain ? `${origin}/${orgSlug}/hosts/${subdomain}/analytics` : null;
+        for (const member of reaching.sort((a, b)=>a.$id.localeCompare(b.$id))){
+            var _member_email;
+            var _site_sent;
+            const user = users.get(member.$id);
+            if (!insightDigestSubscribed(user == null ? void 0 : user.get(INSIGHT_DIGESTS_FIELD), orgId)) continue;
+            if ((_site_sent = site.sent) == null ? void 0 : _site_sent[member.$id]) continue;
+            if (overBudget()) {
+                // Out of time: what was sent is stamped, and the next run sends the rest.
+                result.deferred = true;
+                result.settled = false;
+                return result;
+            }
+            const address = str((_member_email = member.email) != null ? _member_email : user == null ? void 0 : user.get('email')).toLowerCase();
+            if (address.includes('@')) {
+                const sent = await deps.send({
+                    to: address,
+                    subject: `Your weekly insights for ${site.name}`,
+                    text: aiInsightDigestEmailText({
+                        siteName: site.name,
+                        productName: branding.productName,
+                        insights: record.insights,
+                        analyticsUrl,
+                        settingsUrl: origin ? `${origin}/manage/notifications` : null
+                    }),
+                    fromName: branding.fromName
+                });
+                if (sent.rateLimited) {
+                    // Nothing is marked, so the next run delivers this site whole.
+                    result.deferred = true;
+                    result.settled = false;
+                    return result;
+                }
+            }
+            if (!notificationMuted(user == null ? void 0 : user.get('notificationPrefs'), 'content.insightsDigest')) {
+                await deps.notify(member.$id, {
+                    title: `Weekly insights · ${site.name}`,
+                    body: record.insights[0].text,
+                    link: `/${hostId}/analytics`,
+                    orgId,
+                    hostId
+                });
+            }
+            await markerRef.set({
+                sites: {
+                    [hostId]: {
+                        sent: {
+                            [member.$id]: true
+                        }
+                    }
+                }
+            }, {
+                merge: true
+            });
+        }
+        await settle('delivered');
+    }
+    return result;
+}
+/**
+ * One call of the sweep: delivery for this week and the last on the first
+ * call, then — on a Monday — one chunk of workspaces' creation, resumed by
+ * `cursor`. The response shape is the console crons' (`nextCursor`, `done`),
+ * so the scheduler's loop carries a platform of any size across calls.
+ */ export async function runAiInsightDigestSweep(deps, options) {
+    var _deps_budgetMs, _ref;
+    var _orgs_;
+    const { firestore, now } = deps;
+    const startedAtMs = Date.now();
+    const budgetMs = (_deps_budgetMs = deps.budgetMs) != null ? _deps_budgetMs : AI_INSIGHT_DIGEST_RUN_BUDGET_MS;
+    const overBudget = ()=>Date.now() - startedAtMs > budgetMs;
+    const week = aiInsightDigestWeek(now);
+    const report = {
+        week,
+        swept: 0,
+        created: 0,
+        delivered: 0,
+        skipped: 0,
+        deferred: false,
+        nextCursor: null,
+        done: true
+    };
+    if (!options.cursor) {
+        for (const owed of [
+            previousWeek(now),
+            week
+        ]){
+            var _get;
+            const queueRef = firestore.collection(AI_INSIGHT_DIGEST_QUEUE).doc(owed);
+            const pending = Object.entries((_get = (await queueRef.get()).get('pending')) != null ? _get : {}).filter(([, owed])=>owed === true).map(([orgId])=>orgId).sort().slice(0, AI_INSIGHT_DIGEST_DELIVER_LIMIT);
+            for (const orgId of pending){
+                if (overBudget()) {
+                    report.deferred = true;
+                    return report;
+                }
+                try {
+                    const delivered = await deliverOrgDigest(deps, orgId, owed, overBudget);
+                    report.delivered += delivered.delivered;
+                    report.skipped += delivered.skipped;
+                    if (delivered.settled) {
+                        await queueRef.set({
+                            pending: {
+                                [orgId]: false
+                            }
+                        }, {
+                            merge: true
+                        });
+                    }
+                    if (delivered.deferred) {
+                        report.deferred = true;
+                        return report;
+                    }
+                } catch (error) {
+                    console.error('ai insight digest delivery failed', {
+                        orgId,
+                        week: owed,
+                        error
+                    });
+                }
+            }
+        }
+    }
+    // Monday is the week's first day by ISO 8601, and the day a digest is made.
+    if (now.getUTCDay() !== 1) return report;
+    let query = firestore.collection('orgs').orderBy(FieldPath.documentId()).limit(AI_INSIGHT_DIGEST_ORG_CHUNK + 1);
+    if (options.cursor) query = query.startAfter(firestore.collection('orgs').doc(options.cursor));
+    const page = await query.get();
+    const orgs = page.docs.slice(0, AI_INSIGHT_DIGEST_ORG_CHUNK);
+    for (const [index, orgDoc] of orgs.entries()){
+        if (overBudget()) {
+            var _options_cursor;
+            // Out of time: the next call resumes after the last workspace read. A
+            // call that read none has no cursor to hand on, and the next scheduled
+            // run starts the week's workspaces again, which the markers make safe.
+            report.nextCursor = index ? orgs[index - 1].id : (_options_cursor = options.cursor) != null ? _options_cursor : null;
+            report.done = report.nextCursor === null;
+            return report;
+        }
+        report.swept += 1;
+        try {
+            report.created += await createOrgDigest(deps, orgDoc, week);
+        } catch (error) {
+            console.error('ai insight digest creation failed', {
+                orgId: orgDoc.id,
+                week,
+                error
+            });
+        }
+    }
+    const more = page.docs.length > AI_INSIGHT_DIGEST_ORG_CHUNK;
+    report.nextCursor = more ? (_ref = (_orgs_ = orgs[orgs.length - 1]) == null ? void 0 : _orgs_.id) != null ? _ref : null : null;
+    report.done = !more;
+    return report;
+}
+
+//# sourceMappingURL=ai-insight-digest.js.map

package/src/lib/insights/ai-insight-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/insights/ai-insight-digest.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 { FieldPath } from 'firebase-admin/firestore'\nimport { INSIGHT_DIGESTS_FIELD, insightDigestSubscribed, notificationMuted } from '@aglyn/aglyn/app-utils/notifications'\nimport { hostRoleFor } from '@aglyn/aglyn/app-utils/organizations'\nimport { checkEntitlement, resolveBrandingProfile, resolveEffectivePlan } from '@aglyn/aglyn/app-utils/plan-entitlements'\nimport { isReleaseFlagOnForOrg, parseOrgReleaseFlagOverrides, type ReleaseFlagValue } from '@aglyn/aglyn/app-utils/release-flags'\nimport type { AglynOrgMember } from '@aglyn/aglyn/foundation/definitions/organization.types'\nimport {\n  AI_INSIGHTS_COLLECTION,\n  aiInsightIsoWeek,\n  type AiInsightRecord,\n} from '../model/ai-insight'\nimport { isAiOnForSite } from '../model/ai-site-switch'\nimport { cancelAiJob, createAiJob, getAiJob } from '../jobs/ai-jobs'\n\n/**\n * THE WEEKLY INSIGHTS (AGL-2915): `POST /api/admin/ai-insights-digest`, twice\n * a day on the console's scheduler.\n *\n * ## Who asked for it\n *\n * A person turns weekly insights on for a workspace beside the answers\n * themselves (`users/{uid}.insightDigests.{orgId}`), and off there or in\n * Notifications. It is opt-in, because each digest is a generation the\n * workspace pays for. At the sweep, every rung is asked again rather than\n * trusted from the switch: the workspace's plan includes `aiGenerative`,\n * `release_ai_generative` is on for it, its AI is not paused, the site has AI\n * on, and the person still holds `ai.generate` on the site.\n *\n * ## Monday: one job per site\n *\n * On a Monday run, for each workspace with someone who asked, the sites those\n * people reach — the busiest `AI_INSIGHT_DIGEST_MAX_SITES` by yesterday's page\n * views — each get one `insight` job with the `digest` surface, created by the\n * first of them who may generate there. The job runs on the AI jobs beat like\n * any other: it reserves, meters and records its credits, and a workspace at\n * its band — a Free one that has used its credits — has its job parked by the\n * reservation like any other. `orgs/{orgId}/aiInsightDigests/{week}` records\n * the jobs; `aiInsightDigestQueue/{week}` lists the workspaces still owed a\n * delivery, so a run that delivers reads one document rather than every\n * workspace.\n *\n * ## Every run: deliver what is written\n *\n * A digest whose job is done and kept at least one insight is delivered once:\n * a `content.insightsDigest` notification (unless the person muted the\n * category) and an email through the platform's own sending path, to each\n * person who asked for the workspace's insights and reaches the site. A job\n * that failed, kept nothing, or parked for credits is SKIPPED SILENTLY: a\n * parked job is canceled rather than left to spend later, and nobody is told,\n * because nobody asked about that week in particular. A job still running\n * past `AI_INSIGHT_DIGEST_DEADLINE_MS` is canceled and skipped the same way.\n *\n * The email says only what the answer says: the insights, each traced to the\n * figures it cites, and a link to the site's Analytics page. It is sent by the\n * platform to a person who asked for it, never to a contact.\n */\n\ntype Firestore = FirebaseFirestore.Firestore\n\nexport const AI_INSIGHTS_DIGEST_CRON_ID = 'ai-insights-digest'\nexport const AI_INSIGHTS_DIGEST_PATH = 'admin/ai-insights-digest'\n\n/** Orgs one call reads; a chunk that times out never advances the cursor, so the safe size is one that finishes. */\nexport const AI_INSIGHT_DIGEST_ORG_CHUNK = 25\n\n/** Sites one workspace's digest covers a week. */\nexport const AI_INSIGHT_DIGEST_MAX_SITES = 5\n\n/** Sites a workspace's sweep reads before it ranks them. */\nexport const AI_INSIGHT_DIGEST_HOST_READ_LIMIT = 50\n\n/** Workspaces one run delivers to, per week. */\nexport const AI_INSIGHT_DIGEST_DELIVER_LIMIT = 100\n\n/** How long a digest's job may take before its week is given up. */\nexport const AI_INSIGHT_DIGEST_DEADLINE_MS = 48 * 60 * 60_000\n\n/**\n * The time one call works before it stops and leaves the rest to the next:\n * inside the plugin dispatcher's 60 s function ceiling, with room for the\n * reads before the first check and the reply after the last. A call killed\n * mid-send could send one person a site's digest twice, because a send is\n * stamped after it goes.\n */\nexport const AI_INSIGHT_DIGEST_RUN_BUDGET_MS = 45_000\n\nexport const AI_INSIGHT_DIGEST_MARKERS = 'aiInsightDigests'\nexport const AI_INSIGHT_DIGEST_QUEUE = 'aiInsightDigestQueue'\n\nexport type AiInsightDigestSiteState = 'pending' | 'delivered' | 'skipped'\n\nexport interface AiInsightDigestSite {\n  jobId: string\n  name: string\n  state: AiInsightDigestSiteState\n  /**\n   * The people already sent this site's digest, so a run the send rate\n   * stopped never sends one twice. Dropped when the site settles, so a\n   * settled marker names no person.\n   */\n  sent?: Record<string, boolean>\n}\n\nexport interface AiInsightDigestMarker {\n  week: string\n  createdAtMs: number\n  sites: Record<string, AiInsightDigestSite>\n}\n\n/** What a send answered: whether it went, and whether the platform's send rate refused it for now. */\nexport interface AiInsightDigestSendResult {\n  sent: boolean\n  rateLimited: boolean\n}\n\n/** Everything the sweep reaches beyond Firestore, so a spec can hold each one. */\nexport interface AiInsightDigestDeps {\n  firestore: Firestore\n  now: Date\n  flagValue: ReleaseFlagValue\n  listMembers: (orgId: string) => Promise<AglynOrgMember[]>\n  mayGenerate: (orgId: string, hostId: string, member: AglynOrgMember) => Promise<boolean>\n  paused: (orgId: string) => Promise<boolean>\n  notify: (uid: string, payload: { title: string; body: string; link: string; orgId: string; hostId: string }) => Promise<void>\n  send: (email: { to: string; subject: string; text: string; fromName: string }) => Promise<AiInsightDigestSendResult>\n  /** The console's absolute origin for an email link, or `''` when none is configured. */\n  consoleOrigin: string\n  /** The call's working time; `AI_INSIGHT_DIGEST_RUN_BUDGET_MS` unless a spec holds it. */\n  budgetMs?: number\n}\n\nexport interface AiInsightDigestReport {\n  week: string\n  swept: number\n  created: number\n  delivered: number\n  skipped: number\n  /** The send rate refused or the call's time ran out; the run stops, and the next one delivers the rest. */\n  deferred: boolean\n  nextCursor: string | null\n  done: boolean\n}\n\nconst str = (value: unknown): string => (typeof value === 'string' ? value.trim() : '')\n\n/** The week a Monday digest covers: the week the run falls in. */\nexport function aiInsightDigestWeek(now: Date): string {\n  return aiInsightIsoWeek(now)\n}\n\n/** The week before, whose late digests a run still delivers. */\nfunction previousWeek(now: Date): string {\n  return aiInsightIsoWeek(new Date(now.getTime() - 7 * 86_400_000))\n}\n\n/** A digest email's words: the insights, the site's Analytics page, and where to turn it off. */\nexport function aiInsightDigestEmailText(input: {\n  siteName: string\n  productName: string\n  insights: ReadonlyArray<{ text: string }>\n  /** Absolute links, or `null` where no console origin is configured to build one from. */\n  analyticsUrl: string | null\n  settingsUrl: string | null\n}): string {\n  return [\n    `Here is what ${input.siteName}'s figures showed this week.`,\n    '',\n    ...input.insights.map((insight, index) => `${index + 1}. ${insight.text}`),\n    '',\n    input.analyticsUrl\n      ? `Each of these is traced to the figures it cites. See them in ${input.productName}: ${input.analyticsUrl}`\n      : `Each of these is traced to the figures it cites. See them on the site's Analytics page in ${input.productName}.`,\n    '',\n    input.settingsUrl\n      ? `You asked for weekly insights for this workspace. Turn them off in Notifications: ${input.settingsUrl}`\n      : `You asked for weekly insights for this workspace. Turn them off in your Notifications settings.`,\n  ].join('\\n')\n}\n\nasync function readUsers(firestore: Firestore, uids: readonly string[]) {\n  if (!uids.length) return new Map<string, FirebaseFirestore.DocumentSnapshot>()\n  const docs = await firestore.getAll(...uids.map((uid) => firestore.collection('users').doc(uid)))\n  return new Map(docs.map((doc) => [doc.id, doc]))\n}\n\n/** Creates one workspace's digests for the week; answers how many jobs it created. */\nasync function createOrgDigest(\n  deps: AiInsightDigestDeps,\n  orgDoc: FirebaseFirestore.QueryDocumentSnapshot,\n  week: string,\n): Promise<number> {\n  const { firestore, now } = deps\n  const orgId = orgDoc.id\n  const org = (orgDoc.data() ?? {}) as Record<string, unknown>\n  if (!checkEntitlement(org as never, 'aiGenerative')) return 0\n  const flagOn = isReleaseFlagOnForOrg(\n    'release_ai_generative',\n    deps.flagValue,\n    orgId,\n    parseOrgReleaseFlagOverrides(org['releaseFlags']),\n    resolveEffectivePlan(org as never),\n  )\n  if (!flagOn || (await deps.paused(orgId))) return 0\n  const markerRef = orgDoc.ref.collection(AI_INSIGHT_DIGEST_MARKERS).doc(week)\n  if ((await markerRef.get()).exists) return 0\n\n  const members = (await deps.listMembers(orgId)).filter((member) => member.orgSuspended !== true)\n  const users = await readUsers(firestore, members.map((member) => member.$id).sort())\n  const subscribers = members\n    .filter((member) => insightDigestSubscribed(users.get(member.$id)?.get(INSIGHT_DIGESTS_FIELD), orgId))\n    .sort((a, b) => a.$id.localeCompare(b.$id))\n  if (!subscribers.length) return 0\n\n  const hosts = await firestore\n    .collection('hosts')\n    .where('orgId', '==', orgId)\n    .limit(AI_INSIGHT_DIGEST_HOST_READ_LIMIT)\n    .get()\n  const yesterday = new Date(now.getTime() - 86_400_000).toISOString().slice(0, 10)\n  const candidates: Array<{ hostId: string; name: string; creator: string; views: number }> = []\n  for (const host of hosts.docs) {\n    const data = host.data() ?? {}\n    if (!isAiOnForSite(org, data)) continue\n    let creator: string | null = null\n    for (const member of subscribers) {\n      if (hostRoleFor(member, host.id) !== null && (await deps.mayGenerate(orgId, host.id, member))) {\n        creator = member.$id\n        break\n      }\n    }\n    if (!creator) continue\n    const day = await host.ref.collection('analytics').doc(yesterday).get()\n    candidates.push({\n      hostId: host.id,\n      name: str(data['displayName']) || str(data['name']) || str(data['subdomain']) || host.id,\n      creator,\n      views: Number(day.get('total') ?? 0) || 0,\n    })\n  }\n  const chosen = candidates\n    .sort((a, b) => b.views - a.views || a.hostId.localeCompare(b.hostId))\n    .slice(0, AI_INSIGHT_DIGEST_MAX_SITES)\n  if (!chosen.length) return 0\n\n  const sites: Record<string, AiInsightDigestSite> = {}\n  for (const site of chosen) {\n    const job = await createAiJob(\n      firestore,\n      {\n        orgId,\n        hostId: site.hostId,\n        kind: 'insight',\n        brief: `Weekly insights for ${site.name}`,\n        inputs: { surface: 'digest', week },\n        createdBy: site.creator,\n      },\n      now,\n    )\n    sites[site.hostId] = { jobId: job.$id, name: site.name, state: 'pending' }\n  }\n  const marker: AiInsightDigestMarker = { week, createdAtMs: now.getTime(), sites }\n  await markerRef.set(marker)\n  await firestore\n    .collection(AI_INSIGHT_DIGEST_QUEUE)\n    .doc(week)\n    .set({ week, pending: { [orgId]: true } }, { merge: true })\n  return chosen.length\n}\n\n/** Delivers or settles one workspace's digests for a week; `deferred` when the send rate refused. */\nasync function deliverOrgDigest(\n  deps: AiInsightDigestDeps,\n  orgId: string,\n  week: string,\n  overBudget: () => boolean,\n): Promise<{ delivered: number; skipped: number; settled: boolean; deferred: boolean }> {\n  const { firestore, now } = deps\n  const orgRef = firestore.collection('orgs').doc(orgId)\n  const markerRef = orgRef.collection(AI_INSIGHT_DIGEST_MARKERS).doc(week)\n  const markerSnapshot = await markerRef.get()\n  const result = { delivered: 0, skipped: 0, settled: true, deferred: false }\n  if (!markerSnapshot.exists) return result\n  const marker = markerSnapshot.data() as AiInsightDigestMarker\n  const org = ((await orgRef.get()).data() ?? {}) as Record<string, unknown>\n  let members: AglynOrgMember[] | null = null\n  const branding = resolveBrandingProfile(org as never)\n\n  for (const [hostId, site] of Object.entries(marker.sites ?? {})) {\n    if (site.state !== 'pending') continue\n    const settle = async (state: AiInsightDigestSiteState) => {\n      // Replaced whole rather than merged, which drops `sent`.\n      const settled: AiInsightDigestSite = { jobId: site.jobId, name: site.name, state }\n      await markerRef.update({ [`sites.${hostId}`]: settled })\n      if (state === 'delivered') result.delivered += 1\n      else result.skipped += 1\n    }\n    const job = await getAiJob(firestore, orgId, site.jobId)\n    if (!job || job.status === 'failed' || job.status === 'canceled') {\n      await settle('skipped')\n      continue\n    }\n    if (job.status !== 'done') {\n      const late = now.getTime() - Number(marker.createdAtMs ?? 0) > AI_INSIGHT_DIGEST_DEADLINE_MS\n      // A job parked for credits — a Free workspace at its band — is given up\n      // rather than left to spend on a week that is already over.\n      if (job.status === 'needs_input' || late) {\n        await cancelAiJob(firestore, orgId, site.jobId, now)\n        await settle('skipped')\n      } else {\n        result.settled = false\n      }\n      continue\n    }\n    const answer = await orgRef.collection(AI_INSIGHTS_COLLECTION).doc(site.jobId).get()\n    const record = answer.exists ? (answer.data() as AiInsightRecord) : null\n    if (!record?.insights?.length) {\n      await settle('skipped')\n      continue\n    }\n\n    members ??= (await deps.listMembers(orgId)).filter((member) => member.orgSuspended !== true)\n    const reaching = members.filter((member) => hostRoleFor(member, hostId) !== null)\n    const users = await readUsers(firestore, reaching.map((member) => member.$id).sort())\n    const host = (await firestore.collection('hosts').doc(hostId).get()).data() ?? {}\n    const orgSlug = str(org['slug'])\n    const subdomain = str(host['subdomain'])\n    const origin = deps.consoleOrigin\n    const analyticsUrl = origin && orgSlug && subdomain ? `${origin}/${orgSlug}/hosts/${subdomain}/analytics` : null\n    for (const member of reaching.sort((a, b) => a.$id.localeCompare(b.$id))) {\n      const user = users.get(member.$id)\n      if (!insightDigestSubscribed(user?.get(INSIGHT_DIGESTS_FIELD), orgId)) continue\n      if (site.sent?.[member.$id]) continue\n      if (overBudget()) {\n        // Out of time: what was sent is stamped, and the next run sends the rest.\n        result.deferred = true\n        result.settled = false\n        return result\n      }\n      const address = str(member.email ?? user?.get('email')).toLowerCase()\n      if (address.includes('@')) {\n        const sent = await deps.send({\n          to: address,\n          subject: `Your weekly insights for ${site.name}`,\n          text: aiInsightDigestEmailText({\n            siteName: site.name,\n            productName: branding.productName,\n            insights: record.insights,\n            analyticsUrl,\n            settingsUrl: origin ? `${origin}/manage/notifications` : null,\n          }),\n          fromName: branding.fromName,\n        })\n        if (sent.rateLimited) {\n          // Nothing is marked, so the next run delivers this site whole.\n          result.deferred = true\n          result.settled = false\n          return result\n        }\n      }\n      if (!notificationMuted(user?.get('notificationPrefs'), 'content.insightsDigest')) {\n        await deps.notify(member.$id, {\n          title: `Weekly insights · ${site.name}`,\n          body: record.insights[0].text,\n          link: `/${hostId}/analytics`,\n          orgId,\n          hostId,\n        })\n      }\n      await markerRef.set({ sites: { [hostId]: { sent: { [member.$id]: true } } } }, { merge: true })\n    }\n    await settle('delivered')\n  }\n  return result\n}\n\n/**\n * One call of the sweep: delivery for this week and the last on the first\n * call, then — on a Monday — one chunk of workspaces' creation, resumed by\n * `cursor`. The response shape is the console crons' (`nextCursor`, `done`),\n * so the scheduler's loop carries a platform of any size across calls.\n */\nexport async function runAiInsightDigestSweep(\n  deps: AiInsightDigestDeps,\n  options: { cursor: string | null },\n): Promise<AiInsightDigestReport> {\n  const { firestore, now } = deps\n  const startedAtMs = Date.now()\n  const budgetMs = deps.budgetMs ?? AI_INSIGHT_DIGEST_RUN_BUDGET_MS\n  const overBudget = () => Date.now() - startedAtMs > budgetMs\n  const week = aiInsightDigestWeek(now)\n  const report: AiInsightDigestReport = {\n    week,\n    swept: 0,\n    created: 0,\n    delivered: 0,\n    skipped: 0,\n    deferred: false,\n    nextCursor: null,\n    done: true,\n  }\n\n  if (!options.cursor) {\n    for (const owed of [previousWeek(now), week]) {\n      const queueRef = firestore.collection(AI_INSIGHT_DIGEST_QUEUE).doc(owed)\n      const pending = Object.entries(((await queueRef.get()).get('pending') ?? {}) as Record<string, unknown>)\n        .filter(([, owed]) => owed === true)\n        .map(([orgId]) => orgId)\n        .sort()\n        .slice(0, AI_INSIGHT_DIGEST_DELIVER_LIMIT)\n      for (const orgId of pending) {\n        if (overBudget()) {\n          report.deferred = true\n          return report\n        }\n        try {\n          const delivered = await deliverOrgDigest(deps, orgId, owed, overBudget)\n          report.delivered += delivered.delivered\n          report.skipped += delivered.skipped\n          if (delivered.settled) {\n            await queueRef.set({ pending: { [orgId]: false } }, { merge: true })\n          }\n          if (delivered.deferred) {\n            report.deferred = true\n            return report\n          }\n        } catch (error) {\n          console.error('ai insight digest delivery failed', { orgId, week: owed, error })\n        }\n      }\n    }\n  }\n\n  // Monday is the week's first day by ISO 8601, and the day a digest is made.\n  if (now.getUTCDay() !== 1) return report\n\n  let query = firestore.collection('orgs').orderBy(FieldPath.documentId()).limit(AI_INSIGHT_DIGEST_ORG_CHUNK + 1)\n  if (options.cursor) query = query.startAfter(firestore.collection('orgs').doc(options.cursor))\n  const page = await query.get()\n  const orgs = page.docs.slice(0, AI_INSIGHT_DIGEST_ORG_CHUNK)\n  for (const [index, orgDoc] of orgs.entries()) {\n    if (overBudget()) {\n      // Out of time: the next call resumes after the last workspace read. A\n      // call that read none has no cursor to hand on, and the next scheduled\n      // run starts the week's workspaces again, which the markers make safe.\n      report.nextCursor = index ? orgs[index - 1].id : (options.cursor ?? null)\n      report.done = report.nextCursor === null\n      return report\n    }\n    report.swept += 1\n    try {\n      report.created += await createOrgDigest(deps, orgDoc, week)\n    } catch (error) {\n      console.error('ai insight digest creation failed', { orgId: orgDoc.id, week, error })\n    }\n  }\n  const more = page.docs.length > AI_INSIGHT_DIGEST_ORG_CHUNK\n  report.nextCursor = more ? (orgs[orgs.length - 1]?.id ?? null) : null\n  report.done = !more\n  return report\n}\n"],"names":["FieldPath","INSIGHT_DIGESTS_FIELD","insightDigestSubscribed","notificationMuted","hostRoleFor","checkEntitlement","resolveBrandingProfile","resolveEffectivePlan","isReleaseFlagOnForOrg","parseOrgReleaseFlagOverrides","AI_INSIGHTS_COLLECTION","aiInsightIsoWeek","isAiOnForSite","cancelAiJob","createAiJob","getAiJob","AI_INSIGHTS_DIGEST_CRON_ID","AI_INSIGHTS_DIGEST_PATH","AI_INSIGHT_DIGEST_ORG_CHUNK","AI_INSIGHT_DIGEST_MAX_SITES","AI_INSIGHT_DIGEST_HOST_READ_LIMIT","AI_INSIGHT_DIGEST_DELIVER_LIMIT","AI_INSIGHT_DIGEST_DEADLINE_MS","AI_INSIGHT_DIGEST_RUN_BUDGET_MS","AI_INSIGHT_DIGEST_MARKERS","AI_INSIGHT_DIGEST_QUEUE","str","value","trim","aiInsightDigestWeek","now","previousWeek","Date","getTime","aiInsightDigestEmailText","input","siteName","insights","map","insight","index","text","analyticsUrl","productName","settingsUrl","join","readUsers","firestore","uids","length","Map","docs","getAll","uid","collection","doc","id","createOrgDigest","deps","orgDoc","week","orgId","org","data","flagOn","flagValue","paused","markerRef","ref","get","exists","members","listMembers","filter","member","orgSuspended","users","$id","sort","subscribers","a","b","localeCompare","hosts","where","limit","yesterday","toISOString","slice","candidates","host","day","creator","mayGenerate","push","hostId","name","views","Number","chosen","sites","site","job","kind","brief","inputs","surface","createdBy","jobId","state","marker","createdAtMs","set","pending","merge","deliverOrgDigest","overBudget","orgRef","markerSnapshot","result","delivered","skipped","settled","deferred","branding","Object","entries","record","settle","update","status","late","answer","reaching","orgSlug","subdomain","origin","consoleOrigin","user","sent","address","email","toLowerCase","includes","send","to","subject","fromName","rateLimited","notify","title","body","link","runAiInsightDigestSweep","options","orgs","startedAtMs","budgetMs","report","swept","created","nextCursor","done","cursor","owed","queueRef","error","console","getUTCDay","query","orderBy","documentId","startAfter","page","more"],"mappings":"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"}

package/src/lib/insights/ai-insight-readers.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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 ResolvedPluginFigureReader } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import { type AiInsightSurface, type AiInsightTable } from '../model/ai-insight';
+import type { AiInsightReadRequest } from '../tools/ai-insight-tool';
+import type { AiDatasetCatalogEntry } from './ai-figure-readers';
+/**
+ * Which figure readers an insight job may read, and reading them (AGL-2915).
+ *
+ * The caller's half of the `plugin-figures` contract: the seam carries no
+ * authorization, so before a reader is offered to the model — let alone read
+ * — this establishes that the surface asks about its kind of figures, that
+ * the workspace's plan includes the feature the figures are sold under, and
+ * that the plugin whose records they are runs here: past its release flag,
+ * on for the workspace and not switched off for the site. The site belonging
+ * to the job's workspace, and the member's reach, are the job's own checks.
+ */
+/** Which of a set of plugins are past their release flags for an org; the platform's flags by default. */
+export type AiReleasedPlugins = (pluginIds: string[], orgId: string) => Promise<string[]>;
+export interface AiInsightReaderContext {
+    orgId: string;
+    /** The site the figures are about; `null` for a workspace-level question. */
+    hostId: string | null;
+    /** The org document the machine or the door read. */
+    org: object | null;
+    /** The site's host document, already checked to belong to the org; `null` with no site. */
+    host: Record<string, unknown> | null;
+    surface: AiInsightSurface;
+    released?: AiReleasedPlugins;
+}
+/** The readers a job on this surface may read, ordered by id so a prompt lists them in the same order every time. */
+export declare function aiInsightReaders(context: AiInsightReaderContext): Promise<ResolvedPluginFigureReader[]>;
+/** The window a reader is read over: the one asked for when it covers it, else the nearest it does. */
+export declare function aiInsightReaderDays(windows: readonly number[], asked: number): number;
+/** The readers as the read prompt lists them: id, what each answers, its windows and its parameters. */
+export declare function aiInsightReaderCatalog(readers: readonly ResolvedPluginFigureReader[]): string;
+/** The datasets a datasets question may name, as the read prompt lists them. */
+export declare function aiInsightDatasetCatalog(datasets: readonly AiDatasetCatalogEntry[]): string;
+export interface AiInsightReadResult {
+    tables: AiInsightTable[];
+    /** Why a request that named a real reader was not read, in its owner's words, for the log. */
+    refusals: string[];
+}
+/**
+ * The tables for the reads a job asked for: each request held to the readers
+ * this job may read, its window to that reader's, its parameters to those it
+ * declares; each table held to the contract by `normalizePluginFigureTable`.
+ * A reader asked for twice with the same window and parameters is read once.
+ */
+export declare function readAiInsightTables(readers: readonly ResolvedPluginFigureReader[], requests: readonly AiInsightReadRequest[], base: {
+    orgId: string;
+    hostId: string | null;
+    uid: string | null;
+    now: Date;
+}, maxTables?: number): Promise<AiInsightReadResult>;
+/** One table as the answer prompt shows it: a heading, the columns, numbered rows, and its notes. */
+export declare function aiInsightTableText(table: AiInsightTable): string;

package/src/lib/insights/ai-insight-readers.js

@@ -0,0 +1,141 @@
+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 { isHostPluginEnabled, isPluginEnabled } from "@aglyn/aglyn/plugin-manager/enabled-plugins";
+import { listPluginFigureReaders, normalizePluginFigureTable, pluginFigureParams, pluginFigureReaderPlugin } from "@aglyn/aglyn/plugin-manager/plugin-figures";
+import { AI_INSIGHT_MAX_READS, AI_INSIGHT_SURFACE_READERS, aiInsightCellText } from "../model/ai-insight.js";
+import { filterEnabledPluginsByReleaseFlags } from "@aglyn/tenant-data-admin/server/release-flags";
+const releasedByFlags = (pluginIds, orgId)=>filterEnabledPluginsByReleaseFlags(pluginIds, {
+        orgId,
+        authorization: null
+    });
+/** The readers a job on this surface may read, ordered by id so a prompt lists them in the same order every time. */ export async function aiInsightReaders(context) {
+    var _context_released;
+    const prefixes = AI_INSIGHT_SURFACE_READERS[context.surface];
+    const org = context.org;
+    const candidates = listPluginFigureReaders().filter(({ reader })=>{
+        if (!prefixes.includes(reader.id.split('.')[0])) return false;
+        // A site reader needs a site; a workspace reader reads with or without one.
+        if (reader.scope === 'site' && !context.hostId) return false;
+        return !reader.feature || checkEntitlement(org, reader.feature);
+    });
+    const plugins = [
+        ...new Set(candidates.map(pluginFigureReaderPlugin).filter((id)=>Boolean(id)))
+    ];
+    const released = new Set(plugins.length ? await ((_context_released = context.released) != null ? _context_released : releasedByFlags)(plugins, context.orgId) : []);
+    return candidates.filter((resolved)=>{
+        const plugin = pluginFigureReaderPlugin(resolved);
+        if (!plugin) return true;
+        if (!released.has(plugin)) return false;
+        return context.hostId ? isHostPluginEnabled(org, context.host, plugin) : isPluginEnabled(org, plugin);
+    });
+}
+/** The window a reader is read over: the one asked for when it covers it, else the nearest it does. */ export function aiInsightReaderDays(windows, asked) {
+    if (!windows.length) return 0;
+    if (windows.includes(asked)) return asked;
+    return [
+        ...windows
+    ].sort((a, b)=>Math.abs(a - asked) - Math.abs(b - asked) || a - b)[0];
+}
+/** The readers as the read prompt lists them: id, what each answers, its windows and its parameters. */ export function aiInsightReaderCatalog(readers) {
+    return readers.map(({ reader })=>{
+        var _reader_params, _reader_params1;
+        const windows = reader.windows.length ? ` Windows: ${reader.windows.join(', ')} days.` : ' Current totals, with no window: days 0.';
+        const params = ((_reader_params = reader.params) != null ? _reader_params : []).length ? ` Parameters: ${((_reader_params1 = reader.params) != null ? _reader_params1 : []).map((param)=>`${param.name} (${param.required ? 'required' : 'optional'}) — ${param.description}`).join('; ')}` : '';
+        return `- ${reader.id} — ${reader.label}: ${reader.description}${windows}${params}`;
+    }).join('\n');
+}
+/** The datasets a datasets question may name, as the read prompt lists them. */ export function aiInsightDatasetCatalog(datasets) {
+    if (!datasets.length) return 'There are no datasets you may read here.';
+    return datasets.map((dataset)=>`- ${dataset.name} (id ${dataset.id}): ${dataset.fields.map((field)=>`${field.name} [${field.type}]`).join(', ') || 'no fields'}`).join('\n');
+}
+/**
+ * The tables for the reads a job asked for: each request held to the readers
+ * this job may read, its window to that reader's, its parameters to those it
+ * declares; each table held to the contract by `normalizePluginFigureTable`.
+ * A reader asked for twice with the same window and parameters is read once.
+ */ export async function readAiInsightTables(readers, requests, base, maxTables = AI_INSIGHT_MAX_READS) {
+    const tables = [];
+    const refusals = [];
+    const seen = new Set();
+    for (const request of requests){
+        if (tables.length === maxTables) break;
+        const resolved = readers.find(({ reader })=>reader.id === request.reader);
+        if (!resolved) continue;
+        const { reader } = resolved;
+        const days = aiInsightReaderDays(reader.windows, request.days);
+        const params = pluginFigureParams(reader, request.params);
+        if (params.ok === false) {
+            refusals.push(`${reader.id}: missing ${params.missing}`);
+            continue;
+        }
+        const key = JSON.stringify([
+            reader.id,
+            days,
+            params.params
+        ]);
+        if (seen.has(key)) continue;
+        seen.add(key);
+        try {
+            const read = await reader.read(_extends({}, base, {
+                days,
+                params: params.params
+            }));
+            if (read.ok === false) {
+                refusals.push(`${reader.id}: ${read.error}`);
+                continue;
+            }
+            const table = normalizePluginFigureTable(read.table);
+            if (!table) {
+                refusals.push(`${reader.id}: not a table`);
+                continue;
+            }
+            tables.push(_extends({}, table, {
+                ref: `t${tables.length + 1}`,
+                reader: reader.id,
+                days,
+                scope: reader.scope
+            }));
+        } catch (error) {
+            // One reader's fault is not the answer's: the rest are still read.
+            console.error('ai insight reader failed', {
+                reader: reader.id,
+                orgId: base.orgId,
+                error
+            });
+            refusals.push(`${reader.id}: failed`);
+        }
+    }
+    return {
+        tables,
+        refusals
+    };
+}
+/** One table as the answer prompt shows it: a heading, the columns, numbered rows, and its notes. */ export function aiInsightTableText(table) {
+    const period = table.period ? ` · ${table.period.from} to ${table.period.to} (${table.period.days} days)` : '';
+    const lines = [
+        `${table.ref} · ${table.title} (${table.source.label})${period}`,
+        `Columns: ${table.columns.map((column)=>column.label).join(' | ')}`,
+        ...table.rows.map((row, index)=>`${index}: ${table.columns.map((column)=>aiInsightCellText(table, column.key, row[column.key])).join(' | ')}`)
+    ];
+    if (!table.rows.length) lines.push('(no rows)');
+    if (table.omitted) lines.push(`${table.omitted} more rows were left out of this table.`);
+    for (const note of table.notes)lines.push(`Note: ${note}`);
+    return lines.join('\n');
+}
+
+//# sourceMappingURL=ai-insight-readers.js.map