@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/model/ai-insight.d.ts

@@ -0,0 +1,178 @@
+/**
+ * @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 { PluginFigureTable } from '@aglyn/aglyn/plugin-manager/plugin-figures';
+import type { AiJob, AiJobOutput } from './ai-jobs.types';
+/**
+ * Insights (AGL-2915): what an `insight` job answers, in the shape the step
+ * writes and the console reads. Pure data — no server import — so the answer
+ * card and the digest email type what they render from the module the step
+ * writes it with.
+ *
+ * ## A number is read, never written
+ *
+ * The model never runs a query and never sees a record. Code reads figures —
+ * traffic, orders, bookings, forms, campaigns, datasets, experiments — through
+ * fixed, typed readers, each answering with one compact table that says where
+ * its figures come from. The model picks the readers and phrases what their
+ * tables say, and every insight it writes cites the rows its figures come from.
+ * An insight whose numbers cannot be found in the rows it cites is left out
+ * (`runtime/ai-insight-check.ts`), so each one a person reads can be traced to
+ * a number they can open in the console.
+ *
+ * ## Read-only, and kept apart from the job
+ *
+ * An insight job writes one document besides its own record: the answer, at
+ * `orgs/{orgId}/aiInsights/{jobId}`, which no rule lets a client read. The
+ * job's output names it and carries no figure, because a job document is
+ * readable by every member of the workspace and the figures are not: a
+ * collaborator on one site may not see another site's revenue. The answer is
+ * served by `GET /api/ai/insights/{jobId}` to the member who asked and, for a
+ * weekly digest, to the members who reach its site.
+ */
+/**
+ * Where an insight was asked: the console page whose Assist panel asked it,
+ * or the weekly digest, which no person asked.
+ */
+export type AiInsightSurface = 'analytics' | 'datasets' | 'crm-reports' | 'digest';
+export declare const AI_INSIGHT_SURFACES: readonly AiInsightSurface[];
+/** The surfaces a person asks from. */
+export declare const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[];
+/** The surface an insight job's inputs name, or `null` for one no insight job is asked from. */
+export declare function aiInsightSurface(inputs: Readonly<Record<string, unknown>> | null | undefined): AiInsightSurface | null;
+/**
+ * The readers a surface may offer, by the first word of a reader's id. The
+ * Analytics page answers about the site's traffic and what it sold, took and
+ * collected; a Data page about its datasets; CRM Reports about where people
+ * came from and what they did.
+ */
+export declare const AI_INSIGHT_SURFACE_READERS: Readonly<Record<AiInsightSurface, readonly string[]>>;
+/** Whether a surface answers about one site; the Data page may answer about the whole workspace. */
+export declare function aiInsightSurfaceNeedsSite(surface: AiInsightSurface): boolean;
+/**
+ * The readers a weekly digest reads, in the order the digest names them:
+ * the traffic change, the top page, the days that stood out, the forms, the
+ * campaigns, and what the site sold and took. Code reads these; no model
+ * picks them.
+ */
+export declare const AI_INSIGHT_DIGEST_READERS: readonly string[];
+/** The windows, in days, an insight reads: the Traffic card's own ranges. */
+export declare const AI_INSIGHT_WINDOWS: readonly number[];
+/** The window a question that names none reads: the Traffic card's default. */
+export declare const AI_INSIGHT_DEFAULT_DAYS = 14;
+/** The window a weekly digest reads. */
+export declare const AI_INSIGHT_DIGEST_DAYS = 7;
+/** A window an insight's inputs or a read names, held to the readers' own ranges. */
+export declare function aiInsightDays(value: unknown): number;
+/** The most insights one answer carries: a person reads them at a glance. */
+export declare const AI_INSIGHT_MAX_INSIGHTS = 5;
+/** The longest one insight may run, in characters. */
+export declare const AI_INSIGHT_MAX_CHARS = 280;
+/** The longest the sentence about what the figures could not answer may run. */
+export declare const AI_INSIGHT_GAP_MAX_CHARS = 200;
+/** The most tables one citation list names. */
+export declare const AI_INSIGHT_MAX_CITES = 3;
+/** The most rows one citation names. */
+export declare const AI_INSIGHT_MAX_CITED_ROWS = 10;
+/** The most readers one answer reads. */
+export declare const AI_INSIGHT_MAX_READS = 4;
+/** The longest question an insight job admits. */
+export declare const AI_INSIGHT_QUESTION_MAX_CHARS = 1000;
+/**
+ * A table as an insight job keeps it: the figures a reader returned, the
+ * handle the model cites them by, and the reader they came from.
+ */
+export interface AiInsightTable extends PluginFigureTable {
+    /** `t1`, `t2`, …, in the order the job read them. */
+    ref: string;
+    /** The reader's id (`commerce.sales`). */
+    reader: string;
+    /** The window the reader was asked for, in days; 0 for a reader of current counts. */
+    days: number;
+    /** Whether the table is about one site (its path under that site) or the workspace. */
+    scope: 'site' | 'org';
+}
+/** The rows of one table an insight's figures come from, by index. */
+export interface AiInsightCitation {
+    table: string;
+    rows: number[];
+}
+export interface AiInsight {
+    /** One or two plain sentences. */
+    text: string;
+    cites: AiInsightCitation[];
+}
+/** What the model answers with. */
+export interface AiInsightAnswer {
+    insights: AiInsight[];
+    /** What the figures could not answer, in one sentence without numbers; `null` when nothing. */
+    gap: string | null;
+}
+/** The answer collection under the org: server-written, and read through the insights door alone. */
+export declare const AI_INSIGHTS_COLLECTION = "aiInsights";
+/** An insight job's answer, as the step stores it. */
+export interface AiInsightRecord {
+    jobId: string;
+    orgId: string;
+    hostId: string | null;
+    surface: AiInsightSurface;
+    /** The member whose question it answers; for a digest, the member it was made for. */
+    createdBy: string;
+    /** The question, verbatim; a digest's is the digest's own title. */
+    question: string;
+    /** The window the answer was asked about, in days. */
+    days: number;
+    /** The insights that trace to the rows they cite; every other one was left out. */
+    insights: AiInsight[];
+    gap: string | null;
+    /** Every table the job read, so each citation opens the figures it names. */
+    tables: AiInsightTable[];
+    /** How many insights the answer carried that were left out as not traceable. */
+    left: number;
+    /** The ISO week a digest covers (`2026-W38`); `null` on a question. */
+    week: string | null;
+    createdAtMs: number;
+}
+/** The output id an answer is named by. */
+export declare const AI_INSIGHT_OUTPUT_LABEL = "Answer";
+/**
+ * The output an insight job records: the answer's address and how many
+ * insights it holds, and no figure. The count is a statement about the
+ * answer rather than about the site, so every member may read it.
+ */
+export declare function aiInsightOutput(job: Pick<AiJob, '$id' | 'hostId'>, record: Pick<AiInsightRecord, 'insights' | 'surface'>, hostSubdomain: string | null): AiJobOutput;
+/** The answer on the wire: the stored record, with nothing a client does not render. */
+export type AiInsightAnswerWire = AiInsightRecord;
+/**
+ * The Assist panel's insight surface for a console path, or `null` off one.
+ * A site's Analytics, Data and CRM Reports pages, and the workspace's Data
+ * page; the workspace's CRM Reports reads site figures, so it is not one.
+ */
+export declare function aiInsightSurfaceForPath(pathname: string | null | undefined): {
+    surface: Exclude<AiInsightSurface, 'digest'>;
+    host: string | null;
+} | null;
+/** The console page a table's figures come from, or `null` when the table names none. */
+export declare function aiInsightSourceHref(table: Pick<AiInsightTable, 'source' | 'scope'>, where: {
+    orgSlug: string;
+    host: string | null;
+}): string | null;
+/** How a cell reads to a person, by its column's kind; `null` is "—". */
+export declare function aiInsightCellText(table: Pick<AiInsightTable, 'columns'>, key: string, value: string | number | null | undefined): string;
+/** One cited row as a line a person reads: every column, labeled. */
+export declare function aiInsightRowText(table: Pick<AiInsightTable, 'columns' | 'rows'>, index: number): string;
+/** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */
+export declare function aiInsightIsoWeek(at: Date): string;

