@x12i/memorix-scoper-sdk 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+# @x12i/memorix-scoper-sdk
+
+Trusted Memorix data access for Scoper hosts.
+
+Scoper is a **product-content reader** aligned with Memorix land v2 (clean default): every `GET /api/data/content` call requires `objectType` + `contentType` + scope headers. Nexum graphs are fetched only as Memorix-landed `content`/`snapshots` subjects — Scoper does not land or write.
+
+```ts
+import { createMemorixScoperClient, readSubjectData } from "@x12i/memorix-scoper-sdk";
+
+const client = createMemorixScoperClient({
+  memorixBaseUrls: ["https://memorix.example"],
+  credentials: async () => ({ token: process.env.TOKEN }),
+});
+const ctx = client.forContext({ orgId, agentIds, caller, traceId });
+
+// Product read — always OT + CT + recordId
+await ctx.subjects.get({ objectType: "employees", contentType: "raw", id: "e1" });
+
+// Structured subject dump (part 1): same address, optional extra content types
+await readSubjectData(ctx, {
+  recordId: "e1",
+  objectType: "employees",
+  contentType: "raw",
+  alsoContentTypes: ["snapshots"],
+});
+
+// Nexum persist (Memorix-internal address)
+await ctx.subjects.getNexumSnapshot({ id: "nexum:item-1" });
+```

package/catalog/catalog.v1.json

@@ -0,0 +1,83 @@
+{
+  "version": "1.0.0",
+  "entries": [
+    {
+      "id": "subjects.get",
+      "capability": "subjects.get",
+      "description": "Fetch a single subject content record by OT/CT/id",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.list",
+      "capability": "subjects.list",
+      "description": "List subject content records for an OT/CT",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.query",
+      "capability": "subjects.query",
+      "description": "Query subjects with optional filters (list-backed)",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.getNexumSnapshot",
+      "capability": "subjects.getNexumSnapshot",
+      "objectType": "content",
+      "contentType": "snapshots",
+      "description": "Fetch and decode memorix-nexum-persist/1 snapshot envelope",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "estate.startSession",
+      "capability": "estate.startSession",
+      "description": "Start an estate/map-store session (requires map-store transport)",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "UNKNOWN"
+    },
+    {
+      "id": "estate.getBag",
+      "capability": "estate.getBag",
+      "description": "Read an estate bag from an active session",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "estate.query",
+      "capability": "estate.query",
+      "description": "Query estate session state",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "explore.query",
+      "capability": "explore.query",
+      "description": "Nexum explore query (feature-gated; deferred by default)",
+      "version": "1.0.0",
+      "enabled": false,
+      "requiresFeature": "nexum-explore",
+      "epistemicDefault": "INFERRED"
+    },
+    {
+      "id": "catalog.describe",
+      "capability": "catalog.describe",
+      "description": "Describe the embedded SDK capability catalog",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    }
+  ]
+}

package/dist/addressing.d.ts

@@ -0,0 +1,20 @@
+/** Require OT+CT for product content list/query (land v2 product read). */
+export declare function requireContentTypePair(input: {
+    objectType?: string;
+    contentType?: string;
+}): {
+    objectType: string;
+    contentType: string;
+};
+/** Require OT+CT+recordId for product content get (land v2; `id` is the documented alias). */
+export declare function requireContentAddress(input: {
+    objectType?: string;
+    contentType?: string;
+    id?: string;
+    recordId?: string;
+}): {
+    objectType: string;
+    contentType: string;
+    id: string;
+};
+//# sourceMappingURL=addressing.d.ts.map

package/dist/addressing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressing.d.ts","sourceRoot":"","sources":["../src/addressing.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAW9C;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAW1D"}

package/dist/addressing.js

@@ -0,0 +1,20 @@
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+/** Require OT+CT for product content list/query (land v2 product read). */
+export function requireContentTypePair(input) {
+    const objectType = String(input.objectType ?? "").trim();
+    const contentType = String(input.contentType ?? "").trim();
+    if (!objectType || !contentType) {
+        throw new ScoperError("INVALID_REQUEST", "Product content reads require non-empty objectType and contentType", { details: { objectType, contentType } });
+    }
+    return { objectType, contentType };
+}
+/** Require OT+CT+recordId for product content get (land v2; `id` is the documented alias). */
+export function requireContentAddress(input) {
+    const { objectType, contentType } = requireContentTypePair(input);
+    const id = String(input.id ?? input.recordId ?? "").trim();
+    if (!id) {
+        throw new ScoperError("INVALID_REQUEST", "Product content get requires recordId (id remains a documented alias)", { details: { objectType, contentType, id } });
+    }
+    return { objectType, contentType, id };
+}
+//# sourceMappingURL=addressing.js.map

