@x12i/memorix-retrieval 1.1.0 → 1.2.0

package/dist/client/catalox-adapter.d.ts

@@ -0,0 +1,9 @@
+import type { CataloxBound } from "@x12i/catalox";
+import type { CataloxLike } from "./catalox-like.js";
+/**
+ * Wrap a {@link CataloxBound} (context already applied) as {@link CataloxLike}
+ * for {@link createMemorixRetrieval}. Ignores the per-call `context.appId` —
+ * use the bound's fixed app context when creating the bound.
+ */
+export declare function createCataloxAdapterFromBound(bound: CataloxBound): CataloxLike;
+//# sourceMappingURL=catalox-adapter.d.ts.map

package/dist/client/catalox-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-adapter.d.ts","sourceRoot":"","sources":["../../src/client/catalox-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAc3B;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,CAmC9E"}

package/dist/client/catalox-adapter.js

@@ -0,0 +1,42 @@
+function mapGetItemResult(result) {
+    if (result.outcome === "found") {
+        return { outcome: "found", item: { data: result.item.data ?? {} } };
+    }
+    if (result.outcome === "not_found") {
+        return { outcome: "not_found" };
+    }
+    return { outcome: "mapping_blocked" };
+}
+/**
+ * Wrap a {@link CataloxBound} (context already applied) as {@link CataloxLike}
+ * for {@link createMemorixRetrieval}. Ignores the per-call `context.appId` —
+ * use the bound's fixed app context when creating the bound.
+ */
+export function createCataloxAdapterFromBound(bound) {
+    return {
+        async getCatalogItem(_context, catalogId, itemId) {
+            const result = await bound.getCatalogItem(catalogId, itemId);
+            return mapGetItemResult(result);
+        },
+        async listCatalogItems(_context, catalogId, options) {
+            const limit = Math.max(1, options?.limit ?? 200);
+            const list = await bound.listCatalogItems(catalogId, {
+                limit,
+                offset: options?.offset,
+            });
+            if (list.listOutcome === "mapping_blocked") {
+                return { items: [], hasMore: false };
+            }
+            const items = list.items.map((item) => ({
+                id: String(item.itemId),
+                data: item.data ?? {},
+                title: item.title,
+            }));
+            return {
+                items,
+                hasMore: Boolean(list.nextCursor) || items.length >= limit,
+            };
+        },
+    };
+}
+//# sourceMappingURL=catalox-adapter.js.map

package/dist/client/catalox-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-adapter.js","sourceRoot":"","sources":["../../src/client/catalox-adapter.ts"],"names":[],"mappings":"AAOA,SAAS,gBAAgB,CACvB,MAA2D;IAE3D,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAmB;IAC/D,OAAO;QACL,KAAK,CAAC,cAAc,CAClB,QAAQ,EACR,SAAS,EACT,MAAM;YAEN,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,gBAAgB,CACpB,QAAQ,EACR,SAAS,EACT,OAAO;YAEP,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE;gBACnD,KAAK;gBACL,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACvC,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBACvB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC,CAAC;YACJ,OAAO;gBACL,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;aAC3D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/catalox-like.d.ts

@@ -8,9 +8,25 @@ export type CataloxCatalogItemResult = {
 } | {
     outcome: "mapping_blocked";
 };
+export type CataloxCatalogListItem = {
+    id: string;
+    data: Record<string, unknown>;
+    title?: string;
+};
+export type CataloxCatalogListResult = {
+    items: CataloxCatalogListItem[];
+    hasMore: boolean;
+};
 export type CataloxLike = {
     getCatalogItem(context: {
         appId?: string;
     }, catalogId: string, itemId: string): Promise<CataloxCatalogItemResult>;
+    listCatalogItems?(context: {
+        appId?: string;
+    }, catalogId: string, options?: {
+        limit?: number;
+        offset?: number;
+        cursor?: string;
+    }): Promise<CataloxCatalogListResult>;
 };
 //# sourceMappingURL=catalox-like.d.ts.map