package/src/lib/model/ai-insight.js

@@ -0,0 +1,201 @@
+/**
+ * @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.
+ */ export const AI_INSIGHT_SURFACES = [
+    'analytics',
+    'datasets',
+    'crm-reports',
+    'digest'
+];
+/** The surfaces a person asks from. */ export const AI_INSIGHT_ASK_SURFACES = [
+    'analytics',
+    'datasets',
+    'crm-reports'
+];
+/** The surface an insight job's inputs name, or `null` for one no insight job is asked from. */ export function aiInsightSurface(inputs) {
+    const surface = inputs == null ? void 0 : inputs['surface'];
+    return typeof surface === 'string' && AI_INSIGHT_SURFACES.includes(surface) ? surface : null;
+}
+/**
+ * The readers a surface may offer, by the first word of a reader's id. The
+ * Analytics page answers about the site's traffic and what it sold, took and
+ * collected; a Data page about its datasets; CRM Reports about where people
+ * came from and what they did.
+ */ export const AI_INSIGHT_SURFACE_READERS = {
+    analytics: [
+        'bookings',
+        'commerce',
+        'forms',
+        'marketing',
+        'traffic'
+    ],
+    datasets: [
+        'datasets'
+    ],
+    'crm-reports': [
+        'bookings',
+        'commerce',
+        'forms',
+        'marketing',
+        'traffic'
+    ],
+    digest: [
+        'bookings',
+        'commerce',
+        'forms',
+        'marketing',
+        'traffic'
+    ]
+};
+/** Whether a surface answers about one site; the Data page may answer about the whole workspace. */ export function aiInsightSurfaceNeedsSite(surface) {
+    return surface !== 'datasets';
+}
+/**
+ * The readers a weekly digest reads, in the order the digest names them:
+ * the traffic change, the top page, the days that stood out, the forms, the
+ * campaigns, and what the site sold and took. Code reads these; no model
+ * picks them.
+ */ export const AI_INSIGHT_DIGEST_READERS = [
+    'traffic.summary',
+    'traffic.pages',
+    'traffic.daily',
+    'forms.performance',
+    'marketing.campaigns',
+    'commerce.sales',
+    'bookings.services'
+];
+/** The windows, in days, an insight reads: the Traffic card's own ranges. */ export const AI_INSIGHT_WINDOWS = [
+    7,
+    14,
+    30,
+    90
+];
+/** The window a question that names none reads: the Traffic card's default. */ export const AI_INSIGHT_DEFAULT_DAYS = 14;
+/** The window a weekly digest reads. */ export const AI_INSIGHT_DIGEST_DAYS = 7;
+/** A window an insight's inputs or a read names, held to the readers' own ranges. */ export function aiInsightDays(value) {
+    const days = typeof value === 'number' ? value : Number(value);
+    return AI_INSIGHT_WINDOWS.includes(days) ? days : AI_INSIGHT_DEFAULT_DAYS;
+}
+/** The most insights one answer carries: a person reads them at a glance. */ export const AI_INSIGHT_MAX_INSIGHTS = 5;
+/** The longest one insight may run, in characters. */ export const AI_INSIGHT_MAX_CHARS = 280;
+/** The longest the sentence about what the figures could not answer may run. */ export const AI_INSIGHT_GAP_MAX_CHARS = 200;
+/** The most tables one citation list names. */ export const AI_INSIGHT_MAX_CITES = 3;
+/** The most rows one citation names. */ export const AI_INSIGHT_MAX_CITED_ROWS = 10;
+/** The most readers one answer reads. */ export const AI_INSIGHT_MAX_READS = 4;
+/** The longest question an insight job admits. */ export const AI_INSIGHT_QUESTION_MAX_CHARS = 1000;
+/** The answer collection under the org: server-written, and read through the insights door alone. */ export const AI_INSIGHTS_COLLECTION = 'aiInsights';
+/** The output id an answer is named by. */ export const AI_INSIGHT_OUTPUT_LABEL = 'Answer';
+/**
+ * The output an insight job records: the answer's address and how many
+ * insights it holds, and no figure. The count is a statement about the
+ * answer rather than about the site, so every member may read it.
+ */ export function aiInsightOutput(job, record, hostSubdomain) {
+    var _job_hostId;
+    const count = record.insights.length;
+    return {
+        resource: 'insight',
+        id: job.$id,
+        versionId: null,
+        hostId: (_job_hostId = job.hostId) != null ? _job_hostId : null,
+        hostSubdomain,
+        label: record.surface === 'digest' ? 'Weekly insights' : AI_INSIGHT_OUTPUT_LABEL,
+        note: count ? `${count} ${count === 1 ? 'insight' : 'insights'}, each traced to the figures it cites.` : 'The figures did not answer this question.'
+    };
+}
+/**
+ * The Assist panel's insight surface for a console path, or `null` off one.
+ * A site's Analytics, Data and CRM Reports pages, and the workspace's Data
+ * page; the workspace's CRM Reports reads site figures, so it is not one.
+ */ export function aiInsightSurfaceForPath(pathname) {
+    const segments = String(pathname != null ? pathname : '').split('?')[0].split('/').filter(Boolean);
+    // `/{org}/hosts/{host}/…` on a site, `/{org}/…` on the workspace.
+    if (segments[1] === 'hosts' && segments.length >= 4) {
+        const host = segments[2];
+        const rest = segments.slice(3);
+        if (rest[0] === 'analytics') return {
+            surface: 'analytics',
+            host
+        };
+        if (rest[0] === 'data') return {
+            surface: 'datasets',
+            host
+        };
+        if (rest[0] === 'crm' && rest[1] === 'reports') return {
+            surface: 'crm-reports',
+            host
+        };
+        return null;
+    }
+    if (segments.length >= 2 && segments[1] === 'data') return {
+        surface: 'datasets',
+        host: null
+    };
+    return null;
+}
+/** The console page a table's figures come from, or `null` when the table names none. */ export function aiInsightSourceHref(table, where) {
+    const path = table.source.path;
+    if (!path || !where.orgSlug) return null;
+    if (table.scope === 'org') return `/${where.orgSlug}/${path}`;
+    return where.host ? `/${where.orgSlug}/hosts/${where.host}/${path}` : null;
+}
+/** How a cell reads to a person, by its column's kind; `null` is "—". */ export function aiInsightCellText(table, key, value) {
+    if (value === null || value === undefined || value === '') return '—';
+    const column = table.columns.find((entry)=>entry.key === key);
+    if (typeof value === 'string' || !column) return String(value);
+    switch(column.kind){
+        case 'money':
+            var _column_currency;
+            return new Intl.NumberFormat('en-US', {
+                style: 'currency',
+                currency: (_column_currency = column.currency) != null ? _column_currency : 'USD'
+            }).format(value);
+        case 'percent':
+            return `${value.toLocaleString('en-US', {
+                maximumFractionDigits: 1
+            })}%`;
+        case 'change':
+            return `${value > 0 ? '+' : ''}${value.toLocaleString('en-US', {
+                maximumFractionDigits: 1
+            })}%`;
+        case 'duration':
+            {
+                const seconds = Math.round(value);
+                if (seconds < 60) return `${seconds}s`;
+                const minutes = Math.floor(seconds / 60);
+                if (minutes < 60) return `${minutes}m ${String(seconds % 60).padStart(2, '0')}s`;
+                return `${Math.floor(minutes / 60)}h ${String(minutes % 60).padStart(2, '0')}m`;
+            }
+        default:
+            return value.toLocaleString('en-US', {
+                maximumFractionDigits: 2
+            });
+    }
+}
+/** One cited row as a line a person reads: every column, labeled. */ export function aiInsightRowText(table, index) {
+    const row = table.rows[index];
+    if (!row) return '';
+    return table.columns.map((column)=>`${column.label}: ${aiInsightCellText(table, column.key, row[column.key])}`).join(' · ');
+}
+/** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */ export function aiInsightIsoWeek(at) {
+    const date = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()));
+    // Thursday decides the week's year.
+    const weekday = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - weekday);
+    const yearStart = Date.UTC(date.getUTCFullYear(), 0, 1);
+    const week = Math.ceil(((date.getTime() - yearStart) / 86400000 + 1) / 7);
+    return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`;
+}
+
+//# sourceMappingURL=ai-insight.js.map

package/src/lib/model/ai-insight.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/model/ai-insight.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 type { PluginFigureTable } from '@aglyn/aglyn/plugin-manager/plugin-figures'\nimport type { AiJob, AiJobOutput } from './ai-jobs.types'\n\n/**\n * Insights (AGL-2915): what an `insight` job answers, in the shape the step\n * writes and the console reads. Pure data — no server import — so the answer\n * card and the digest email type what they render from the module the step\n * writes it with.\n *\n * ## A number is read, never written\n *\n * The model never runs a query and never sees a record. Code reads figures —\n * traffic, orders, bookings, forms, campaigns, datasets, experiments — through\n * fixed, typed readers, each answering with one compact table that says where\n * its figures come from. The model picks the readers and phrases what their\n * tables say, and every insight it writes cites the rows its figures come from.\n * An insight whose numbers cannot be found in the rows it cites is left out\n * (`runtime/ai-insight-check.ts`), so each one a person reads can be traced to\n * a number they can open in the console.\n *\n * ## Read-only, and kept apart from the job\n *\n * An insight job writes one document besides its own record: the answer, at\n * `orgs/{orgId}/aiInsights/{jobId}`, which no rule lets a client read. The\n * job's output names it and carries no figure, because a job document is\n * readable by every member of the workspace and the figures are not: a\n * collaborator on one site may not see another site's revenue. The answer is\n * served by `GET /api/ai/insights/{jobId}` to the member who asked and, for a\n * weekly digest, to the members who reach its site.\n */\n\n/**\n * Where an insight was asked: the console page whose Assist panel asked it,\n * or the weekly digest, which no person asked.\n */\nexport type AiInsightSurface = 'analytics' | 'datasets' | 'crm-reports' | 'digest'\n\nexport const AI_INSIGHT_SURFACES: readonly AiInsightSurface[] = [\n  'analytics',\n  'datasets',\n  'crm-reports',\n  'digest',\n]\n\n/** The surfaces a person asks from. */\nexport const AI_INSIGHT_ASK_SURFACES: readonly AiInsightSurface[] = ['analytics', 'datasets', 'crm-reports']\n\n/** The surface an insight job's inputs name, or `null` for one no insight job is asked from. */\nexport function aiInsightSurface(inputs: Readonly<Record<string, unknown>> | null | undefined): AiInsightSurface | null {\n  const surface = inputs?.['surface']\n  return typeof surface === 'string' && (AI_INSIGHT_SURFACES as readonly string[]).includes(surface)\n    ? (surface as AiInsightSurface)\n    : null\n}\n\n/**\n * The readers a surface may offer, by the first word of a reader's id. The\n * Analytics page answers about the site's traffic and what it sold, took and\n * collected; a Data page about its datasets; CRM Reports about where people\n * came from and what they did.\n */\nexport const AI_INSIGHT_SURFACE_READERS: Readonly<Record<AiInsightSurface, readonly string[]>> = {\n  analytics: ['bookings', 'commerce', 'forms', 'marketing', 'traffic'],\n  datasets: ['datasets'],\n  'crm-reports': ['bookings', 'commerce', 'forms', 'marketing', 'traffic'],\n  digest: ['bookings', 'commerce', 'forms', 'marketing', 'traffic'],\n}\n\n/** Whether a surface answers about one site; the Data page may answer about the whole workspace. */\nexport function aiInsightSurfaceNeedsSite(surface: AiInsightSurface): boolean {\n  return surface !== 'datasets'\n}\n\n/**\n * The readers a weekly digest reads, in the order the digest names them:\n * the traffic change, the top page, the days that stood out, the forms, the\n * campaigns, and what the site sold and took. Code reads these; no model\n * picks them.\n */\nexport const AI_INSIGHT_DIGEST_READERS: readonly string[] = [\n  'traffic.summary',\n  'traffic.pages',\n  'traffic.daily',\n  'forms.performance',\n  'marketing.campaigns',\n  'commerce.sales',\n  'bookings.services',\n]\n\n/** The windows, in days, an insight reads: the Traffic card's own ranges. */\nexport const AI_INSIGHT_WINDOWS: readonly number[] = [7, 14, 30, 90]\n\n/** The window a question that names none reads: the Traffic card's default. */\nexport const AI_INSIGHT_DEFAULT_DAYS = 14\n\n/** The window a weekly digest reads. */\nexport const AI_INSIGHT_DIGEST_DAYS = 7\n\n/** A window an insight's inputs or a read names, held to the readers' own ranges. */\nexport function aiInsightDays(value: unknown): number {\n  const days = typeof value === 'number' ? value : Number(value)\n  return AI_INSIGHT_WINDOWS.includes(days) ? days : AI_INSIGHT_DEFAULT_DAYS\n}\n\n/** The most insights one answer carries: a person reads them at a glance. */\nexport const AI_INSIGHT_MAX_INSIGHTS = 5\n\n/** The longest one insight may run, in characters. */\nexport const AI_INSIGHT_MAX_CHARS = 280\n\n/** The longest the sentence about what the figures could not answer may run. */\nexport const AI_INSIGHT_GAP_MAX_CHARS = 200\n\n/** The most tables one citation list names. */\nexport const AI_INSIGHT_MAX_CITES = 3\n\n/** The most rows one citation names. */\nexport const AI_INSIGHT_MAX_CITED_ROWS = 10\n\n/** The most readers one answer reads. */\nexport const AI_INSIGHT_MAX_READS = 4\n\n/** The longest question an insight job admits. */\nexport const AI_INSIGHT_QUESTION_MAX_CHARS = 1_000\n\n/**\n * A table as an insight job keeps it: the figures a reader returned, the\n * handle the model cites them by, and the reader they came from.\n */\nexport interface AiInsightTable extends PluginFigureTable {\n  /** `t1`, `t2`, …, in the order the job read them. */\n  ref: string\n  /** The reader's id (`commerce.sales`). */\n  reader: string\n  /** The window the reader was asked for, in days; 0 for a reader of current counts. */\n  days: number\n  /** Whether the table is about one site (its path under that site) or the workspace. */\n  scope: 'site' | 'org'\n}\n\n/** The rows of one table an insight's figures come from, by index. */\nexport interface AiInsightCitation {\n  table: string\n  rows: number[]\n}\n\nexport interface AiInsight {\n  /** One or two plain sentences. */\n  text: string\n  cites: AiInsightCitation[]\n}\n\n/** What the model answers with. */\nexport interface AiInsightAnswer {\n  insights: AiInsight[]\n  /** What the figures could not answer, in one sentence without numbers; `null` when nothing. */\n  gap: string | null\n}\n\n/** The answer collection under the org: server-written, and read through the insights door alone. */\nexport const AI_INSIGHTS_COLLECTION = 'aiInsights'\n\n/** An insight job's answer, as the step stores it. */\nexport interface AiInsightRecord {\n  jobId: string\n  orgId: string\n  hostId: string | null\n  surface: AiInsightSurface\n  /** The member whose question it answers; for a digest, the member it was made for. */\n  createdBy: string\n  /** The question, verbatim; a digest's is the digest's own title. */\n  question: string\n  /** The window the answer was asked about, in days. */\n  days: number\n  /** The insights that trace to the rows they cite; every other one was left out. */\n  insights: AiInsight[]\n  gap: string | null\n  /** Every table the job read, so each citation opens the figures it names. */\n  tables: AiInsightTable[]\n  /** How many insights the answer carried that were left out as not traceable. */\n  left: number\n  /** The ISO week a digest covers (`2026-W38`); `null` on a question. */\n  week: string | null\n  createdAtMs: number\n}\n\n/** The output id an answer is named by. */\nexport const AI_INSIGHT_OUTPUT_LABEL = 'Answer'\n\n/**\n * The output an insight job records: the answer's address and how many\n * insights it holds, and no figure. The count is a statement about the\n * answer rather than about the site, so every member may read it.\n */\nexport function aiInsightOutput(\n  job: Pick<AiJob, '$id' | 'hostId'>,\n  record: Pick<AiInsightRecord, 'insights' | 'surface'>,\n  hostSubdomain: string | null,\n): AiJobOutput {\n  const count = record.insights.length\n  return {\n    resource: 'insight',\n    id: job.$id,\n    versionId: null,\n    hostId: job.hostId ?? null,\n    hostSubdomain,\n    label: record.surface === 'digest' ? 'Weekly insights' : AI_INSIGHT_OUTPUT_LABEL,\n    note: count\n      ? `${count} ${count === 1 ? 'insight' : 'insights'}, each traced to the figures it cites.`\n      : 'The figures did not answer this question.',\n  }\n}\n\n/** The answer on the wire: the stored record, with nothing a client does not render. */\nexport type AiInsightAnswerWire = AiInsightRecord\n\n/**\n * The Assist panel's insight surface for a console path, or `null` off one.\n * A site's Analytics, Data and CRM Reports pages, and the workspace's Data\n * page; the workspace's CRM Reports reads site figures, so it is not one.\n */\nexport function aiInsightSurfaceForPath(\n  pathname: string | null | undefined,\n): { surface: Exclude<AiInsightSurface, 'digest'>; host: string | null } | null {\n  const segments = String(pathname ?? '')\n    .split('?')[0]\n    .split('/')\n    .filter(Boolean)\n  // `/{org}/hosts/{host}/…` on a site, `/{org}/…` on the workspace.\n  if (segments[1] === 'hosts' && segments.length >= 4) {\n    const host = segments[2]\n    const rest = segments.slice(3)\n    if (rest[0] === 'analytics') return { surface: 'analytics', host }\n    if (rest[0] === 'data') return { surface: 'datasets', host }\n    if (rest[0] === 'crm' && rest[1] === 'reports') return { surface: 'crm-reports', host }\n    return null\n  }\n  if (segments.length >= 2 && segments[1] === 'data') return { surface: 'datasets', host: null }\n  return null\n}\n\n/** The console page a table's figures come from, or `null` when the table names none. */\nexport function aiInsightSourceHref(\n  table: Pick<AiInsightTable, 'source' | 'scope'>,\n  where: { orgSlug: string; host: string | null },\n): string | null {\n  const path = table.source.path\n  if (!path || !where.orgSlug) return null\n  if (table.scope === 'org') return `/${where.orgSlug}/${path}`\n  return where.host ? `/${where.orgSlug}/hosts/${where.host}/${path}` : null\n}\n\n/** How a cell reads to a person, by its column's kind; `null` is \"—\". */\nexport function aiInsightCellText(\n  table: Pick<AiInsightTable, 'columns'>,\n  key: string,\n  value: string | number | null | undefined,\n): string {\n  if (value === null || value === undefined || value === '') return '—'\n  const column = table.columns.find((entry) => entry.key === key)\n  if (typeof value === 'string' || !column) return String(value)\n  switch (column.kind) {\n    case 'money':\n      return new Intl.NumberFormat('en-US', {\n        style: 'currency',\n        currency: column.currency ?? 'USD',\n      }).format(value)\n    case 'percent':\n      return `${value.toLocaleString('en-US', { maximumFractionDigits: 1 })}%`\n    case 'change':\n      return `${value > 0 ? '+' : ''}${value.toLocaleString('en-US', { maximumFractionDigits: 1 })}%`\n    case 'duration': {\n      const seconds = Math.round(value)\n      if (seconds < 60) return `${seconds}s`\n      const minutes = Math.floor(seconds / 60)\n      if (minutes < 60) return `${minutes}m ${String(seconds % 60).padStart(2, '0')}s`\n      return `${Math.floor(minutes / 60)}h ${String(minutes % 60).padStart(2, '0')}m`\n    }\n    default:\n      return value.toLocaleString('en-US', { maximumFractionDigits: 2 })\n  }\n}\n\n/** One cited row as a line a person reads: every column, labeled. */\nexport function aiInsightRowText(table: Pick<AiInsightTable, 'columns' | 'rows'>, index: number): string {\n  const row = table.rows[index]\n  if (!row) return ''\n  return table.columns\n    .map((column) => `${column.label}: ${aiInsightCellText(table, column.key, row[column.key])}`)\n    .join(' · ')\n}\n\n/** The ISO 8601 week an instant falls in, in UTC (`2026-W38`). */\nexport function aiInsightIsoWeek(at: Date): string {\n  const date = new Date(Date.UTC(at.getUTCFullYear(), at.getUTCMonth(), at.getUTCDate()))\n  // Thursday decides the week's year.\n  const weekday = date.getUTCDay() || 7\n  date.setUTCDate(date.getUTCDate() + 4 - weekday)\n  const yearStart = Date.UTC(date.getUTCFullYear(), 0, 1)\n  const week = Math.ceil(((date.getTime() - yearStart) / 86_400_000 + 1) / 7)\n  return `${date.getUTCFullYear()}-W${String(week).padStart(2, '0')}`\n}\n"],"names":["AI_INSIGHT_SURFACES","AI_INSIGHT_ASK_SURFACES","aiInsightSurface","inputs","surface","includes","AI_INSIGHT_SURFACE_READERS","analytics","datasets","digest","aiInsightSurfaceNeedsSite","AI_INSIGHT_DIGEST_READERS","AI_INSIGHT_WINDOWS","AI_INSIGHT_DEFAULT_DAYS","AI_INSIGHT_DIGEST_DAYS","aiInsightDays","value","days","Number","AI_INSIGHT_MAX_INSIGHTS","AI_INSIGHT_MAX_CHARS","AI_INSIGHT_GAP_MAX_CHARS","AI_INSIGHT_MAX_CITES","AI_INSIGHT_MAX_CITED_ROWS","AI_INSIGHT_MAX_READS","AI_INSIGHT_QUESTION_MAX_CHARS","AI_INSIGHTS_COLLECTION","AI_INSIGHT_OUTPUT_LABEL","aiInsightOutput","job","record","hostSubdomain","count","insights","length","resource","id","$id","versionId","hostId","label","note","aiInsightSurfaceForPath","pathname","segments","String","split","filter","Boolean","host","rest","slice","aiInsightSourceHref","table","where","path","source","orgSlug","scope","aiInsightCellText","key","undefined","column","columns","find","entry","kind","Intl","NumberFormat","style","currency","format","toLocaleString","maximumFractionDigits","seconds","Math","round","minutes","floor","padStart","aiInsightRowText","index","row","rows","map","join","aiInsightIsoWeek","at","date","Date","UTC","getUTCFullYear","getUTCMonth","getUTCDate","weekday","getUTCDay","setUTCDate","yearStart","week","ceil","getTime"],"mappings":"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"}