package/dist/addressing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressing.js","sourceRoot":"","sources":["../src/addressing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,KAGtC;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,oEAAoE,EACpE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,CACzC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,KAKrC;IACC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,uEAAuE,EACvE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/budget-errors.d.ts

@@ -0,0 +1,4 @@
+import { BudgetAccountant } from "./budgets.js";
+export declare function asBudgetError(err: unknown): never;
+export { BudgetAccountant };
+//# sourceMappingURL=budget-errors.d.ts.map

package/dist/budget-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-errors.d.ts","sourceRoot":"","sources":["../src/budget-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAMjD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/budget-errors.js

@@ -0,0 +1,12 @@
+import { BudgetAccountant } from "./budgets.js";
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+// Patch budget throws to ScoperError — keep BudgetAccountant simple and wrap at call sites in client if needed.
+export function asBudgetError(err) {
+    const anyErr = err;
+    if (anyErr?.code === "BUDGET_EXCEEDED") {
+        throw new ScoperError("BUDGET_EXCEEDED", anyErr.message ?? "budget exceeded");
+    }
+    throw err;
+}
+export { BudgetAccountant };
+//# sourceMappingURL=budget-errors.js.map

package/dist/budget-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-errors.js","sourceRoot":"","sources":["../src/budget-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,gHAAgH;AAChH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,MAAM,GAAG,GAA0C,CAAC;IAC1D,IAAI,MAAM,EAAE,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,IAAI,iBAAiB,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,GAAG,CAAC;AACZ,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/budgets.d.ts

@@ -0,0 +1,28 @@
+export declare class BudgetAccountant {
+    private readonly caps;
+    private subjects;
+    private evidenceItems;
+    private parallelCalls;
+    private tokens;
+    private readonly startedAt;
+    constructor(caps: {
+        maxSubjects: number;
+        maxEvidenceItems: number;
+        maxParallelCalls: number;
+        maxTokens: number;
+        maxWallClockMs: number;
+    });
+    consumeSubjects(n: number): void;
+    consumeEvidence(n: number): void;
+    consumeParallel(n: number): void;
+    consumeTokens(n: number): void;
+    checkWallClock(): void;
+    snapshot(): {
+        subjects: number;
+        evidenceItems: number;
+        parallelCalls: number;
+        tokens: number;
+        wallClockMs: number;
+    };
+}
+//# sourceMappingURL=budgets.d.ts.map

package/dist/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../src/budgets.ts"],"names":[],"mappings":"AAEA,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAGrB,IAAI,EAAE;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB;IAGH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUhC,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUhC,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUhC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAU9B,cAAc,IAAI,IAAI;IAUtB,QAAQ;;;;;;;CAST"}

package/dist/budgets.js

@@ -0,0 +1,52 @@
+import { ScoperError } from "@x12i/memorix-scoper-contracts";
+export class BudgetAccountant {
+    caps;
+    subjects = 0;
+    evidenceItems = 0;
+    parallelCalls = 0;
+    tokens = 0;
+    startedAt = Date.now();
+    constructor(caps) {
+        this.caps = caps;
+    }
+    consumeSubjects(n) {
+        this.subjects += n;
+        if (this.subjects > this.caps.maxSubjects) {
+            throw new ScoperError("BUDGET_EXCEEDED", `subject budget exceeded: ${this.subjects} > ${this.caps.maxSubjects}`);
+        }
+    }
+    consumeEvidence(n) {
+        this.evidenceItems += n;
+        if (this.evidenceItems > this.caps.maxEvidenceItems) {
+            throw new ScoperError("BUDGET_EXCEEDED", `evidence budget exceeded: ${this.evidenceItems} > ${this.caps.maxEvidenceItems}`);
+        }
+    }
+    consumeParallel(n) {
+        this.parallelCalls = Math.max(this.parallelCalls, n);
+        if (n > this.caps.maxParallelCalls) {
+            throw new ScoperError("BUDGET_EXCEEDED", `parallel call budget exceeded: ${n} > ${this.caps.maxParallelCalls}`);
+        }
+    }
+    consumeTokens(n) {
+        this.tokens += n;
+        if (this.tokens > this.caps.maxTokens) {
+            throw new ScoperError("BUDGET_EXCEEDED", `token budget exceeded: ${this.tokens} > ${this.caps.maxTokens}`);
+        }
+    }
+    checkWallClock() {
+        const elapsed = Date.now() - this.startedAt;
+        if (elapsed > this.caps.maxWallClockMs) {
+            throw new ScoperError("BUDGET_EXCEEDED", `wall clock budget exceeded: ${elapsed}ms > ${this.caps.maxWallClockMs}ms`);
+        }
+    }
+    snapshot() {
+        return {
+            subjects: this.subjects,
+            evidenceItems: this.evidenceItems,
+            parallelCalls: this.parallelCalls,
+            tokens: this.tokens,
+            wallClockMs: Date.now() - this.startedAt,
+        };
+    }
+}
+//# sourceMappingURL=budgets.js.map