package/dist/client/catalox-like.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalox-like.d.ts","sourceRoot":"","sources":["../../src/client/catalox-like.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GAC7D;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,CACZ,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtC,CAAC"}
+{"version":3,"file":"catalox-like.d.ts","sourceRoot":"","sources":["../../src/client/catalox-like.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GAC7D;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,CACZ,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC,gBAAgB,CAAC,CACf,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtC,CAAC"}

package/dist/client/create-stack-from-env.d.ts

@@ -0,0 +1,21 @@
+import type { CataloxBound, CataloxContext } from "@x12i/catalox";
+import type { CataloxLike, MemorixRetrievalClient } from "./types.js";
+export type MemorixRetrievalStack = {
+    appId: string;
+    cataloxBound: CataloxBound;
+    catalox: CataloxLike;
+    client: MemorixRetrievalClient;
+};
+export type CreateMemorixRetrievalStackFromEnvOptions = {
+    appId?: string;
+    cataloxContext?: Omit<CataloxContext, "appId"> & {
+        appId?: string;
+    };
+    processEnv?: NodeJS.ProcessEnv;
+};
+/**
+ * One-shot wiring: Catalox from env → bound context → adapter → retrieval client.
+ * Use this in host apps (e.g. memorix-explorer API) to avoid duplicating Catalox setup.
+ */
+export declare function createMemorixRetrievalStackFromEnv(options?: CreateMemorixRetrievalStackFromEnvOptions): Promise<MemorixRetrievalStack>;
+//# sourceMappingURL=create-stack-from-env.d.ts.map

package/dist/client/create-stack-from-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-stack-from-env.d.ts","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIlE,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,GAAE,yCAA8C,GACtD,OAAO,CAAC,qBAAqB,CAAC,CA2BhC"}

package/dist/client/create-stack-from-env.js

@@ -0,0 +1,34 @@
+import { createCataloxFromEnv } from "@x12i/catalox";
+import { MEMORIX_APP_ID } from "../descriptors/catalog-ids.js";
+import { createCataloxAdapterFromBound } from "./catalox-adapter.js";
+import { createMemorixRetrievalFromEnv } from "./create-from-env.js";
+/**
+ * One-shot wiring: Catalox from env → bound context → adapter → retrieval client.
+ * Use this in host apps (e.g. memorix-explorer API) to avoid duplicating Catalox setup.
+ */
+export async function createMemorixRetrievalStackFromEnv(options = {}) {
+    const processEnv = options.processEnv ?? process.env;
+    const appId = options.appId?.trim() ||
+        options.cataloxContext?.appId?.trim() ||
+        processEnv.CATALOX_APP_ID?.trim() ||
+        processEnv.MEMORIX_APP_ID?.trim() ||
+        MEMORIX_APP_ID;
+    const { catalox } = createCataloxFromEnv();
+    const ctx = {
+        ...(options.cataloxContext ?? {}),
+        appId,
+        actor: options.cataloxContext?.actor ?? {
+            type: "service",
+            id: "memorix-retrieval",
+        },
+    };
+    const cataloxBound = catalox.withContext(ctx);
+    const cataloxAdapter = createCataloxAdapterFromBound(cataloxBound);
+    const client = await createMemorixRetrievalFromEnv({
+        appId,
+        catalox: cataloxAdapter,
+        processEnv,
+    });
+    return { appId, cataloxBound, catalox: cataloxAdapter, client };
+}
+//# sourceMappingURL=create-stack-from-env.js.map

package/dist/client/create-stack-from-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-stack-from-env.js","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAgBrE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,UAAqD,EAAE;IAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IACrD,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE;QACrB,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE;QACrC,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,cAAc,CAAC;IAEjB,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAmB;QAC1B,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACjC,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI;YACtC,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,mBAAmB;SACxB;KACF,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;QACjD,KAAK;QACL,OAAO,EAAE,cAAc;QACvB,UAAU;KACX,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAClE,CAAC"}

package/dist/client/types.d.ts

@@ -4,7 +4,7 @@ import type { createS3Client } from "@x12i/helpers/s3";
 import type { CataloxLike } from "./catalox-like.js";
 import type { XronoxLike } from "./xronox-like.js";
 import type { MemorixTarget } from "../mongo/types.js";
-export type { CataloxLike } from "./catalox-like.js";
+export type { CataloxLike, CataloxCatalogListItem, CataloxCatalogListResult } from "./catalox-like.js";
 export type { XronoxLike, XronoxReadParams } from "./xronox-like.js";
 export type ContentReaders = {
     gcs?: ReturnType<typeof createGcsClient>;

package/dist/client/types.d.ts.map

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

package/dist/data/record-id.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveMemorixRecordIdFilter(recordId: string): Record<string, unknown>;
+export declare function serializeMemorixDocumentForJson(doc: Record<string, unknown>): Record<string, unknown>;
+export declare function escapeMongoRegex(value: string): string;
+export declare function memorixLabelSearchFilter(searchText: string | undefined, fields?: readonly string[]): Record<string, unknown> | undefined;
+export declare function mergeMemorixMongoFilters(...filters: Array<Record<string, unknown> | undefined>): Record<string, unknown>;
+//# sourceMappingURL=record-id.d.ts.map

package/dist/data/record-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-id.d.ts","sourceRoot":"","sources":["../../src/data/record-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAiBD,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,GAAE,SAAS,MAAM,EAAuC,GAC7D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMrC;AAED,wBAAgB,wBAAwB,CACtC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,GACrD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/data/record-id.js

@@ -0,0 +1,49 @@
+import { ObjectId } from "mongodb";
+export function resolveMemorixRecordIdFilter(recordId) {
+    const trimmed = recordId.trim();
+    if (/^[a-fA-F0-9]{24}$/.test(trimmed)) {
+        return { _id: new ObjectId(trimmed) };
+    }
+    return { _id: trimmed };
+}
+function serializeValue(value) {
+    if (value == null)
+        return value;
+    if (value instanceof ObjectId)
+        return value.toHexString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(serializeValue);
+    if (typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = serializeValue(v);
+        }
+        return out;
+    }
+    return value;
+}
+export function serializeMemorixDocumentForJson(doc) {
+    return serializeValue(doc);
+}
+export function escapeMongoRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function memorixLabelSearchFilter(searchText, fields = ["name", "title", "label", "slug"]) {
+    const trimmed = searchText?.trim();
+    if (!trimmed)
+        return undefined;
+    const rx = escapeMongoRegex(trimmed);
+    const or = fields.map((field) => ({ [field]: { $regex: rx, $options: "i" } }));
+    return or.length === 1 ? or[0] : { $or: or };
+}
+export function mergeMemorixMongoFilters(...filters) {
+    const parts = filters.filter((f) => Boolean(f) && Object.keys(f).length > 0);
+    if (parts.length === 0)
+        return {};
+    if (parts.length === 1)
+        return parts[0];
+    return { $and: parts };
+}
+//# sourceMappingURL=record-id.js.map

package/dist/data/record-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-id.js","sourceRoot":"","sources":["../../src/data/record-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,UAAU,4BAA4B,CAC1C,QAAgB;IAEhB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,KAAK,YAAY,QAAQ;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1D,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,GAA4B;IAE5B,OAAO,cAAc,CAAC,GAAG,CAA4B,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAA8B,EAC9B,SAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IAE9D,MAAM,OAAO,GAAG,UAAU,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAAG,OAAmD;IAEtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAgC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAC9E,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAE,CAAC;IACzC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/descriptors/content-type-labels.d.ts

@@ -0,0 +1,7 @@
+/** Human-readable titles for common Memorix content-type keys. */
+export declare const MEMORIX_CONTENT_TYPE_LABELS: Record<string, string>;
+export declare function memorixContentTypeLabel(contentType: string): string;
+export declare function listEntityContentTypeKeys(entity: import("./descriptor-types.js").MemorixEntityDescriptor): string[];
+/** Primary badge count slice: scoped when defined, otherwise canonical. */
+export declare function primaryEntityContentType(entity: import("./descriptor-types.js").MemorixEntityDescriptor): string;
+//# sourceMappingURL=content-type-labels.d.ts.map

package/dist/descriptors/content-type-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type-labels.d.ts","sourceRoot":"","sources":["../../src/descriptors/content-type-labels.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW9D,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,uBAAuB,EAAE,uBAAuB,GAC9D,MAAM,EAAE,CAEV;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,uBAAuB,EAAE,uBAAuB,GAC9D,MAAM,CAGR"}

package/dist/descriptors/content-type-labels.js

@@ -0,0 +1,26 @@
+/** Human-readable titles for common Memorix content-type keys. */
+export const MEMORIX_CONTENT_TYPE_LABELS = {
+    scoped: "Scoped records",
+    snapshots: "Snapshots",
+    narratives: "Narratives",
+    web: "Web",
+    "web-scoped": "Web (scoped)",
+    raw: "Raw",
+    inference: "Inference",
+    analytics: "Analytics",
+    foresights: "Foresights",
+    analysis: "Analysis",
+};
+export function memorixContentTypeLabel(contentType) {
+    return MEMORIX_CONTENT_TYPE_LABELS[contentType] ?? contentType;
+}
+export function listEntityContentTypeKeys(entity) {
+    return Object.keys(entity.contentTypes);
+}
+/** Primary badge count slice: scoped when defined, otherwise canonical. */
+export function primaryEntityContentType(entity) {
+    if (entity.contentTypes.scoped)
+        return "scoped";
+    return entity.defaults.canonicalContentType;
+}
+//# sourceMappingURL=content-type-labels.js.map

package/dist/descriptors/content-type-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-type-labels.js","sourceRoot":"","sources":["../../src/descriptors/content-type-labels.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAA2B;IACjE,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,GAAG,EAAE,KAAK;IACV,YAAY,EAAE,cAAc;IAC5B,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO,2BAA2B,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA+D;IAE/D,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAC1C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CACtC,MAA+D;IAE/D,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC;AAC9C,CAAC"}

package/dist/descriptors/discover-entities.d.ts

@@ -0,0 +1,26 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "./descriptor-types.js";
+import { validateMemorixEntityDescriptor } from "./validate-descriptor.js";
+export type MemorixEntityDescriptorSummary = {
+    id: string;
+    entityName: string;
+    label: string;
+    target?: "entity" | "event";
+};
+export type DiscoverMemorixEntitiesResult = {
+    summaries: MemorixEntityDescriptorSummary[];
+    source: "catalox" | "env" | "none";
+    catalogId: string;
+    hint?: string;
+};
+export declare function discoverMemorixEntities(client: MemorixRetrievalClient): Promise<DiscoverMemorixEntitiesResult>;
+export declare function loadMemorixEntityDescriptorByName(client: MemorixRetrievalClient, entityName: string): Promise<MemorixEntityDescriptor>;
+export declare function entityDescriptorConnections(entity: MemorixEntityDescriptor): Array<{
+    id: string;
+    targetEntityName: string;
+    relationType: string;
+    sourceProperty: string;
+    targetProperty: string;
+}>;
+export { validateMemorixEntityDescriptor };
+//# sourceMappingURL=discover-entities.d.ts.map

package/dist/descriptors/discover-entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-entities.d.ts","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAEL,+BAA+B,EAChC,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,8BAA8B,EAAE,CAAC;IAC5C,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA2CF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,6BAA6B,CAAC,CA8DxC;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,GAC9B,KAAK,CAAC;IACP,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAkBD;AAED,OAAO,EAAE,+BAA+B,EAAE,CAAC"}

package/dist/descriptors/discover-entities.js

@@ -0,0 +1,123 @@
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, } from "./catalog-ids.js";
+import { parseDescriptorData, validateMemorixEntityDescriptor, } from "./validate-descriptor.js";
+const ENV_MEMORIX_ENTITY_NAMES = "MEMORIX_ENTITY_NAMES";
+function entityLabel(entityName, title) {
+    if (title?.trim())
+        return title.trim();
+    if (!entityName)
+        return entityName;
+    return entityName[0].toUpperCase() + entityName.slice(1).replace(/-/g, " ");
+}
+function parseEnvEntityNames(env) {
+    const raw = env[ENV_MEMORIX_ENTITY_NAMES]?.trim();
+    if (!raw)
+        return [];
+    return raw
+        .split(/[,;\s]+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+async function listAllCatalogItems(client, catalogId) {
+    const listFn = client.catalox.listCatalogItems;
+    if (!listFn) {
+        return [];
+    }
+    const out = [];
+    let offset = 0;
+    const pageSize = 200;
+    for (;;) {
+        const page = await listFn({ appId: client.appId }, catalogId, {
+            limit: pageSize,
+            offset,
+        });
+        out.push(...page.items);
+        if (!page.hasMore || page.items.length === 0)
+            break;
+        offset += page.items.length;
+        if (offset > 10_000)
+            break;
+    }
+    return out;
+}
+export async function discoverMemorixEntities(client) {
+    const catalogId = MEMORIX_ENTITY_DESCRIPTORS_CATALOG;
+    const envNames = parseEnvEntityNames(client.processEnv);
+    if (envNames.length) {
+        return {
+            source: "env",
+            catalogId,
+            summaries: envNames.map((entityName) => ({
+                id: entityName,
+                entityName,
+                label: entityLabel(entityName),
+            })),
+        };
+    }
+    if (!client.catalox.listCatalogItems) {
+        return {
+            source: "none",
+            catalogId,
+            summaries: [],
+            hint: "Catalox adapter does not support listCatalogItems — use createCataloxAdapterFromBound or set MEMORIX_ENTITY_NAMES.",
+        };
+    }
+    try {
+        const items = await listAllCatalogItems(client, catalogId);
+        const summaries = [];
+        for (const item of items) {
+            const data = parseDescriptorData(item.data);
+            const entityName = typeof data.entityName === "string" && data.entityName.trim()
+                ? data.entityName.trim()
+                : item.id;
+            summaries.push({
+                id: item.id,
+                entityName,
+                label: entityLabel(entityName, item.title),
+                target: data.target === "entity" || data.target === "event"
+                    ? data.target
+                    : undefined,
+            });
+        }
+        if (summaries.length === 0) {
+            return {
+                source: "catalox",
+                catalogId,
+                summaries: [],
+                hint: `No entity descriptors in Catalox catalog "${catalogId}" for app ${client.appId}. Seed memorix-retrieval descriptors or set MEMORIX_ENTITY_NAMES.`,
+            };
+        }
+        return { source: "catalox", catalogId, summaries };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            source: "none",
+            catalogId,
+            summaries: [],
+            hint: `Catalox entity discovery failed: ${msg}`,
+        };
+    }
+}
+export async function loadMemorixEntityDescriptorByName(client, entityName) {
+    const discovery = await discoverMemorixEntities(client);
+    const match = discovery.summaries.find((s) => s.entityName === entityName) ??
+        discovery.summaries.find((s) => s.id === entityName);
+    const descriptorId = match?.id ?? entityName;
+    const { loadMemorixEntityDescriptor } = await import("./load-entity-descriptor.js");
+    return loadMemorixEntityDescriptor(client, descriptorId);
+}
+export function entityDescriptorConnections(entity) {
+    const connections = [];
+    for (const [relationKey, rel] of Object.entries(entity.relations ?? {})) {
+        connections.push({
+            id: `${entity.entityName}-${relationKey}`,
+            targetEntityName: rel.targetEntity,
+            relationType: rel.type,
+            sourceProperty: rel.source.path,
+            targetProperty: rel.target.path,
+        });
+    }
+    return connections;
+}
+export { validateMemorixEntityDescriptor };
+//# sourceMappingURL=discover-entities.js.map

package/dist/descriptors/discover-entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-entities.js","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"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"}

