@x12i/memorix-hippox 1.0.0

package/README.md

@@ -0,0 +1,96 @@
+# @x12i/memorix-hippox
+
+Memorix Hippox stores reusable contextual links between Memorix object types. Operators can define property-based joins without pre-modeled schema relations, simulate match quality on sampled data, approve links into long-term memory, and resolve bounded context into `jobMemory.context`.
+
+## Database
+
+Approved and draft links persist in Mongo database **`memorix-hippox`** (collection **`context-links`** by default).
+
+| Variable | Default |
+|----------|---------|
+| `MEMORIX_HIPPOX_DB` | `memorix-hippox` |
+| `MEMORIX_HIPPOX_COLLECTION` | `context-links` |
+| `MEMORIX_HIPPOX_SIMULATION_LIMIT` | `1000` |
+| `MEMORIX_HIPPOX_SIMULATION_EXAMPLES_LIMIT` | `25` |
+| `MEMORIX_CONTEXT_LIST_LIMIT` | `25` |
+
+## Example: assets → subnets (record context)
+
+```json
+{
+  "sourceObjectType": "assets",
+  "targetObjectType": "subnets",
+  "direction": "downstream",
+  "join": [
+    { "sourcePath": "data.subnetId", "targetPath": "data.id", "operator": "eq" }
+  ],
+  "retrieval": { "type": "record", "outputMode": "data" }
+}
+```
+
+Resolved output:
+
+```json
+{
+  "jobMemory": {
+    "context": {
+      "subnets": {
+        "cidr": "10.0.0.0/24",
+        "region": "eu-west-1"
+      }
+    }
+  }
+}
+```
+
+## HTTP routes
+
+When mounted through `memorix-schema-api`:
+
+| Method | Path | Purpose |
+|--------|------|---------|
+| `GET` | `/api/hippox/links?sourceObjectType=assets` | List draft + approved links |
+| `POST` | `/api/hippox/links` | Create draft link |
+| `POST` | `/api/hippox/links/simulate` | Simulate unsaved definition |
+| `POST` | `/api/hippox/links/:id/simulate` | Simulate + persist summary |
+| `POST` | `/api/hippox/links/:id/approve` | Approve simulated link |
+| `POST` | `/api/hippox/context/resolve` | Resolve runtime context |
+
+## Programmatic usage
+
+```ts
+import { createMemorixRetrievalStackFromEnv } from '@x12i/memorix-retrieval';
+import { HippoxService } from '@x12i/memorix-hippox';
+
+const { client } = await createMemorixRetrievalStackFromEnv();
+const hippox = await HippoxService.create({ retrieval: client });
+
+const draft = await hippox.createDraftLink({
+  sourceObjectType: 'assets',
+  targetObjectType: 'subnets',
+  direction: 'downstream',
+  join: [{ sourcePath: 'data.subnetId', targetPath: 'data.id' }],
+  retrieval: { type: 'record', outputMode: 'data' },
+});
+
+const { simulation } = await hippox.simulateAndPersist(draft.id);
+await hippox.approveLink(draft.id);
+
+const resolved = await hippox.resolveContextInput({
+  sourceObjectType: 'assets',
+  sourceRecordId: 'asset-123',
+  linkIds: [draft.id],
+});
+```
+
+## Legacy relation links
+
+Use `resolveMixedContext()` to resolve Hippox links and legacy `JobContextLink` relation-based links during migration. Legacy output is returned under `legacy` while Hippox context uses object-type keys.
+
+## Retrieval types
+
+- **record** — single best match (default latest `data.scopedAt`)
+- **list** — bounded array (mandatory limit)
+- **aggregate** — flat per-property value counts
+
+Output modes: `data` (default), `record`, `dataWithRecordId`.

