@x12i/memorix-retrieval 1.1.0 → 1.2.0

package/dist/explorer/entity-graph.js

@@ -0,0 +1,151 @@
+import { discoverMemorixEntities, entityDescriptorConnections, loadMemorixEntityDescriptorByName, } from "../descriptors/discover-entities.js";
+import { listEntityContentTypeKeys, memorixContentTypeLabel, primaryEntityContentType, } from "../descriptors/content-type-labels.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+import { countMemorixEntityContentTypeDocuments } from "./raw-reads.js";
+function resolveScopedNamespace(client, override) {
+    if (override !== undefined)
+        return override;
+    const env = client.processEnv;
+    return (env.MEMORIX_SCOPED_NAMESPACE?.trim() ||
+        env.TARGET_NAMESPACE?.trim() ||
+        env.XMEMORY_NAMESPACE?.trim() ||
+        null);
+}
+function errMsg(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export async function buildMemorixEntityGraph(client, options = {}) {
+    const discoveryResult = await discoverMemorixEntities(client);
+    const scopedNamespace = resolveScopedNamespace(client, options.scopedNamespace);
+    const cataloxClient = Boolean(client.catalox.listCatalogItems);
+    const discovery = {
+        source: discoveryResult.source,
+        memorixDb: "",
+        scopedNamespace,
+        entitiesCatalogId: discoveryResult.catalogId,
+        cataloxAppId: client.appId,
+        cataloxClient,
+        hint: discoveryResult.hint,
+    };
+    const entities = [];
+    let memorixDb = "";
+    for (const summary of discoveryResult.summaries) {
+        let entity;
+        try {
+            entity = await loadMemorixEntityDescriptorByName(client, summary.entityName);
+        }
+        catch (e) {
+            entities.push({
+                entityName: summary.entityName,
+                label: summary.label,
+                count: 0,
+                narratives: [],
+                connections: [],
+                connectedEntityTypes: 0,
+                contentTypesWithData: 0,
+                drillable: false,
+                countErrors: { contentTypes: errMsg(e) },
+            });
+            continue;
+        }
+        if (!memorixDb) {
+            memorixDb = resolveMemorixDbNameForEntity(entity, client);
+        }
+        const primaryType = primaryEntityContentType(entity);
+        const contentTypes = listEntityContentTypeKeys(entity);
+        const countErrors = {};
+        let primaryCount = 0;
+        let narrativesCount = 0;
+        let contentTypesWithData = 0;
+        const contentTypeCountErrors = [];
+        try {
+            primaryCount = await countMemorixEntityContentTypeDocuments(client, {
+                entityName: summary.entityName,
+                contentType: primaryType,
+            });
+        }
+        catch (e) {
+            countErrors.scoped = errMsg(e);
+        }
+        if (entity.contentTypes.narratives) {
+            try {
+                narrativesCount = await countMemorixEntityContentTypeDocuments(client, {
+                    entityName: summary.entityName,
+                    contentType: "narratives",
+                });
+            }
+            catch (e) {
+                countErrors.narratives = errMsg(e);
+            }
+        }
+        for (const contentType of contentTypes) {
+            try {
+                const ctCount = await countMemorixEntityContentTypeDocuments(client, {
+                    entityName: summary.entityName,
+                    contentType,
+                });
+                if (ctCount > 0)
+                    contentTypesWithData += 1;
+            }
+            catch (e) {
+                contentTypeCountErrors.push(`${contentType}: ${errMsg(e)}`);
+            }
+        }
+        if (contentTypeCountErrors.length) {
+            countErrors.contentTypes = contentTypeCountErrors.join("; ");
+        }
+        const connections = entityDescriptorConnections(entity);
+        const narrativeRefs = narrativesCount > 0
+            ? [{ id: "memorix:narratives", title: "Memorix narratives collection" }]
+            : [];
+        entities.push({
+            entityName: summary.entityName,
+            label: summary.label,
+            count: primaryCount,
+            narratives: narrativeRefs,
+            connections,
+            connectedEntityTypes: new Set(connections.map((c) => c.targetEntityName)).size,
+            contentTypesWithData,
+            drillable: primaryCount > 0 || narrativeRefs.length > 0,
+            ...(Object.keys(countErrors).length ? { countErrors } : {}),
+        });
+    }
+    discovery.memorixDb = memorixDb;
+    return {
+        memorixDb,
+        entities,
+        discovery,
+    };
+}
+export async function buildMemorixEntitySlices(client, entityName) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    const contentTypes = listEntityContentTypeKeys(entity);
+    const slices = [];
+    const sliceCountFailures = [];
+    let step = 0;
+    for (const contentType of contentTypes) {
+        try {
+            const count = await countMemorixEntityContentTypeDocuments(client, {
+                entityName,
+                contentType,
+            });
+            if (count > 0) {
+                slices.push({
+                    contentType,
+                    label: memorixContentTypeLabel(contentType),
+                    count,
+                    step: step++,
+                });
+            }
+        }
+        catch (e) {
+            sliceCountFailures.push({ contentType, error: errMsg(e) });
+        }
+    }
+    return {
+        entityName,
+        slices,
+        ...(sliceCountFailures.length ? { sliceCountFailures } : {}),
+    };
+}
+//# sourceMappingURL=entity-graph.js.map