package/dist/explorer/entity-graph.d.ts

@@ -0,0 +1,59 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type MemorixEntityGraphConnection = {
+    id: string;
+    targetEntityName: string;
+    relationType: string;
+    sourceProperty: string;
+    targetProperty: string;
+};
+export type MemorixEntityGraphEntity = {
+    entityName: string;
+    label: string;
+    count: number;
+    narratives: Array<{
+        id: string;
+        title: string;
+    }>;
+    connections: MemorixEntityGraphConnection[];
+    connectedEntityTypes: number;
+    contentTypesWithData: number;
+    drillable: boolean;
+    countErrors?: {
+        scoped?: string;
+        narratives?: string;
+        contentTypes?: string;
+    };
+};
+export type MemorixEntityGraphDiscovery = {
+    source: "env" | "catalox" | "none";
+    memorixDb: string;
+    scopedNamespace: string | null;
+    entitiesCatalogId: string;
+    cataloxAppId: string;
+    cataloxClient: boolean;
+    hint?: string;
+};
+export type MemorixEntityGraphResult = {
+    memorixDb: string;
+    entities: MemorixEntityGraphEntity[];
+    discovery: MemorixEntityGraphDiscovery;
+};
+export type BuildMemorixEntityGraphOptions = {
+    scopedNamespace?: string | null;
+};
+export declare function buildMemorixEntityGraph(client: MemorixRetrievalClient, options?: BuildMemorixEntityGraphOptions): Promise<MemorixEntityGraphResult>;
+export type MemorixEntitySlicesResult = {
+    entityName: string;
+    slices: Array<{
+        contentType: string;
+        label: string;
+        count: number;
+        step: number;
+    }>;
+    sliceCountFailures?: Array<{
+        contentType: string;
+        error: string;
+    }>;
+};
+export declare function buildMemorixEntitySlices(client: MemorixRetrievalClient, entityName: string): Promise<MemorixEntitySlicesResult>;
+//# sourceMappingURL=entity-graph.d.ts.map

package/dist/explorer/entity-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-graph.d.ts","sourceRoot":"","sources":["../../src/explorer/entity-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAcjE,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,SAAS,EAAE,2BAA2B,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAoBF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,CA+GnC;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CA+BpC"}