package/dist/collection-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { ObjectTypeCollectionBinding } from './types.js';
+export declare function resolveObjectTypeCollection(retrieval: MemorixRetrievalClient, objectType: string, contentType?: string): Promise<ObjectTypeCollectionBinding>;
+export declare function readObjectTypeDocuments(retrieval: MemorixRetrievalClient, binding: ObjectTypeCollectionBinding, params?: {
+    query?: Record<string, unknown>;
+    limit?: number;
+    skip?: number;
+    sort?: Record<string, 1 | -1>;
+}): Promise<Record<string, unknown>[]>;
+export declare function countObjectTypeDocuments(retrieval: MemorixRetrievalClient, binding: ObjectTypeCollectionBinding, query?: Record<string, unknown>): Promise<number>;
+export declare function loadSourceRecord(retrieval: MemorixRetrievalClient, objectType: string, params: {
+    recordId?: string;
+    record?: Record<string, unknown>;
+    contentType?: string;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=collection-resolver.d.ts.map

package/dist/collection-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-resolver.d.ts","sourceRoot":"","sources":["../src/collection-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAQtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAmC9D,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,sBAAsB,EACjC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,2BAA2B,CAAC,CAYtC;AASD,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,2BAA2B,EACpC,MAAM,GAAE;IACN,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1B,GACL,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAiBpC;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,2BAA2B,EACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CASjB;AA6BD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC"}

package/dist/collection-resolver.js

@@ -0,0 +1,121 @@
+import { resolveDefaultListDescriptorForEntity } from '@x12i/memorix-retrieval';
+import { listLiveEntityCollections, readEntityCollectionDocuments, countEntityCollectionDocuments, } from '@x12i/memorix-mongo';
+async function resolveEntityBinding(retrieval, objectType) {
+    const { entity } = await resolveDefaultListDescriptorForEntity(retrieval, objectType);
+    const target = entity.target === 'event' || entity.target === 'knowledge' ? 'event' : 'entity';
+    return {
+        entityName: objectType,
+        collectionPrefix: String(entity.collectionPrefix ?? objectType),
+        target,
+    };
+}
+async function resolveLeadContentType(retrieval, objectType, explicit) {
+    if (explicit?.trim())
+        return explicit.trim();
+    const { entity } = await resolveDefaultListDescriptorForEntity(retrieval, objectType);
+    const canonical = entity.defaults?.canonicalContentType
+        ?? Object.entries(entity.contentTypes ?? {}).find(([, ct]) => ct.isCanonical)?.[0]
+        ?? Object.keys(entity.contentTypes ?? {})[0];
+    if (canonical)
+        return canonical;
+    const binding = await resolveEntityBinding(retrieval, objectType);
+    const live = await listLiveEntityCollections(retrieval, binding);
+    if (live.length > 0)
+        return live[0].contentType;
+    return 'snapshots';
+}
+export async function resolveObjectTypeCollection(retrieval, objectType, contentType) {
+    const binding = await resolveEntityBinding(retrieval, objectType);
+    const resolvedContentType = await resolveLeadContentType(retrieval, objectType, contentType);
+    const live = await listLiveEntityCollections(retrieval, binding);
+    const match = live.find((row) => row.contentType === resolvedContentType);
+    const collectionName = match?.collectionName ?? `${binding.collectionPrefix}-${resolvedContentType}`;
+    return {
+        objectType,
+        contentType: resolvedContentType,
+        collectionName,
+        target: binding.target === 'event' || binding.target === 'knowledge' ? binding.target : 'entity',
+    };
+}
+async function entityBindingForObjectType(retrieval, binding) {
+    return resolveEntityBinding(retrieval, binding.objectType);
+}
+export async function readObjectTypeDocuments(retrieval, binding, params = {}) {
+    const entityBinding = await entityBindingForObjectType(retrieval, binding);
+    const result = await readEntityCollectionDocuments({
+        retrieval,
+        binding: entityBinding,
+        contentType: binding.contentType,
+        query: params.query,
+        limit: params.limit,
+        skip: params.skip,
+    });
+    let docs = result.documents;
+    if (params.sort && Object.keys(params.sort).length > 0) {
+        docs = [...docs].sort((a, b) => compareBySort(a, b, params.sort));
+    }
+    return docs;
+}
+export async function countObjectTypeDocuments(retrieval, binding, query) {
+    const entityBinding = await entityBindingForObjectType(retrieval, binding);
+    const result = await countEntityCollectionDocuments({
+        retrieval,
+        binding: entityBinding,
+        contentType: binding.contentType,
+        query,
+    });
+    return result.total;
+}
+function compareBySort(a, b, sort) {
+    for (const [path, direction] of Object.entries(sort)) {
+        const av = readNested(a, path);
+        const bv = readNested(b, path);
+        if (av === bv)
+            continue;
+        if (av === undefined || av === null)
+            return direction;
+        if (bv === undefined || bv === null)
+            return -direction;
+        if (av < bv)
+            return -direction;
+        if (av > bv)
+            return direction;
+    }
+    return 0;
+}
+function readNested(doc, path) {
+    if (!path.includes('.'))
+        return doc[path];
+    let current = doc;
+    for (const segment of path.split('.')) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+export async function loadSourceRecord(retrieval, objectType, params) {
+    if (params.record && typeof params.record === 'object') {
+        return params.record;
+    }
+    const recordId = params.recordId?.trim();
+    if (!recordId) {
+        throw new Error('sourceRecordId or sourceRecord payload is required');
+    }
+    const binding = await resolveObjectTypeCollection(retrieval, objectType, params.contentType);
+    const entityBinding = await entityBindingForObjectType(retrieval, binding);
+    const result = await readEntityCollectionDocuments({
+        retrieval,
+        binding: entityBinding,
+        contentType: binding.contentType,
+        query: {
+            $or: [{ _id: recordId }, { recordId }, { entityId: recordId }, { eventId: recordId }],
+        },
+        limit: 1,
+    });
+    const doc = result.documents[0];
+    if (!doc)
+        throw new Error(`source record not found: ${recordId}`);
+    return doc;
+}
+//# sourceMappingURL=collection-resolver.js.map

package/dist/collection-resolver.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+import type { HippoxConfig } from './types.js';
+declare const DEFAULT_HIPPOX_DB = "memorix-hippox";
+declare const DEFAULT_HIPPOX_COLLECTION = "context-links";
+declare const DEFAULT_SIMULATION_LIMIT = 1000;
+declare const DEFAULT_SIMULATION_EXAMPLES_LIMIT = 25;
+declare const DEFAULT_CONTEXT_LIST_LIMIT = 25;
+export declare function loadHippoxConfig(processEnv?: NodeJS.ProcessEnv): HippoxConfig;
+export { DEFAULT_HIPPOX_DB, DEFAULT_HIPPOX_COLLECTION, DEFAULT_SIMULATION_LIMIT, DEFAULT_SIMULATION_EXAMPLES_LIMIT, DEFAULT_CONTEXT_LIST_LIMIT, };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,QAAA,MAAM,iBAAiB,mBAAmB,CAAC;AAC3C,QAAA,MAAM,yBAAyB,kBAAkB,CAAC;AAClD,QAAA,MAAM,wBAAwB,OAAO,CAAC;AACtC,QAAA,MAAM,iCAAiC,KAAK,CAAC;AAC7C,QAAA,MAAM,0BAA0B,KAAK,CAAC;AAStC,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAW1F;AAED,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,GAC3B,CAAC"}

package/dist/config.js

@@ -0,0 +1,24 @@
+const DEFAULT_HIPPOX_DB = 'memorix-hippox';
+const DEFAULT_HIPPOX_COLLECTION = 'context-links';
+const DEFAULT_SIMULATION_LIMIT = 1000;
+const DEFAULT_SIMULATION_EXAMPLES_LIMIT = 25;
+const DEFAULT_CONTEXT_LIST_LIMIT = 25;
+function parsePositiveInt(raw, fallback) {
+    if (!raw?.trim())
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return Math.floor(n);
+}
+export function loadHippoxConfig(processEnv = process.env) {
+    return {
+        dbName: processEnv.MEMORIX_HIPPOX_DB?.trim() || DEFAULT_HIPPOX_DB,
+        collectionName: processEnv.MEMORIX_HIPPOX_COLLECTION?.trim() || DEFAULT_HIPPOX_COLLECTION,
+        simulationLimit: parsePositiveInt(processEnv.MEMORIX_HIPPOX_SIMULATION_LIMIT, DEFAULT_SIMULATION_LIMIT),
+        simulationExamplesLimit: parsePositiveInt(processEnv.MEMORIX_HIPPOX_SIMULATION_EXAMPLES_LIMIT, DEFAULT_SIMULATION_EXAMPLES_LIMIT),
+        contextListLimit: parsePositiveInt(processEnv.MEMORIX_CONTEXT_LIST_LIMIT, DEFAULT_CONTEXT_LIST_LIMIT),
+    };
+}
+export { DEFAULT_HIPPOX_DB, DEFAULT_HIPPOX_COLLECTION, DEFAULT_SIMULATION_LIMIT, DEFAULT_SIMULATION_EXAMPLES_LIMIT, DEFAULT_CONTEXT_LIST_LIMIT, };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAC3C,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAClD,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AAC7C,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC,SAAS,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACjE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,aAAgC,OAAO,CAAC,GAAG;IAC1E,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,iBAAiB;QACjE,cAAc,EAAE,UAAU,CAAC,yBAAyB,EAAE,IAAI,EAAE,IAAI,yBAAyB;QACzF,eAAe,EAAE,gBAAgB,CAAC,UAAU,CAAC,+BAA+B,EAAE,wBAAwB,CAAC;QACvG,uBAAuB,EAAE,gBAAgB,CACvC,UAAU,CAAC,wCAAwC,EACnD,iCAAiC,CAClC;QACD,gBAAgB,EAAE,gBAAgB,CAAC,UAAU,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;KACtG,CAAC;AACJ,CAAC;AAED,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,GAC3B,CAAC"}

package/dist/filters.d.ts

@@ -0,0 +1,10 @@
+import type { FixedFilter, JoinMapping } from './types.js';
+export declare function compileFixedFilter(filter: FixedFilter, dateLike?: boolean): Record<string, unknown>;
+export declare function compileFixedFilters(filters: FixedFilter[] | undefined): Record<string, unknown>[];
+export declare function compileJoinClause(join: JoinMapping, sourceRecord: Record<string, unknown>): Record<string, unknown> | null;
+export declare function buildTargetQueryFromLink(link: {
+    join: JoinMapping[];
+    fixedFilters?: FixedFilter[];
+}, sourceRecord: Record<string, unknown>): Record<string, unknown> | null;
+export declare function buildFixedOnlyQuery(fixedFilters: FixedFilter[] | undefined): Record<string, unknown>;
+//# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AA4BzF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIjG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAGjG;AAUD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAKhC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;CAAE,EAC3D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAahC;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKpG"}

package/dist/filters.js

@@ -0,0 +1,75 @@
+import { coerceDateValue, readPath } from './paths.js';
+function operatorToMongo(operator, value) {
+    switch (operator) {
+        case 'eq':
+            return value;
+        case 'ne':
+            return { $ne: value };
+        case 'in':
+            return { $in: Array.isArray(value) ? value : [value] };
+        case 'nin':
+            return { $nin: Array.isArray(value) ? value : [value] };
+        case 'exists':
+            return { $exists: Boolean(value ?? true) };
+        case 'gt':
+            return { $gt: value };
+        case 'gte':
+            return { $gte: value };
+        case 'lt':
+            return { $lt: value };
+        case 'lte':
+            return { $lte: value };
+        default:
+            return value;
+    }
+}
+export function compileFixedFilter(filter, dateLike = false) {
+    const operator = filter.operator;
+    const value = dateLike ? coerceDateValue(filter.value) : filter.value;
+    return { [filter.targetPath]: operatorToMongo(operator, value) };
+}
+export function compileFixedFilters(filters) {
+    if (!filters?.length)
+        return [];
+    return filters.map((filter) => compileFixedFilter(filter, isLikelyDateFilter(filter)));
+}
+function isLikelyDateFilter(filter) {
+    if (filter.operator === 'exists')
+        return false;
+    if (typeof filter.value === 'string') {
+        return /^\d{4}-\d{2}-\d{2}/.test(filter.value) || filter.targetPath.toLowerCase().includes('at');
+    }
+    return filter.targetPath.toLowerCase().includes('at');
+}
+export function compileJoinClause(join, sourceRecord) {
+    const operator = join.operator ?? 'eq';
+    const sourceValue = readPath(sourceRecord, join.sourcePath);
+    if (sourceValue === undefined || sourceValue === null)
+        return null;
+    return { [join.targetPath]: operatorToMongo(operator, sourceValue) };
+}
+export function buildTargetQueryFromLink(link, sourceRecord) {
+    const joinClauses = [];
+    for (const mapping of link.join) {
+        const clause = compileJoinClause(mapping, sourceRecord);
+        if (!clause)
+            return null;
+        joinClauses.push(clause);
+    }
+    const fixed = compileFixedFilters(link.fixedFilters);
+    const all = [...joinClauses, ...fixed];
+    if (all.length === 0)
+        return {};
+    if (all.length === 1)
+        return all[0];
+    return { $and: all };
+}
+export function buildFixedOnlyQuery(fixedFilters) {
+    const fixed = compileFixedFilters(fixedFilters);
+    if (fixed.length === 0)
+        return {};
+    if (fixed.length === 1)
+        return fixed[0];
+    return { $and: fixed };
+}
+//# sourceMappingURL=filters.js.map

package/dist/filters.js.map

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

package/dist/http/register-routes.d.ts

@@ -0,0 +1,12 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import { HippoxService } from '../service.js';
+export type HippoxRouteApp = {
+    get: (path: string, handler: (...args: any[]) => any) => unknown;
+    post: (path: string, handler: (...args: any[]) => any) => unknown;
+};
+export type RegisterHippoxRoutesOptions = {
+    prefix?: string;
+    service?: HippoxService;
+};
+export declare function registerHippoxRoutes(app: HippoxRouteApp, retrieval: MemorixRetrievalClient, options?: RegisterHippoxRoutesOptions): void;
+//# sourceMappingURL=register-routes.d.ts.map

package/dist/http/register-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-routes.d.ts","sourceRoot":"","sources":["../../src/http/register-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,aAAa,EAA2B,MAAM,eAAe,CAAC;AAGvE,MAAM,MAAM,cAAc,GAAG;IAE3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,OAAO,CAAC;IACjE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,OAAO,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB,CAAC;AAWF,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,2BAAgC,GACxC,IAAI,CAkFN"}

package/dist/http/register-routes.js

@@ -0,0 +1,90 @@
+import { HippoxService, isHippoxValidationError } from '../service.js';
+function sendError(reply, err, fallbackStatus = 503) {
+    if (isHippoxValidationError(err)) {
+        return reply.code(400).send({ error: err.message });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    const status = message.includes('not found') ? 404 : fallbackStatus;
+    return reply.code(status).send({ error: message });
+}
+export function registerHippoxRoutes(app, retrieval, options = {}) {
+    const base = (options.prefix ?? '/api/hippox').replace(/\/$/, '');
+    let servicePromise = options.service
+        ? Promise.resolve(options.service)
+        : null;
+    const getService = async () => {
+        if (options.service)
+            return options.service;
+        if (!servicePromise) {
+            servicePromise = HippoxService.create({ retrieval });
+        }
+        return servicePromise;
+    };
+    app.get(`${base}/links`, async (req, reply) => {
+        const q = req.query;
+        if (!q.sourceObjectType?.trim()) {
+            return reply.code(400).send({ error: 'sourceObjectType query parameter is required' });
+        }
+        try {
+            const service = await getService();
+            return await service.listLinks(q.sourceObjectType.trim());
+        }
+        catch (err) {
+            return sendError(reply, err);
+        }
+    });
+    app.post(`${base}/links`, async (req, reply) => {
+        const body = (req.body ?? {});
+        try {
+            const service = await getService();
+            return await service.createDraftLink(body);
+        }
+        catch (err) {
+            return sendError(reply, err, 400);
+        }
+    });
+    app.post(`${base}/links/simulate`, async (req, reply) => {
+        const body = (req.body ?? {});
+        try {
+            const service = await getService();
+            return await service.simulateInlineLink(body);
+        }
+        catch (err) {
+            return sendError(reply, err, 400);
+        }
+    });
+    app.post(`${base}/links/:id/simulate`, async (req, reply) => {
+        const { id } = req.params;
+        try {
+            const service = await getService();
+            return await service.simulateAndPersist(id);
+        }
+        catch (err) {
+            return sendError(reply, err);
+        }
+    });
+    app.post(`${base}/links/:id/approve`, async (req, reply) => {
+        const { id } = req.params;
+        try {
+            const service = await getService();
+            return await service.approveLink(id);
+        }
+        catch (err) {
+            return sendError(reply, err, 400);
+        }
+    });
+    app.post(`${base}/context/resolve`, async (req, reply) => {
+        const body = (req.body ?? {});
+        try {
+            const service = await getService();
+            if (body.legacyContextLinks?.length) {
+                return await service.resolveMixedContextInput(body);
+            }
+            return await service.resolveContextInput(body);
+        }
+        catch (err) {
+            return sendError(reply, err, 400);
+        }
+    });
+}
+//# sourceMappingURL=register-routes.js.map

package/dist/http/register-routes.js.map

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

package/dist/index-recommendations.d.ts

@@ -0,0 +1,4 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { ContextLink, IndexRecommendation } from './types.js';
+export declare function recommendIndexesForLink(retrieval: MemorixRetrievalClient, link: Pick<ContextLink, 'join' | 'targetObjectType' | 'targetContentType' | 'fixedFilters'>): Promise<IndexRecommendation[]>;
+//# sourceMappingURL=index-recommendations.d.ts.map

package/dist/index-recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-recommendations.d.ts","sourceRoot":"","sources":["../src/index-recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGtE,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGnE,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,sBAAsB,EACjC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,cAAc,CAAC,GAC1F,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsBhC"}

package/dist/index-recommendations.js

@@ -0,0 +1,40 @@
+import { getMongoForRetrieval } from '@x12i/memorix-mongo';
+import { resolveMemorixDatabaseName } from '@x12i/memorix-retrieval';
+import { resolveObjectTypeCollection } from './collection-resolver.js';
+export async function recommendIndexesForLink(retrieval, link) {
+    const binding = await resolveObjectTypeCollection(retrieval, link.targetObjectType, link.targetContentType);
+    const recommendations = [];
+    const indexedFields = await listIndexedFields(retrieval, binding.collectionName, binding.target);
+    const paths = new Set();
+    for (const join of link.join)
+        paths.add(join.targetPath);
+    for (const filter of link.fixedFilters ?? [])
+        paths.add(filter.targetPath);
+    for (const field of paths) {
+        if (indexedFields.has(field))
+            continue;
+        recommendations.push({
+            field,
+            reason: `Join/filter field "${field}" is not indexed on ${binding.collectionName}`,
+            suggestedIndex: { [field]: 1 },
+        });
+    }
+    return recommendations;
+}
+async function listIndexedFields(retrieval, collectionName, target) {
+    const lease = await getMongoForRetrieval(retrieval);
+    const memorixTarget = target === 'knowledge' ? 'knowledge' : target;
+    const dbName = resolveMemorixDatabaseName(retrieval, memorixTarget);
+    const coll = lease.client.db(dbName).collection(collectionName);
+    const indexes = await coll.listIndexes().toArray();
+    const fields = new Set();
+    for (const index of indexes) {
+        const key = index.key;
+        for (const field of Object.keys(key)) {
+            if (field !== '_id')
+                fields.add(field);
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=index-recommendations.js.map

package/dist/index-recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-recommendations.js","sourceRoot":"","sources":["../src/index-recommendations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAAiC,EACjC,IAA2F;IAE3F,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAC/C,SAAS,EACT,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,iBAAiB,CACvB,CAAC;IACF,MAAM,eAAe,GAA0B,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE3E,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACvC,eAAe,CAAC,IAAI,CAAC;YACnB,KAAK;YACL,MAAM,EAAE,sBAAsB,KAAK,uBAAuB,OAAO,CAAC,cAAc,EAAE;YAClF,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,SAAiC,EACjC,cAAsB,EACtB,MAAwC;IAExC,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,GAA8B,CAAC;QACjD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,KAAK,KAAK,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { LinkDirection, LinkStatus, JoinOperator, FilterOperator, OutputMode, RetrievalType, JoinMapping, FixedFilter, SortSpec, RecordRetrieval, ListRetrieval, AggregateRetrieval, ContextLinkRetrieval, ContextLink, ContextLinkInput, IndexRecommendation, SimulationWarning, PropertyMatchQuality, SimulationExampleMatch, SimulationExampleMiss, SimulationSummary, ResolveContextInput, ResolveContextResult, HippoxConfig, ObjectTypeCollectionBinding, } from './types.js';
+export { loadHippoxConfig, DEFAULT_HIPPOX_DB, DEFAULT_HIPPOX_COLLECTION, DEFAULT_SIMULATION_LIMIT, DEFAULT_SIMULATION_EXAMPLES_LIMIT, DEFAULT_CONTEXT_LIST_LIMIT, } from './config.js';
+export { readPath, readRecordId, isDateLike, coerceDateValue, sortSpecsToMongo, extractDataPayload, formatOutputRecord, } from './paths.js';
+export { compileFixedFilter, compileFixedFilters, compileJoinClause, buildTargetQueryFromLink, buildFixedOnlyQuery, } from './filters.js';
+export { validateContextLinkInput, defaultRecordRetrieval, defaultListRetrieval, contextKeyForLink, detectContextKeyCollisions, HippoxValidationError, } from './validation.js';
+export { resolveObjectTypeCollection, readObjectTypeDocuments, countObjectTypeDocuments, loadSourceRecord, } from './collection-resolver.js';
+export { HippoxStore, createHippoxStore } from './store.js';
+export { simulateContextLink, type SimulateContextLinkOptions } from './simulate.js';
+export { resolveContext, type ResolveContextOptions } from './resolve.js';
+export { resolveMixedContext, hippoxLinkFromRelationCandidate, type ResolveMixedContextInput, type ResolveMixedContextOptions, } from './legacy-bridge.js';
+export { recommendIndexesForLink } from './index-recommendations.js';
+export { HippoxService, isHippoxValidationError, type HippoxServiceOptions } from './service.js';
+export { registerHippoxRoutes, type RegisterHippoxRoutesOptions, type HippoxRouteApp } from './http/register-routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,UAAU,EACV,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { loadHippoxConfig, DEFAULT_HIPPOX_DB, DEFAULT_HIPPOX_COLLECTION, DEFAULT_SIMULATION_LIMIT, DEFAULT_SIMULATION_EXAMPLES_LIMIT, DEFAULT_CONTEXT_LIST_LIMIT, } from './config.js';
+export { readPath, readRecordId, isDateLike, coerceDateValue, sortSpecsToMongo, extractDataPayload, formatOutputRecord, } from './paths.js';
+export { compileFixedFilter, compileFixedFilters, compileJoinClause, buildTargetQueryFromLink, buildFixedOnlyQuery, } from './filters.js';
+export { validateContextLinkInput, defaultRecordRetrieval, defaultListRetrieval, contextKeyForLink, detectContextKeyCollisions, HippoxValidationError, } from './validation.js';
+export { resolveObjectTypeCollection, readObjectTypeDocuments, countObjectTypeDocuments, loadSourceRecord, } from './collection-resolver.js';
+export { HippoxStore, createHippoxStore } from './store.js';
+export { simulateContextLink } from './simulate.js';
+export { resolveContext } from './resolve.js';
+export { resolveMixedContext, hippoxLinkFromRelationCandidate, } from './legacy-bridge.js';
+export { recommendIndexesForLink } from './index-recommendations.js';
+export { HippoxService, isHippoxValidationError } from './service.js';
+export { registerHippoxRoutes } from './http/register-routes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAmC,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,cAAc,EAA8B,MAAM,cAAc,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,+BAA+B,GAGhC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAA6B,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAyD,MAAM,2BAA2B,CAAC"}

package/dist/legacy-bridge.d.ts

@@ -0,0 +1,27 @@
+import { type JobContextLink } from '@x12i/memorix-mongo';
+import { type ResolveContextOptions } from './resolve.js';
+import type { ContextLink, ResolveContextInput, ResolveContextResult } from './types.js';
+export type ResolveMixedContextInput = ResolveContextInput & {
+    legacyContextLinks?: JobContextLink[];
+    sourceEntity?: string;
+};
+export type ResolveMixedContextOptions = Omit<ResolveContextOptions, 'input'> & {
+    input: ResolveMixedContextInput;
+};
+/**
+ * Resolve Hippox approved links into object-keyed `jobMemory.context` and optionally
+ * merge legacy relation-based context entries under `_legacy`.
+ */
+export declare function resolveMixedContext(options: ResolveMixedContextOptions): Promise<ResolveContextResult & {
+    legacy?: Record<string, unknown>;
+}>;
+export declare function hippoxLinkFromRelationCandidate(params: {
+    relationKey: string;
+    sourceEntity: string;
+    targetEntity: string;
+    sourcePath: string;
+    targetPath: string;
+    sourceContentType?: string;
+    targetContentType?: string;
+}): Omit<ContextLink, 'id' | 'createdAt' | 'updatedAt' | 'status'>;
+//# sourceMappingURL=legacy-bridge.d.ts.map