package/dist/budgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../src/budgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,MAAM,OAAO,gBAAgB;IAQR;IAPX,QAAQ,GAAG,CAAC,CAAC;IACb,aAAa,GAAG,CAAC,CAAC;IAClB,aAAa,GAAG,CAAC,CAAC;IAClB,MAAM,GAAG,CAAC,CAAC;IACF,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,YACmB,IAMhB;QANgB,SAAI,GAAJ,IAAI,CAMpB;IACA,CAAC;IAEJ,eAAe,CAAC,CAAS;QACvB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,4BAA4B,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,eAAe,CAAC,CAAS;QACvB,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpD,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,6BAA6B,IAAI,CAAC,aAAa,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,eAAe,CAAC,CAAS;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACnC,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,kCAAkC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,aAAa,CAAC,CAAS;QACrB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,0BAA0B,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CACjE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,cAAc;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC5C,IAAI,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,+BAA+B,OAAO,QAAQ,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,CAC3E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;SACzC,CAAC;IACJ,CAAC;CACF"}

package/dist/catalog/catalog.v1.json

@@ -0,0 +1,83 @@
+{
+  "version": "1.0.0",
+  "entries": [
+    {
+      "id": "subjects.get",
+      "capability": "subjects.get",
+      "description": "Fetch a single subject content record by OT/CT/id",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.list",
+      "capability": "subjects.list",
+      "description": "List subject content records for an OT/CT",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.query",
+      "capability": "subjects.query",
+      "description": "Query subjects with optional filters (list-backed)",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "subjects.getNexumSnapshot",
+      "capability": "subjects.getNexumSnapshot",
+      "objectType": "content",
+      "contentType": "snapshots",
+      "description": "Fetch and decode memorix-nexum-persist/1 snapshot envelope",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "estate.startSession",
+      "capability": "estate.startSession",
+      "description": "Start an estate/map-store session (requires map-store transport)",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "UNKNOWN"
+    },
+    {
+      "id": "estate.getBag",
+      "capability": "estate.getBag",
+      "description": "Read an estate bag from an active session",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "estate.query",
+      "capability": "estate.query",
+      "description": "Query estate session state",
+      "version": "1.0.0",
+      "enabled": true,
+      "requiresFeature": "estate",
+      "epistemicDefault": "OBSERVED"
+    },
+    {
+      "id": "explore.query",
+      "capability": "explore.query",
+      "description": "Nexum explore query (feature-gated; deferred by default)",
+      "version": "1.0.0",
+      "enabled": false,
+      "requiresFeature": "nexum-explore",
+      "epistemicDefault": "INFERRED"
+    },
+    {
+      "id": "catalog.describe",
+      "capability": "catalog.describe",
+      "description": "Describe the embedded SDK capability catalog",
+      "version": "1.0.0",
+      "enabled": true,
+      "epistemicDefault": "OBSERVED"
+    }
+  ]
+}

package/dist/catalog.d.ts

@@ -0,0 +1,12 @@
+import { type Catalog, type CatalogEntry, type CatalogCapability } from "@x12i/memorix-scoper-contracts";
+export declare function getCatalog(): Catalog;
+export declare function describeCatalog(filter?: {
+    capability?: CatalogCapability;
+    enabledOnly?: boolean;
+    featureFlags?: Record<string, boolean>;
+}): {
+    version: string;
+    entries: CatalogEntry[];
+};
+export declare function requireCatalogEntry(catalogEntryId: string): CatalogEntry;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AAqBxC,wBAAgB,UAAU,IAAI,OAAO,CAGpC;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IACvC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAgB/C;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,CASxE"}

package/dist/catalog.js

