@pithy-sh/support 0.5.1 → 0.6.1

package/dist/store/threads.d.ts

@@ -1,10 +1,11 @@
 // SPDX-FileCopyrightText: 2026 Pithy
 // SPDX-License-Identifier: MIT
-import type { Logger } from "@pithy-sh/core/src/logger/logger";
+import type { DatabaseSchema } from "@pithy-sh/core/src/data/db";
+import type { SelectQueryBuilder } from "kysely";
 import { SupportAttachment } from "../data/attachment";
 import type { SupportChannel, SupportPriority, SupportSentiment } from "../data/enums";
 import { SupportMessage } from "../data/message";
-import { type SupportDatabase } from "../data/tables";
+import { SUPPORT_FLAGS_TABLE, SUPPORT_THREADS_TABLE, type SupportDatabase, type SupportTables } from "../data/tables";
 import { SupportThread } from "../data/thread";
 /**
  * The inbox query — the one read this whole data model was shaped around.
@@ -39,8 +40,12 @@ export interface ThreadCursor {
 export declare function encodeCursor(cursor: ThreadCursor): string;
 /** Decode a cursor. Returns undefined for anything malformed — a bad cursor is a first page, not a 500. */
 export declare function decodeCursor(value: string | undefined): ThreadCursor | undefined;