package/dist/explorer/entity-graph.js.map

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

package/dist/explorer/health.d.ts

@@ -0,0 +1,14 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type MemorixRetrievalHealth = {
+    ok: boolean;
+    memorixDb: string | null;
+    mongoUriConfigured: boolean;
+    pingMs?: number;
+    discoverySample: string[];
+    cataloxAppId: string;
+    entitiesCatalogId: string;
+    discoverySource: string;
+    error?: string;
+};
+export declare function getMemorixRetrievalHealth(client: MemorixRetrievalClient): Promise<MemorixRetrievalHealth>;
+//# sourceMappingURL=health.d.ts.map

package/dist/explorer/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/explorer/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}

package/dist/explorer/health.js

@@ -0,0 +1,70 @@
+import { discoverMemorixEntities } from "../descriptors/discover-entities.js";
+import { resolveMongoUri } from "../mongo/env.js";
+export async function getMemorixRetrievalHealth(client) {
+    const discovery = await discoverMemorixEntities(client);
+    const discoverySample = discovery.summaries
+        .slice(0, 16)
+        .map((s) => s.entityName);
+    let mongoUriConfigured = false;
+    try {
+        resolveMongoUri(client.processEnv);
+        mongoUriConfigured = true;
+    }
+    catch {
+        mongoUriConfigured = false;
+    }
+    if (!client.getMongo) {
+        return {
+            ok: discovery.summaries.length > 0,
+            memorixDb: null,
+            mongoUriConfigured,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            error: discovery.hint,
+        };
+    }
+    const started = Date.now();
+    try {
+        const mongo = await client.getMongo();
+        await mongo.db().admin().ping();
+        const pingMs = Date.now() - started;
+        let memorixDb = null;
+        if (discovery.summaries[0]) {
+            const { loadMemorixEntityDescriptorByName } = await import("../descriptors/discover-entities.js");
+            const { resolveMemorixDbNameForEntity } = await import("../mongo/resolve-db.js");
+            try {
+                const entity = await loadMemorixEntityDescriptorByName(client, discovery.summaries[0].entityName);
+                memorixDb = resolveMemorixDbNameForEntity(entity, client);
+            }
+            catch {
+                memorixDb = null;
+            }
+        }
+        return {
+            ok: true,
+            memorixDb,
+            mongoUriConfigured,
+            pingMs,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            ...(discovery.hint ? { error: discovery.hint } : {}),
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            memorixDb: null,
+            mongoUriConfigured,
+            discoverySample,
+            cataloxAppId: client.appId,
+            entitiesCatalogId: discovery.catalogId,
+            discoverySource: discovery.source,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/explorer/health.js.map

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

package/dist/explorer/raw-reads.d.ts

@@ -0,0 +1,25 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import { mergeMemorixMongoFilters, resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson } from "../data/record-id.js";
+export type RawMemorixEntityReadParams = {
+    entityName: string;
+    contentType: string;
+    filter?: Record<string, unknown>;
+    searchText?: string;
+    sort?: Record<string, 1 | -1>;
+    skip?: number;
+    limit?: number;
+    includeTotal?: boolean;
+};
+export type RawMemorixEntityListResult = {
+    documents: Record<string, unknown>[];
+    total?: number;
+};
+export declare function countMemorixEntityContentTypeDocuments(client: MemorixRetrievalClient, params: Pick<RawMemorixEntityReadParams, "entityName" | "contentType" | "filter" | "searchText">): Promise<number>;
+export declare function listMemorixEntityContentTypeDocuments(client: MemorixRetrievalClient, params: RawMemorixEntityReadParams): Promise<RawMemorixEntityListResult>;
+export declare function getMemorixEntityContentTypeDocument(client: MemorixRetrievalClient, params: {
+    entityName: string;
+    contentType: string;
+    recordId: string;
+}): Promise<Record<string, unknown> | null>;
+export { resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson, mergeMemorixMongoFilters, };
+//# sourceMappingURL=raw-reads.d.ts.map

package/dist/explorer/raw-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-reads.d.ts","sourceRoot":"","sources":["../../src/explorer/raw-reads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAEL,wBAAwB,EACxB,4BAA4B,EAC5B,+BAA+B,EAChC,MAAM,sBAAsB,CAAC;AAO9B,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AA+BF,wBAAsB,sCAAsC,CAC1D,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,IAAI,CACV,0BAA0B,EAC1B,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,YAAY,CACvD,GACA,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,qCAAqC,CACzD,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA4CrC;AAED,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAezC;AAED,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,GACzB,CAAC"}

package/dist/explorer/raw-reads.js

@@ -0,0 +1,78 @@
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { memorixLabelSearchFilter, mergeMemorixMongoFilters, resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson, } from "../data/record-id.js";
+import { loadMemorixEntityDescriptorByName } from "../descriptors/discover-entities.js";
+import { memorixRead } from "../data/memorix-read.js";
+import { countMemorixCollection } from "../mongo/read-collection.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+async function resolveEntityAndCollection(client, entityName, contentType) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    if (!entity.contentTypes[contentType]) {
+        throw new Error(`Unknown content type "${contentType}" for entity "${entityName}"`);
+    }
+    const collection = resolveMemorixCollectionName(entity, contentType, client.processEnv);
+    return { entity, collection };
+}
+function buildQuery(searchText, extraFilter) {
+    return mergeMemorixMongoFilters(memorixLabelSearchFilter(searchText), extraFilter);
+}
+export async function countMemorixEntityContentTypeDocuments(client, params) {
+    const { entity, collection } = await resolveEntityAndCollection(client, params.entityName, params.contentType);
+    const query = buildQuery(params.searchText, params.filter);
+    if (!client.getMongo) {
+        throw new Error("countMemorixEntityContentTypeDocuments requires Mongo access");
+    }
+    const mongo = await client.getMongo();
+    const db = resolveMemorixDbNameForEntity(entity, client);
+    return countMemorixCollection(mongo, { db, collection, query });
+}
+export async function listMemorixEntityContentTypeDocuments(client, params) {
+    const { entity, collection } = await resolveEntityAndCollection(client, params.entityName, params.contentType);
+    const query = buildQuery(params.searchText, params.filter);
+    const skip = Math.max(0, params.skip ?? 0);
+    const limit = Math.min(client.defaults.maxPageLimit, Math.max(1, params.limit ?? 50));
+    if (params.includeTotal && client.getMongo) {
+        const mongo = await client.getMongo();
+        const db = resolveMemorixDbNameForEntity(entity, client);
+        const [documents, total] = await Promise.all([
+            memorixRead(client, {
+                entity,
+                source: collection,
+                query,
+                sort: params.sort,
+                skip,
+                limit,
+            }),
+            countMemorixCollection(mongo, { db, collection, query }),
+        ]);
+        return {
+            documents: documents.map((d) => serializeMemorixDocumentForJson(d)),
+            total,
+        };
+    }
+    const documents = await memorixRead(client, {
+        entity,
+        source: collection,
+        query,
+        sort: params.sort,
+        skip,
+        limit,
+    });
+    return {
+        documents: documents.map((d) => serializeMemorixDocumentForJson(d)),
+    };
+}
+export async function getMemorixEntityContentTypeDocument(client, params) {
+    const { entity, collection } = await resolveEntityAndCollection(client, params.entityName, params.contentType);
+    const filter = resolveMemorixRecordIdFilter(params.recordId);
+    const docs = await memorixRead(client, {
+        entity,
+        source: collection,
+        query: filter,
+        limit: 1,
+    });
+    if (!docs.length)
+        return null;
+    return serializeMemorixDocumentForJson(docs[0]);
+}
+export { resolveMemorixRecordIdFilter, serializeMemorixDocumentForJson, mergeMemorixMongoFilters, };
+//# sourceMappingURL=raw-reads.js.map

package/dist/explorer/raw-reads.js.map

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

package/dist/explorer/scoped-workspace.d.ts

@@ -0,0 +1,24 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type ScopedWorkspaceOptions = {
+    namespace?: string;
+    namespaceFieldPaths?: readonly string[];
+    searchText?: string;
+    skip?: number;
+    limit?: number;
+    includeTotal?: boolean;
+};
+export declare function resolveScopedWorkspaceNamespace(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function resolveScopedNamespaceFieldPaths(env?: NodeJS.ProcessEnv): readonly string[];
+export declare function listScopedWorkspaceEntityTypes(client: MemorixRetrievalClient, options?: Pick<ScopedWorkspaceOptions, "namespace" | "namespaceFieldPaths">): Promise<{
+    generatedAt: string;
+    entityTypes: Array<{
+        typeKey: string;
+        docCount: number;
+    }>;
+}>;
+export declare function listScopedWorkspaceDocuments(client: MemorixRetrievalClient, options?: ScopedWorkspaceOptions): Promise<{
+    documents: Record<string, unknown>[];
+    total?: number;
+}>;
+export declare function countScopedWorkspaceDocuments(client: MemorixRetrievalClient, options?: Pick<ScopedWorkspaceOptions, "namespace" | "namespaceFieldPaths" | "searchText">): Promise<number>;
+//# sourceMappingURL=scoped-workspace.d.ts.map

package/dist/explorer/scoped-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-workspace.d.ts","sourceRoot":"","sources":["../../src/explorer/scoped-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAgBjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAQF,wBAAgB,+BAA+B,CAC7C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,SAAS,MAAM,EAAE,CAMnB;AAoCD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,qBAAqB,CAAM,GAC9E,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D,CAAC,CAsDD;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAuHnE;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,IAAI,CACX,sBAAsB,EACtB,WAAW,GAAG,qBAAqB,GAAG,YAAY,CAC9C,GACL,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

package/dist/explorer/scoped-workspace.js

@@ -0,0 +1,217 @@
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { memorixLabelSearchFilter, mergeMemorixMongoFilters, serializeMemorixDocumentForJson, } from "../data/record-id.js";
+import { discoverMemorixEntities, loadMemorixEntityDescriptorByName, } from "../descriptors/discover-entities.js";
+import { primaryEntityContentType } from "../descriptors/content-type-labels.js";
+import { memorixRead } from "../data/memorix-read.js";
+import { countMemorixCollection } from "../mongo/read-collection.js";
+import { resolveMemorixDbNameForEntity } from "../mongo/resolve-db.js";
+const DEFAULT_NAMESPACE_FIELD_PATHS = [
+    "namespace",
+    "xmemory.namespace",
+    "sourceDatabase",
+];
+export function resolveScopedWorkspaceNamespace(env = process.env) {
+    return (env.MEMORIX_SCOPED_NAMESPACE?.trim() ||
+        env.TARGET_NAMESPACE?.trim() ||
+        env.XMEMORY_NAMESPACE?.trim() ||
+        undefined);
+}
+export function resolveScopedNamespaceFieldPaths(env = process.env) {
+    const fromEnv = env.MEMORIX_SCOPED_NAMESPACE_FIELDS?.trim();
+    if (fromEnv) {
+        return fromEnv.split(/[,;\s]+/).map((s) => s.trim()).filter(Boolean);
+    }
+    return DEFAULT_NAMESPACE_FIELD_PATHS;
+}
+function namespaceFilter(namespace, fieldPaths) {
+    const or = fieldPaths.map((path) => ({ [path]: namespace }));
+    return or.length === 1 ? or[0] : { $or: or };
+}
+async function scopedQueryForEntity(client, entityName, namespace, fieldPaths, searchText) {
+    const entity = await loadMemorixEntityDescriptorByName(client, entityName);
+    const contentType = primaryEntityContentType(entity);
+    if (!entity.contentTypes[contentType])
+        return null;
+    const collection = resolveMemorixCollectionName(entity, contentType, client.processEnv);
+    const query = mergeMemorixMongoFilters(namespaceFilter(namespace, fieldPaths), memorixLabelSearchFilter(searchText));
+    return { entity, collection, query };
+}
+export async function listScopedWorkspaceEntityTypes(client, options = {}) {
+    const namespace = options.namespace ?? resolveScopedWorkspaceNamespace(client.processEnv);
+    if (!namespace) {
+        throw new Error("Scoped workspace requires MEMORIX_SCOPED_NAMESPACE, TARGET_NAMESPACE, or XMEMORY_NAMESPACE");
+    }
+    const fieldPaths = options.namespaceFieldPaths ??
+        resolveScopedNamespaceFieldPaths(client.processEnv);
+    const discovery = await discoverMemorixEntities(client);
+    const entityTypes = [];
+    for (const summary of discovery.summaries) {
+        try {
+            const scoped = await scopedQueryForEntity(client, summary.entityName, namespace, fieldPaths);
+            if (!scoped)
+                continue;
+            let count = 0;
+            if (client.getMongo) {
+                const mongo = await client.getMongo();
+                const db = resolveMemorixDbNameForEntity(scoped.entity, client);
+                count = await countMemorixCollection(mongo, {
+                    db,
+                    collection: scoped.collection,
+                    query: scoped.query,
+                });
+            }
+            else {
+                const rows = await memorixRead(client, {
+                    entity: scoped.entity,
+                    source: scoped.collection,
+                    query: scoped.query,
+                    limit: 0,
+                });
+                count = rows.length;
+            }
+            if (count > 0) {
+                entityTypes.push({ typeKey: summary.entityName, docCount: count });
+            }
+        }
+        catch {
+            /* skip entity on count failure */
+        }
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        entityTypes,
+    };
+}
+export async function listScopedWorkspaceDocuments(client, options = {}) {
+    const namespace = options.namespace ?? resolveScopedWorkspaceNamespace(client.processEnv);
+    if (!namespace) {
+        throw new Error("Scoped workspace requires MEMORIX_SCOPED_NAMESPACE, TARGET_NAMESPACE, or XMEMORY_NAMESPACE");
+    }
+    const fieldPaths = options.namespaceFieldPaths ??
+        resolveScopedNamespaceFieldPaths(client.processEnv);
+    const skip = Math.max(0, options.skip ?? 0);
+    const limit = Math.min(client.defaults.maxPageLimit, Math.max(1, options.limit ?? 50));
+    const discovery = await discoverMemorixEntities(client);
+    const documents = [];
+    let remainingSkip = skip;
+    let remainingLimit = limit;
+    for (const summary of discovery.summaries) {
+        if (remainingLimit <= 0)
+            break;
+        const scoped = await scopedQueryForEntity(client, summary.entityName, namespace, fieldPaths, options.searchText);
+        if (!scoped)
+            continue;
+        if (options.includeTotal && client.getMongo) {
+            continue;
+        }
+        const rows = await memorixRead(client, {
+            entity: scoped.entity,
+            source: scoped.collection,
+            query: scoped.query,
+            sort: { _id: -1 },
+            skip: remainingSkip,
+            limit: remainingLimit,
+        });
+        if (rows.length === 0) {
+            if (remainingSkip > 0) {
+                let entityCount = 0;
+                if (client.getMongo) {
+                    const mongo = await client.getMongo();
+                    const db = resolveMemorixDbNameForEntity(scoped.entity, client);
+                    entityCount = await countMemorixCollection(mongo, {
+                        db,
+                        collection: scoped.collection,
+                        query: scoped.query,
+                    });
+                }
+                if (entityCount <= remainingSkip) {
+                    remainingSkip -= entityCount;
+                    continue;
+                }
+                remainingSkip = 0;
+                const retryRows = await memorixRead(client, {
+                    entity: scoped.entity,
+                    source: scoped.collection,
+                    query: scoped.query,
+                    sort: { _id: -1 },
+                    skip: 0,
+                    limit: remainingLimit,
+                });
+                for (const row of retryRows) {
+                    documents.push({
+                        entityName: summary.entityName,
+                        contentType: primaryEntityContentType(scoped.entity),
+                        ...serializeMemorixDocumentForJson(row),
+                    });
+                    remainingLimit -= 1;
+                    if (remainingLimit <= 0)
+                        break;
+                }
+            }
+            continue;
+        }
+        for (const row of rows) {
+            documents.push({
+                entityName: summary.entityName,
+                contentType: primaryEntityContentType(scoped.entity),
+                ...serializeMemorixDocumentForJson(row),
+            });
+            remainingLimit -= 1;
+            if (remainingLimit <= 0)
+                break;
+        }
+        remainingSkip = 0;
+    }
+    if (options.includeTotal && client.getMongo) {
+        let total = 0;
+        for (const summary of discovery.summaries) {
+            const scoped = await scopedQueryForEntity(client, summary.entityName, namespace, fieldPaths, options.searchText);
+            if (!scoped)
+                continue;
+            const mongo = await client.getMongo();
+            const db = resolveMemorixDbNameForEntity(scoped.entity, client);
+            total += await countMemorixCollection(mongo, {
+                db,
+                collection: scoped.collection,
+                query: scoped.query,
+            });
+        }
+        return { documents, total };
+    }
+    return { documents };
+}
+export async function countScopedWorkspaceDocuments(client, options = {}) {
+    const namespace = options.namespace ?? resolveScopedWorkspaceNamespace(client.processEnv);
+    if (!namespace) {
+        throw new Error("Scoped workspace requires MEMORIX_SCOPED_NAMESPACE, TARGET_NAMESPACE, or XMEMORY_NAMESPACE");
+    }
+    const fieldPaths = options.namespaceFieldPaths ??
+        resolveScopedNamespaceFieldPaths(client.processEnv);
+    const discovery = await discoverMemorixEntities(client);
+    let total = 0;
+    for (const summary of discovery.summaries) {
+        const scoped = await scopedQueryForEntity(client, summary.entityName, namespace, fieldPaths, options.searchText);
+        if (!scoped)
+            continue;
+        if (client.getMongo) {
+            const mongo = await client.getMongo();
+            const db = resolveMemorixDbNameForEntity(scoped.entity, client);
+            total += await countMemorixCollection(mongo, {
+                db,
+                collection: scoped.collection,
+                query: scoped.query,
+            });
+        }
+        else {
+            const rows = await memorixRead(client, {
+                entity: scoped.entity,
+                source: scoped.collection,
+                query: scoped.query,
+                limit: 0,
+            });
+            total += rows.length;
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=scoped-workspace.js.map

package/dist/explorer/scoped-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-workspace.js","sourceRoot":"","sources":["../../src/explorer/scoped-workspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,iCAAiC,GAClC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAWvE,MAAM,6BAA6B,GAAG;IACpC,WAAW;IACX,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAEX,MAAM,UAAU,+BAA+B,CAC7C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,CACL,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE;QACpC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE;QAC5B,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE;QAC7B,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,GAAG,CAAC,+BAA+B,EAAE,IAAI,EAAE,CAAC;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,6BAA6B,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CACtB,SAAiB,EACjB,UAA6B;IAE7B,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7D,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,KAAK,UAAU,oBAAoB,CACjC,MAA8B,EAC9B,UAAkB,EAClB,SAAiB,EACjB,UAA6B,EAC7B,UAAmB;IAMnB,MAAM,MAAM,GAAG,MAAM,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,UAAU,GAAG,4BAA4B,CAC7C,MAAM,EACN,WAAW,EACX,MAAM,CAAC,UAAU,CAClB,CAAC;IACF,MAAM,KAAK,GAAG,wBAAwB,CACpC,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,EACtC,wBAAwB,CAAC,UAAU,CAAC,CACrC,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAA8B,EAC9B,UAA6E,EAAE;IAK/E,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,OAAO,CAAC,mBAAmB;QAC3B,gCAAgC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtD,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,WAAW,GAAiD,EAAE,CAAC;IAErE,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,EACN,OAAO,CAAC,UAAU,EAClB,SAAS,EACT,UAAU,CACX,CAAC;YACF,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,MAAM,EAAE,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAChE,KAAK,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE;oBAC1C,EAAE;oBACF,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;oBACrC,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,UAAU;oBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,KAAK,EAAE,CAAC;iBACT,CAAC,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACtB,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAA8B,EAC9B,UAAkC,EAAE;IAEpC,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,OAAO,CAAC,mBAAmB;QAC3B,gCAAgC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,QAAQ,CAAC,YAAY,EAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CACjC,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,SAAS,GAA8B,EAAE,CAAC;IAChD,IAAI,aAAa,GAAG,IAAI,CAAC;IACzB,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,IAAI,cAAc,IAAI,CAAC;YAAE,MAAM;QAC/B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,EACN,OAAO,CAAC,UAAU,EAClB,SAAS,EACT,UAAU,EACV,OAAO,CAAC,UAAU,CACnB,CAAC;QACF,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,UAAU;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;YACjB,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,WAAW,GAAG,CAAC,CAAC;gBACpB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,MAAM,EAAE,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAChE,WAAW,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE;wBAChD,EAAE;wBACF,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;qBACpB,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;oBACjC,aAAa,IAAI,WAAW,CAAC;oBAC7B,SAAS;gBACX,CAAC;gBACD,aAAa,GAAG,CAAC,CAAC;gBAClB,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;oBAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,UAAU;oBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;oBACjB,IAAI,EAAE,CAAC;oBACP,KAAK,EAAE,cAAc;iBACtB,CAAC,CAAC;gBACH,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,SAAS,CAAC,IAAI,CAAC;wBACb,UAAU,EAAE,OAAO,CAAC,UAAU;wBAC9B,WAAW,EAAE,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC;wBACpD,GAAG,+BAA+B,CAAC,GAAG,CAAC;qBACxC,CAAC,CAAC;oBACH,cAAc,IAAI,CAAC,CAAC;oBACpB,IAAI,cAAc,IAAI,CAAC;wBAAE,MAAM;gBACjC,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC;gBACb,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC;gBACpD,GAAG,+BAA+B,CAAC,GAAG,CAAC;aACxC,CAAC,CAAC;YACH,cAAc,IAAI,CAAC,CAAC;YACpB,IAAI,cAAc,IAAI,CAAC;gBAAE,MAAM;QACjC,CAAC;QACD,aAAa,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,EACN,OAAO,CAAC,UAAU,EAClB,SAAS,EACT,UAAU,EACV,OAAO,CAAC,UAAU,CACnB,CAAC;YACF,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChE,KAAK,IAAI,MAAM,sBAAsB,CAAC,KAAK,EAAE;gBAC3C,EAAE;gBACF,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAA8B,EAC9B,UAGI,EAAE;IAEN,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,OAAO,CAAC,mBAAmB;QAC3B,gCAAgC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAEtD,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,EACN,OAAO,CAAC,UAAU,EAClB,SAAS,EACT,UAAU,EACV,OAAO,CAAC,UAAU,CACnB,CAAC;QACF,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,6BAA6B,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChE,KAAK,IAAI,MAAM,sBAAsB,CAAC,KAAK,EAAE;gBAC3C,EAAE;gBACF,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;gBACrC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,UAAU;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}