@@ -0,0 +1,55 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { CatalogSchema, ScoperError, } from "@x12i/memorix-scoper-contracts";
+function loadEmbeddedCatalog() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        join(here, "catalog", "catalog.v1.json"),
+        join(here, "..", "catalog", "catalog.v1.json"),
+    ];
+    for (const path of candidates) {
+        try {
+            const raw = JSON.parse(readFileSync(path, "utf8"));
+            return CatalogSchema.parse(raw);
+        }
+        catch {
+            // try next
+        }
+    }
+    throw new ScoperError("INTERNAL", "embedded catalog.v1.json not found");
+}
+let cached;
+export function getCatalog() {
+    cached ??= loadEmbeddedCatalog();
+    return cached;
+}
+export function describeCatalog(filter) {
+    const catalog = getCatalog();
+    let entries = catalog.entries;
+    if (filter?.capability) {
+        entries = entries.filter((e) => e.capability === filter.capability);
+    }
+    if (filter?.enabledOnly !== false) {
+        entries = entries.filter((e) => e.enabled);
+    }
+    if (filter?.featureFlags) {
+        entries = entries.filter((e) => {
+            if (!e.requiresFeature)
+                return true;
+            return Boolean(filter.featureFlags?.[e.requiresFeature]);
+        });
+    }
+    return { version: catalog.version, entries };
+}
+export function requireCatalogEntry(catalogEntryId) {
+    const entry = getCatalog().entries.find((e) => e.id === catalogEntryId);
+    if (!entry) {
+        throw new ScoperError("CATALOG_REJECTED", `unknown catalog entry: ${catalogEntryId}`);
+    }
+    if (!entry.enabled) {
+        throw new ScoperError("CATALOG_REJECTED", `catalog entry disabled: ${catalogEntryId}`);
+    }
+    return entry;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,aAAa,EACb,WAAW,GAIZ,MAAM,gCAAgC,CAAC;AAExC,SAAS,mBAAmB;IAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC;KAC/C,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACnD,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,MAAM,IAAI,WAAW,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;AAC1E,CAAC;AAED,IAAI,MAA2B,CAAC;AAEhC,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,mBAAmB,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAI/B;IACC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9B,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;QACvB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,EAAE,WAAW,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;QACzB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,CAAC,eAAe;gBAAE,OAAO,IAAI,CAAC;YACpC,OAAO,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,cAAsB;IACxD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,kBAAkB,EAAE,0BAA0B,cAAc,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,WAAW,CAAC,kBAAkB,EAAE,2BAA2B,cAAc,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,96 @@
+import { type TrustedExecutionContext, type NexumPersistData, type CatalogEntry } from "@x12i/memorix-scoper-contracts";
+import { type TrustedSdkConfig } from "./config.js";
+import { BudgetAccountant } from "./budgets.js";
+import { decodeNexumPersistRecord } from "./decoder.js";
+import { subjectRef } from "./evidence-refs.js";
+export interface ContextualSdk {
+    readonly context: TrustedExecutionContext;
+    readonly budgets: BudgetAccountant;
+    subjects: {
+        get(input: {
+            objectType: string;
+            contentType: string;
+            id: string;
+        }): Promise<{
+            record: Record<string, unknown> | null;
+            ref: ReturnType<typeof subjectRef>;
+        }>;
+        list(input: {
+            objectType: string;
+            contentType: string;
+            limit?: number;
+            cursor?: string;
+        }): Promise<{
+            records: Array<Record<string, unknown>>;
+            nextCursor: string | null;
+            refs: Array<ReturnType<typeof subjectRef>>;
+            /** Ordinary multi-page list results are not snapshot-consistent (schema §7). */
+            snapshotConsistent: false;
+        }>;
+        query(input: {
+            objectType: string;
+            contentType: string;
+            limit?: number;
+            filter?: Record<string, unknown>;
+        }): Promise<{
+            records: Array<Record<string, unknown>>;
+            refs: Array<ReturnType<typeof subjectRef>>;
+            snapshotConsistent: false;
+        }>;
+        /** Nexum persist is Memorix-internal: always OT `content` / CT `snapshots`. */
+        getNexumSnapshot(input: {
+            id: string;
+        }): Promise<{
+            envelope: NexumPersistData;
+            record: Record<string, unknown>;
+            decoded: ReturnType<typeof decodeNexumPersistRecord>;
+        }>;
+    };
+    estate: {
+        startSession(input?: {
+            bootstrap?: unknown;
+        }): Promise<{
+            sessionId: string;
+        }>;
+        getBag(input: {
+            sessionId: string;
+            bagId: string;
+        }): Promise<{
+            bagId: string;
+            data: unknown;
+        }>;
+        query(input: {
+            sessionId: string;
+            query: Record<string, unknown>;
+        }): Promise<{
+            results: unknown[];
+        }>;
+    };
+    explore: {
+        query(input: Record<string, unknown>): Promise<never>;
+    };
+    catalog: {
+        describe(filter?: {
+            capability?: CatalogEntry["capability"];
+            enabledOnly?: boolean;
+        }): {
+            version: string;
+            entries: CatalogEntry[];
+        };
+    };
+}
+export declare function createMemorixScoperClient(config: TrustedSdkConfig): {
+    config: TrustedSdkConfig;
+    baseUrl: string;
+    hostBudgets: {
+        maxSubjects: number;
+        maxEvidenceItems: number;
+        maxParallelCalls: number;
+        maxTokens: number;
+        maxWallClockMs: number;
+        maxEstateSessions: number;
+    };
+    forContext(context: TrustedExecutionContext): ContextualSdk;
+};
+export type MemorixScoperClient = ReturnType<typeof createMemorixScoperClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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