-/** What a caller may filter the inbox by. */
-export interface ListThreadsQuery {
+/**
+ * What a caller may narrow threads by — the inbox listing and the search route alike. Search applies
+ * these in D1, after retrieval, never as Vectorize metadata: metadata would go stale the moment a thread is
+ * archived, reassigned or reclassified.
+ */
+export interface ThreadFilters {
     /** Open threads, done threads, or both. Defaults to open. */
     archived?: boolean;
     /** One category key from the effective taxonomy — what the classifier decided. */
@@ -55,8 +60,16 @@ export interface ListThreadsQuery {
     channel?: SupportChannel;
     /** Which inbox address, for a Worker serving more than one. */
     inbox?: string;
-    /** Free text over subjects and bodies. */
-    q?: string;
+    /** Whose threads: one assignee's opaque ref, or {@link UNASSIGNED} for the threads nobody has. */
+    assignee?: string;
+}
+/**
+ * What a caller may filter the inbox by, and where to resume.
+ *
+ * **No free text.** Listing lists; `GET {basePath}/threads/search` searches, ranked, with a limit and no
+ * cursor. A `q` here could say whether a thread matched, never how well.
+ */
+export interface ListThreadsQuery extends ThreadFilters {
     /** Where to resume from. */
     cursor?: string;
     /** How many to return. */
@@ -76,6 +89,160 @@ export interface ThreadPage {
     /** The cursor for the next page, or null when this was the last one. */
     nextCursor: string | null;
 }
+type SupportSchema = DatabaseSchema<SupportTables>;
+type ThreadsAndFlags = typeof SUPPORT_THREADS_TABLE | typeof SUPPORT_FLAGS_TABLE;
+/**
+ * Threads joined to one viewer's own flags.
+ *
+ * Joined on the viewer as well as the thread, so one operator's snooze never hides a thread from anybody
+ * else — the whole reason these flags are per viewer rather than on the thread.
+ */
+export declare function viewerThreads(db: SupportDatabase, viewer: string): SelectQueryBuilder<{
+    pithySupportAssignments: {
+        id: string;
+        threadId: string;
+        assigneeRef?: string | null | undefined;
+        assigneeName?: string | null | undefined;
+        previousRef?: string | null | undefined;
+        previousName?: string | null | undefined;
+        actorType: "control-plane" | "user";
+        assignedBy: string;
+        note?: string | null | undefined;
+        createdAt: string | number | Date;
+    };
+    pithySupportAttachments: {
+        id: string;
+        messageId: string;
+        threadId: string;
+        filename: string;
+        contentType: string;
+        size: number;
+        sha256: string;
+        storageKey: string;
+        contentId?: string | null | undefined;
+        inline: string | 0 | 1 | boolean;
+        createdAt: string | number | Date;
+    };
+    pithySupportClassifications: {
+        id: string;
+        threadId: string;
+        messageId: string;
+        category: string;
+        priority: "low" | "normal" | "urgent";
+        sentiment: "angry" | "frustrated" | "neutral" | "positive";
+        confidence: number;
+        model: string;
+        createdAt: string | number | Date;
+    };
+    pithySupportEmbeddings: {
+        messageId: string;
+        model: string;
+        embeddedAt: string | number | Date;
+    };
+    pithySupportMessages: {
+        id: string;
+        threadId: string;
+        direction: "inbound" | "outbound";
+        channel: "app" | "email";
+        submittedByUserId?: string | null | undefined;
+        context?: string | {
+            screen?: string | undefined;
+            appVersion?: string | undefined;
+            platform?: string | undefined;
+            environment?: string | undefined;
+            locale?: string | undefined;
+        } | null | undefined;
+        mimeMessageId?: string | null | undefined;
+        mimeInReplyTo?: string | null | undefined;
+        mimeReferences?: string | string[] | null | undefined;
+        fromAddress?: string | null | undefined;
+        fromName?: string | null | undefined;
+        toAddress?: string | null | undefined;
+        subject: string;
+        textBody: string;
+        htmlBody?: string | null | undefined;
+        emailJobId?: string | null | undefined;
+        rawKey?: string | null | undefined;
+        rawBytes?: number | null | undefined;
+        receivedAt: string | number | Date;
+        createdAt: string | number | Date;
+    };
+    pithySupportThreadFlags: import("kysely").Nullable<{
+        id: string;
+        threadId: string;
+        viewer: string;
+        read: string | 0 | 1 | boolean;
+        snoozedUntil?: string | number | Date | null | undefined;
+        createdAt: string | number | Date;
+        updatedAt: string | number | Date;
+    }>;
+    pithySupportThreads: {
+        id: string;
+        channel: "app" | "email";
+        inboxAddress?: string | null | undefined;
+        subject: string;
+        fromAddress: string;
+        fromName?: string | null | undefined;
+        senderAuthenticated: string | 0 | 1 | boolean;
+        userId?: string | null | undefined;
+        accountLinkSource?: "email_address" | "session" | null | undefined;
+        declaredCategory?: string | null | undefined;
+        category: string;
+        priority: "low" | "normal" | "urgent";
+        sentiment: "angry" | "frustrated" | "neutral" | "positive";
+        confidence?: number | null | undefined;
+        model?: string | null | undefined;
+        classifiedAt?: string | number | Date | null | undefined;
+        archived: string | 0 | 1 | boolean;
+        archivedAt?: string | number | Date | null | undefined;
+        archivedBy?: string | null | undefined;
+        assigneeRef?: string | null | undefined;
+        assigneeName?: string | null | undefined;
+        assignedAt?: string | number | Date | null | undefined;
+        assignedBy?: string | null | undefined;
+        messageCount: number;
+        firstMessageAt: string | number | Date;
+        lastMessageAt: string | number | Date;
+        createdAt: string | number | Date;
+        updatedAt: string | number | Date;
+    };
+}, "pithySupportThreadFlags" | "pithySupportThreads", {
+    accountLinkSource: "email_address" | "session" | null | undefined;
+    archived: string | 0 | 1 | boolean;
+    archivedAt: string | number | Date | null | undefined;
+    archivedBy: string | null | undefined;
+    assignedAt: string | number | Date | null | undefined;
+    assignedBy: string | null | undefined;
+    assigneeName: string | null | undefined;
+    assigneeRef: string | null | undefined;
+    category: string;
+    channel: "app" | "email";
+    classifiedAt: string | number | Date | null | undefined;
+    confidence: number | null | undefined;
+    createdAt: string | number | Date;
+    declaredCategory: string | null | undefined;
+    firstMessageAt: string | number | Date;
+    fromAddress: string;
+    fromName: string | null | undefined;
+    id: string;
+    inboxAddress: string | null | undefined;
+    lastMessageAt: string | number | Date;
+    messageCount: number;
+    model: string | null | undefined;
+    priority: "low" | "normal" | "urgent";
+    senderAuthenticated: string | 0 | 1 | boolean;
+    sentiment: "angry" | "frustrated" | "neutral" | "positive";
+    subject: string;
+    updatedAt: string | number | Date;
+    userId: string | null | undefined;
+} & {
+    viewerRead: string | 0 | 1 | boolean | null;
+    viewerSnoozedUntil: string | number | Date | null | undefined;
+}>;
+/** A row out of {@link viewerThreads}, as the listing and the search both return it. */
+export declare function listedThreadOf(row: Record<string, unknown>): ListedThread;
+/** Narrow a {@link viewerThreads} query by every filter the caller set — one statement of them, for both routes. */
+export declare function applyThreadFilters<O>(builder: SelectQueryBuilder<SupportSchema, ThreadsAndFlags, O>, filters: ThreadFilters): SelectQueryBuilder<SupportSchema, ThreadsAndFlags, O>;
 /**
  * List threads, as one viewer sees them.
  *
@@ -85,10 +252,8 @@ export interface ThreadPage {
  * flag row for this viewer — the overwhelming majority — still appears, unread and unsnoozed.
  */
 export declare function listThreads(db: SupportDatabase, query: ListThreadsQuery, options: {
-    fts: boolean;
     viewer: string;
     now: Date;
-    log?: Logger;
 }): Promise<ThreadPage>;
 /** A thread with everything a reading pane shows. */
 export interface ThreadDetail {
@@ -146,4 +311,5 @@ export declare function setFlags(db: SupportDatabase, options: {
     newId: () => string;
     now: Date;
 }): Promise<void>;
+export {};
 //# sourceMappingURL=threads.d.ts.map

package/dist/store/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/store/threads.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/store/threads.ts"],"names":[],"mappings":"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"}

package/dist/store/threads.js

@@ -1,14 +1,12 @@
 // SPDX-FileCopyrightText: 2026 Pithy
 // SPDX-License-Identifier: MIT
 import { SupportNotFoundError } from "../error/errors.js";
+import "../data/assignment.js";
 import { SupportAttachment } from "../data/attachment.js";
 import { SupportMessage } from "../data/message.js";
 import { SupportThread } from "../data/thread.js";
 import { SUPPORT_ATTACHMENTS_TABLE, SUPPORT_FLAGS_TABLE, SUPPORT_MESSAGES_TABLE, SUPPORT_THREADS_TABLE } from "../data/tables.js";
 import "./paging.js";
-import { isSearchable, searchPredicate } from "./search.js";
-import { pithyCommandOf } from "@pithy-sh/core/src/cli/command";
-import { sql } from "kysely";
 //#region src/store/threads.ts
 /**
 * Encode a cursor for the wire.
@@ -39,6 +37,35 @@ function decodeCursor(value) {
 	}
 }
 /**
+* Threads joined to one viewer's own flags.
+*
+* Joined on the viewer as well as the thread, so one operator's snooze never hides a thread from anybody
+* else — the whole reason these flags are per viewer rather than on the thread.
+*/
+function viewerThreads(db, viewer) {
+	return db.selectFrom(SUPPORT_THREADS_TABLE).leftJoin(SUPPORT_FLAGS_TABLE, (join) => join.onRef(`${SUPPORT_FLAGS_TABLE}.threadId`, "=", `${SUPPORT_THREADS_TABLE}.id`).on(`${SUPPORT_FLAGS_TABLE}.viewer`, "=", viewer)).selectAll(SUPPORT_THREADS_TABLE).select([`${SUPPORT_FLAGS_TABLE}.read as viewerRead`, `${SUPPORT_FLAGS_TABLE}.snoozedUntil as viewerSnoozedUntil`]);
+}
+/** A row out of {@link viewerThreads}, as the listing and the search both return it. */
+function listedThreadOf(row) {
+	return {
+		...SupportThread.parse(row),
+		read: row.viewerRead === 1,
+		snoozedUntil: row.viewerSnoozedUntil == null ? null : new Date(Number(row.viewerSnoozedUntil))
+	};
+}
+/** Narrow a {@link viewerThreads} query by every filter the caller set — one statement of them, for both routes. */
+function applyThreadFilters(builder, filters) {
+	let filtered = builder.where(`${SUPPORT_THREADS_TABLE}.archived`, "=", filters.archived === true ? 1 : 0);
+	if (filters.category !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.category`, "=", filters.category);
+	if (filters.declaredCategory !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.declaredCategory`, "=", filters.declaredCategory);
+	if (filters.priority !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.priority`, "=", filters.priority);
+	if (filters.sentiment !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.sentiment`, "=", filters.sentiment);
+	if (filters.channel !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.channel`, "=", filters.channel);
+	if (filters.inbox !== void 0) filtered = filtered.where(`${SUPPORT_THREADS_TABLE}.inboxAddress`, "=", filters.inbox);
+	if (filters.assignee !== void 0) filtered = filters.assignee === "none" ? filtered.where(`${SUPPORT_THREADS_TABLE}.assigneeRef`, "is", null) : filtered.where(`${SUPPORT_THREADS_TABLE}.assigneeRef`, "=", filters.assignee);
+	return filtered;
+}
+/**
 * List threads, as one viewer sees them.
 *
 * The viewer is a parameter rather than an afterthought because the per-viewer flags are **read
@@ -47,46 +74,12 @@ function decodeCursor(value) {
 * flag row for this viewer — the overwhelming majority — still appears, unread and unsnoozed.
 */
 async function listThreads(db, query, options) {
-	try {
-		return await runListThreads(db, query, options);
-	} catch (error) {
-		if (options.fts && isMissingSearchTable(error)) {
-			options.log?.warn("support FTS index is configured but absent — falling back to a LIKE scan", { action: `Run \`${pithyCommandOf("support provision", {}, { runtime: true })}\` to create and backfill it, or set \`search.fts: false\`.` });
-			return runListThreads(db, query, {
-				...options,
-				fts: false
-			});
-		}
-		throw error;
-	}
-}
-/** Whether an error is SQLite saying the full-text index does not exist. */
-function isMissingSearchTable(error) {
-	const message = error instanceof Error ? error.message : String(error);
-	return message.includes("no such table") && message.includes("pithy_support_search");
-}
-/** The listing itself, for one chosen search backend. */
-async function runListThreads(db, query, options) {
 	const limit = Math.min(Math.max(query.limit ?? 25, 1), 100);
 	const cursor = decodeCursor(query.cursor);
-	let builder = db.selectFrom(SUPPORT_THREADS_TABLE).leftJoin(SUPPORT_FLAGS_TABLE, (join) => join.onRef(`${SUPPORT_FLAGS_TABLE}.threadId`, "=", `${SUPPORT_THREADS_TABLE}.id`).on(`${SUPPORT_FLAGS_TABLE}.viewer`, "=", options.viewer)).selectAll(SUPPORT_THREADS_TABLE).select([`${SUPPORT_FLAGS_TABLE}.read as viewerRead`, `${SUPPORT_FLAGS_TABLE}.snoozedUntil as viewerSnoozedUntil`]).where((eb) => eb.or([eb(`${SUPPORT_FLAGS_TABLE}.snoozedUntil`, "is", null), eb(`${SUPPORT_FLAGS_TABLE}.snoozedUntil`, "<=", options.now.getTime())])).where(`${SUPPORT_THREADS_TABLE}.archived`, "=", query.archived === true ? 1 : 0);
-	if (query.category !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.category`, "=", query.category);
-	if (query.declaredCategory !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.declaredCategory`, "=", query.declaredCategory);
-	if (query.priority !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.priority`, "=", query.priority);
-	if (query.sentiment !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.sentiment`, "=", query.sentiment);
-	if (query.channel !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.channel`, "=", query.channel);
-	if (query.inbox !== void 0) builder = builder.where(`${SUPPORT_THREADS_TABLE}.inboxAddress`, "=", query.inbox);
-	if (query.q !== void 0) {
-		if (isSearchable(query.q, options.fts)) builder = builder.where(searchPredicate(query.q, options));
-		else builder = builder.where(sql`1 = 0`);
-	}
+	let builder = applyThreadFilters(viewerThreads(db, options.viewer), query).where((eb) => eb.or([eb(`${SUPPORT_FLAGS_TABLE}.snoozedUntil`, "is", null), eb(`${SUPPORT_FLAGS_TABLE}.snoozedUntil`, "<=", options.now.getTime())]));
 	if (cursor) builder = builder.where((eb) => eb.or([eb(`${SUPPORT_THREADS_TABLE}.lastMessageAt`, "<", cursor.lastMessageAt), eb.and([eb(`${SUPPORT_THREADS_TABLE}.lastMessageAt`, "=", cursor.lastMessageAt), eb(`${SUPPORT_THREADS_TABLE}.id`, "<", cursor.id)])]));
 	const rows = await builder.orderBy(`${SUPPORT_THREADS_TABLE}.lastMessageAt`, "desc").orderBy(`${SUPPORT_THREADS_TABLE}.id`, "desc").limit(limit + 1).execute();
-	const page = rows.slice(0, limit).map((row) => ({
-		...SupportThread.parse(row),
-		read: row.viewerRead === 1,
-		snoozedUntil: row.viewerSnoozedUntil == null ? null : new Date(Number(row.viewerSnoozedUntil))
-	}));
+	const page = rows.slice(0, limit).map(listedThreadOf);
 	const last = page[page.length - 1];
 	return {
 		threads: page,
@@ -197,4 +190,4 @@ async function setFlags(db, options) {
 	}))).execute();
 }
 //#endregion
-export { decodeCursor, encodeCursor, listOwnThreads, listThreads, readOwnThread, readThread, setArchived, setFlags };
+export { applyThreadFilters, decodeCursor, encodeCursor, listOwnThreads, listThreads, listedThreadOf, readOwnThread, readThread, setArchived, setFlags, viewerThreads };

package/dist/submission/submit.d.ts

@@ -3,7 +3,7 @@
 import type { R2Bucket } from "@cloudflare/workers-types";
 import type { AuditEmit } from "@pithy-sh/core/src/audit/recorder";
 import type { Logger } from "@pithy-sh/core/src/logger/logger";
-import type { SupportConfig } from "../config/config";
+import { type SupportConfig } from "../config/config";
 import { type SupportCategories } from "../data/categories";
 import { type SupportSubmissionContext } from "../data/message";
 import { type SupportDatabase } from "../data/tables";

package/dist/submission/submit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/submission/submit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAkB,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,EAAE,EAAE,eAAe,CAAC;IACpB,2BAA2B;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;;;OAOG;IACH,UAAU,EAAE,iBAAiB,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;OAIG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrF,2FAA2F;IAC3F,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,sBAAsB;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,WAAW;IACX,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,sGAAsG;AACtG,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,2CAA2C;IAC3C,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC7C;AA0MD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG7G;AAED,kCAAkC;AAClC,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA2JjG"}
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/submission/submit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAGnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG/D,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAkB,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,EAAE,EAAE,eAAe,CAAC;IACpB,2BAA2B;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;;;OAOG;IACH,UAAU,EAAE,iBAAiB,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;OAIG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrF,2FAA2F;IAC3F,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,sBAAsB;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,WAAW;IACX,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,sGAAsG;AACtG,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,2CAA2C;IAC3C,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC7C;AA0MD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG7G;AAED,kCAAkC;AAClC,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA4JjG"}

package/dist/submission/submit.js

@@ -1,6 +1,7 @@
 // SPDX-FileCopyrightText: 2026 Pithy
 // SPDX-License-Identifier: MIT
 import { SupportInvalidCategoryError, SupportNotFoundError, SupportRejectedError } from "../error/errors.js";
+import { supportSemantic } from "../config/config.js";
 import { categoryEnum } from "../data/categories.js";
 import { SupportAttachment } from "../data/attachment.js";
 import { SupportMessage } from "../data/message.js";
@@ -287,7 +288,7 @@ async function submitFeedback(deps, input) {
 		});
 	}
 	const classifying = deps.config.ai.enabled;
-	if (classifying) try {
+	if (classifying || supportSemantic(deps.config.search) !== void 0) try {
 		await deps.dispatchClassify(messageId);
 	} catch (error) {
 		deps.log.warn("support submission classification dispatch failed", {

package/dist/test-utils/seed.d.ts

@@ -0,0 +1,33 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import type { D1Database } from "@cloudflare/workers-types";
+import type { SupportChannel, SupportPriority, SupportSentiment } from "../data/enums";
+import { type SupportDatabase } from "../data/tables";
+/** Rows for Workers tests: a clean support schema, a thread, and a message, each with sensible defaults. */
+export declare const SEED_INBOX = "support@help.example.com";
+/** Drop everything and run the whole chain, so each test starts from today's schema. */
+export declare function freshSupportSchema(d1: D1Database): Promise<void>;
+/** Insert one thread. */
+export declare function seedThread(db: SupportDatabase, seed: {
+    id: string;
+    lastMessageAt: number;
+    category?: string;
+    declaredCategory?: string;
+    priority?: SupportPriority;
+    sentiment?: SupportSentiment;
+    channel?: SupportChannel;
+    inbox?: string;
+    archived?: boolean;
+    assigneeRef?: string;
+    subject?: string;
+}): Promise<void>;
+/** Insert one message. */
+export declare function seedMessage(db: SupportDatabase, seed: {
+    id: string;
+    threadId: string;
+    subject: string;
+    body: string;
+    receivedAt?: number;
+    direction?: "inbound" | "outbound";
+}): Promise<void>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/test-utils/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/test-utils/seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGvF,OAAO,EAAiD,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIrG,4GAA4G;AAE5G,eAAO,MAAM,UAAU,6BAA6B,CAAC;AAgBrD,wFAAwF;AACxF,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AAED,yBAAyB;AACzB,wBAAsB,UAAU,CAC9B,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,0BAA0B;AAC1B,wBAAsB,WAAW,CAC/B,EAAE,EAAE,eAAe,EACnB,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC,GACA,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist/test-utils/seed.js

@@ -0,0 +1,102 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import "../data/enums.js";
+import { SupportMessage } from "../data/message.js";
+import { SupportThread } from "../data/thread.js";
+import { SUPPORT_MESSAGES_TABLE, SUPPORT_THREADS_TABLE } from "../data/tables.js";
+import { SUPPORT_MIGRATIONS } from "../migrations/set.js";
+import { SUPPORT_MIGRATION_ORDER } from "../capability.js";
+import { createMigrationRegistry } from "@pithy-sh/core/src/migrations/registry";
+import { runMigrations } from "@pithy-sh/core/src/migrations/runner";
+//#region src/test-utils/seed.ts
+/** Rows for Workers tests: a clean support schema, a thread, and a message, each with sensible defaults. */
+const SEED_INBOX = "support@help.example.com";
+/** Every table a support test may have left behind, children first. */
+const TABLES = [
+	"pithy_support_search",
+	"pithy_support_embeddings",
+	"pithy_support_assignments",
+	"pithy_support_thread_flags",
+	"pithy_support_classifications",
+	"pithy_support_attachments",
+	"pithy_support_messages",
+	"pithy_support_threads",
+	"pithy_migrations",
+	"pithy_migrations_lock"
+];
+/** Drop everything and run the whole chain, so each test starts from today's schema. */
+async function freshSupportSchema(d1) {
+	await d1.exec("DROP TRIGGER IF EXISTS pithy_support_search_ai");
+	await d1.exec("DROP TRIGGER IF EXISTS pithy_support_search_au");
+	await d1.exec("DROP TRIGGER IF EXISTS pithy_support_search_ad");
+	for (const table of TABLES) await d1.exec(`DROP TABLE IF EXISTS ${table}`);
+	const registry = createMigrationRegistry([{
+		database: "app",
+		namespace: "support",
+		order: SUPPORT_MIGRATION_ORDER,
+		migrations: SUPPORT_MIGRATIONS
+	}]);
+	if (!registry.app) throw new Error("expected a provider for database \"app\"");
+	await runMigrations(d1, registry.app);
+}
+/** Insert one thread. */
+async function seedThread(db, seed) {
+	const at = new Date(seed.lastMessageAt);
+	await db.insertInto(SUPPORT_THREADS_TABLE).values(SupportThread.encode({
+		id: seed.id,
+		channel: seed.channel ?? "email",
+		inboxAddress: seed.inbox ?? "support@help.example.com",
+		subject: seed.subject ?? `Thread ${seed.id}`,
+		fromAddress: "ada@example.com",
+		fromName: null,
+		senderAuthenticated: true,
+		userId: null,
+		declaredCategory: seed.declaredCategory ?? null,
+		category: seed.category ?? "uncategorized",
+		priority: seed.priority ?? "normal",
+		sentiment: seed.sentiment ?? "neutral",
+		confidence: null,
+		model: null,
+		classifiedAt: null,
+		archived: seed.archived ?? false,
+		archivedAt: null,
+		archivedBy: null,
+		assigneeRef: seed.assigneeRef ?? null,
+		assigneeName: seed.assigneeRef ? `Name ${seed.assigneeRef}` : null,
+		assignedAt: seed.assigneeRef ? at : null,
+		assignedBy: seed.assigneeRef ? "cp-1" : null,
+		messageCount: 1,
+		firstMessageAt: at,
+		lastMessageAt: at,
+		createdAt: at,
+		updatedAt: at
+	})).execute();
+}
+/** Insert one message. */
+async function seedMessage(db, seed) {
+	const at = new Date(seed.receivedAt ?? 17e11);
+	await db.insertInto(SUPPORT_MESSAGES_TABLE).values(SupportMessage.encode({
+		id: seed.id,
+		threadId: seed.threadId,
+		direction: seed.direction ?? "inbound",
+		channel: "email",
+		submittedByUserId: null,
+		context: null,
+		mimeMessageId: `${seed.id}@mail.example.com`,
+		mimeInReplyTo: null,
+		mimeReferences: null,
+		fromAddress: "ada@example.com",
+		fromName: null,
+		toAddress: SEED_INBOX,
+		subject: seed.subject,
+		textBody: seed.body,
+		htmlBody: null,
+		emailJobId: seed.direction === "outbound" ? `job-${seed.id}` : null,
+		rawKey: null,
+		rawBytes: null,
+		receivedAt: at,
+		createdAt: at
+	})).execute();
+}
+//#endregion
+export { SEED_INBOX, freshSupportSchema, seedMessage, seedThread };

package/dist/test-utils/semantic.d.ts

@@ -0,0 +1,21 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+import type { VectorAi } from "@pithy-sh/vector/src/embed/embed";
+import type { VectorStore, VectorUpsert } from "@pithy-sh/vector/src/index/index";
+/** Embed one text the fake way: concept counts, hashed onto components, unit length. */
+export declare function fakeEmbedding(text: string, dimensions: number): number[];
+/** A fake `AI` binding: records every call and answers the shape a text-embedding model does. */
+export declare function fakeAi(dimensions: number): VectorAi & {
+    calls: {
+        model: string;
+        texts: string[];
+    }[];
+    fail: boolean;
+};
+/** A fake Vectorize binding: an in-memory map, scored by cosine, with every upsert kept for inspection. */
+export declare function fakeVectorStore(): VectorStore & {
+    vectors: Map<string, number[]>;
+    upserts: VectorUpsert[][];
+    queries: Record<string, unknown>[];
+};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/test-utils/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/test-utils/semantic.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AA0ClF,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CASxE;AAED,iGAAiG;AACjG,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG;IAAE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAYpH;AAED,2GAA2G;AAC3G,wBAAgB,eAAe,IAAI,WAAW,GAAG;IAC/C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACpC,CA+BA"}

package/dist/test-utils/semantic.js

@@ -0,0 +1,107 @@
+// SPDX-FileCopyrightText: 2026 Pithy
+// SPDX-License-Identifier: MIT
+//#region src/test-utils/semantic.ts
+/**
+* Stand-ins for Workers AI and Vectorize, for tests only. Cloudflare ships no local emulation of either.
+*
+* **The embedder is not random, and that is the point.** It maps words to concepts through a small synonym table
+* and hashes each concept onto a component, so cosine similarity behaves the way a real model's does for the
+* cases the tests state: a paraphrase that shares no word with a message still lands near it, and an order
+* number is just another token. The store scores by cosine and returns ids and scores, as Vectorize does with no
+* payload requested.
+*/
+/** Words that mean the same thing to the fake model. Everything else is its own concept. */
+const CONCEPTS = {
+	upload: "upload",
+	uploads: "upload",
+	uploading: "upload",
+	file: "upload",
+	files: "upload",
+	dying: "interrupted",
+	dies: "interrupted",
+	died: "interrupted",
+	timeout: "interrupted",
+	times: "interrupted",
+	timed: "interrupted",
+	halfway: "interrupted",
+	out: "interrupted",
+	refund: "money",
+	charged: "money",
+	money: "money"
+};
+function concept(word) {
+	return CONCEPTS[word] ?? word;
+}
+function hash(text) {
+	let value = 2166136261;
+	for (const char of text) value = Math.imul(value ^ char.charCodeAt(0), 16777619);
+	return value >>> 0;
+}
+/** Embed one text the fake way: concept counts, hashed onto components, unit length. */
+function fakeEmbedding(text, dimensions) {
+	const vector = new Array(dimensions).fill(0);
+	const words = text.toLowerCase().match(/[\p{L}\p{N}-]+/gu) ?? [];
+	for (const word of words) {
+		const at = hash(concept(word)) % dimensions;
+		vector[at] = (vector[at] ?? 0) + 1;
+	}
+	const length = Math.hypot(...vector) || 1;
+	return vector.map((component) => component / length);
+}
+/** A fake `AI` binding: records every call and answers the shape a text-embedding model does. */
+function fakeAi(dimensions) {
+	const ai = {
+		calls: [],
+		fail: false,
+		async run(model, input) {
+			const texts = input.text;
+			ai.calls.push({
+				model,
+				texts
+			});
+			if (ai.fail) throw new Error("Workers AI is unavailable");
+			return {
+				shape: [texts.length, dimensions],
+				data: texts.map((text) => fakeEmbedding(text, dimensions))
+			};
+		}
+	};
+	return ai;
+}
+/** A fake Vectorize binding: an in-memory map, scored by cosine, with every upsert kept for inspection. */
+function fakeVectorStore() {
+	const vectors = /* @__PURE__ */ new Map();
+	const upserts = [];
+	const queries = [];
+	let mutation = 0;
+	return {
+		vectors,
+		upserts,
+		queries,
+		async upsert(batch) {
+			upserts.push(batch);
+			for (const vector of batch) vectors.set(vector.id, vector.values);
+			mutation += 1;
+			return { mutationId: `m-${mutation}` };
+		},
+		async query(vector, options = {}) {
+			queries.push(options);
+			const topK = Number(options.topK ?? 10);
+			const matches = [...vectors.entries()].map(([id, values]) => ({
+				id,
+				score: values.reduce((sum, value, at) => sum + value * (vector[at] ?? 0), 0)
+			})).filter((match) => match.score > 0).sort((a, b) => b.score - a.score).slice(0, topK);
+			return {
+				count: matches.length,
+				matches
+			};
+		},
+		async deleteByIds(ids) {
+			for (const id of ids) vectors.delete(id);
+			mutation += 1;
+			return { mutationId: `m-${mutation}` };
+		}
+	};
+}
+//#endregion
+export { fakeAi, fakeEmbedding, fakeVectorStore };