@x12i/memorix-service 3.7.6 → 3.7.8

package/dist/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Memorix Service API",
-    "version": "3.7.5",
+    "version": "3.7.8",
     "description": "One versioned product API over accepted Memorix packages. Scope: orgId + agentIds[]. Headers x-memorix-org-id and x-memorix-agent-ids (comma-separated). MX-CALLER-01: every /api request requires x-memorix-caller (calling app id). Intelligence never auto-installs. Relationships /links is forbidden. IntegrationsRegistry (Stage −1) and RestrictedStore (FG-A3 dual-mode blob)."
   },
   "servers": [
@@ -3027,14 +3027,34 @@
             "in": "query",
             "schema": {
               "type": "string"
-            }
+            },
+            "description": "List mode only. Opaque cursor from a prior pageInfo.nextCursor. Repeat the same filter and sort."
           },
           {
             "name": "limit",
             "in": "query",
             "schema": {
-              "type": "integer"
-            }
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200
+            },
+            "description": "List mode page size (default 50, max 200)."
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "List mode. JSON SafeFilter[] or equality map on abstract property names."
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "schema": {
+              "type": "string"
+            },
+            "description": "List mode. JSON SafeSort[] on abstract property names."
           }
         ],
         "responses": {
@@ -3384,6 +3404,431 @@
         }
       }
     },
+    "/api/data/compose/data": {
+      "post": {
+        "operationId": "dataComposeData",
+        "summary": "Compose subject content-type data only (AI / agent projection)",
+        "description": "Same-subject composition as dataCompose, but each content type returns an array of record `.data` payloads only — no envelope, revision, or concept. Prefer this for AI layers that need sibling CT payloads without Memorix record chrome.",
+        "tags": [
+          "Data"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Data-only composition",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "scope",
+                    "recordId",
+                    "contents"
+                  ],
+                  "properties": {
+                    "scope": {
+                      "$ref": "#/components/schemas/MemorixScope"
+                    },
+                    "recordId": {
+                      "type": "string"
+                    },
+                    "objectType": {
+                      "type": "string"
+                    },
+                    "dataCategory": {
+                      "type": "string"
+                    },
+                    "contents": {
+                      "type": "object",
+                      "description": "Map of contentType → array of `.data` payloads (one entry per instance)",
+                      "additionalProperties": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      }
+                    },
+                    "warnings": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request / validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "recordId",
+                  "explicit"
+                ],
+                "properties": {
+                  "recordId": {
+                    "type": "string"
+                  },
+                  "explicit": {
+                    "type": "boolean",
+                    "enum": [
+                      true
+                    ]
+                  },
+                  "contentTypes": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Optional CT filter; omit to include all directory content types for the subject"
+                  }
+                }
+              },
+              "example": {
+                "recordId": "wi-100",
+                "explicit": true,
+                "contentTypes": [
+                  "snapshots",
+                  "analysis"
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/data/compose/data/list": {
+      "post": {
+        "operationId": "dataComposeDataList",
+        "summary": "Paginated multi-CT data projection (leading CT drives page)",
+        "description": "Lists subjects by a leading content type (filter/sort/cursor/limit apply only to that CT), then attaches sibling CT `.data` arrays per row. Prefer for AI layers that need a filtered page of subjects with multiple content payloads and no record envelopes.",
+        "tags": [
+          "Data"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixCaller"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated data-only compositions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "scope",
+                    "objectType",
+                    "leadingContentType",
+                    "items",
+                    "pageInfo"
+                  ],
+                  "properties": {
+                    "scope": {
+                      "$ref": "#/components/schemas/MemorixScope"
+                    },
+                    "objectType": {
+                      "type": "string"
+                    },
+                    "leadingContentType": {
+                      "type": "string"
+                    },
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "required": [
+                          "recordId",
+                          "contents"
+                        ],
+                        "properties": {
+                          "recordId": {
+                            "type": "string"
+                          },
+                          "contents": {
+                            "type": "object",
+                            "additionalProperties": {
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "additionalProperties": true
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "pageInfo": {
+                      "type": "object",
+                      "properties": {
+                        "nextCursor": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "limit": {
+                          "type": "integer"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request / validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        },
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "objectType",
+                  "leadingContentType"
+                ],
+                "properties": {
+                  "objectType": {
+                    "type": "string"
+                  },
+                  "leadingContentType": {
+                    "type": "string",
+                    "description": "CT that drives pagination, filter, and sort"
+                  },
+                  "contentTypes": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    },
+                    "description": "Sibling CTs to attach (leading is always included)"
+                  },
+                  "filter": {
+                    "description": "SafeFilter[] / SafeFilter / equality map — applied to leading CT only",
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      },
+                      {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "sort": {
+                    "description": "SafeSort[] / SafeSort — applied to leading CT only",
+                    "oneOf": [
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "additionalProperties": true
+                        }
+                      },
+                      {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    ]
+                  },
+                  "limit": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 200
+                  },
+                  "cursor": {
+                    "type": "string"
+                  }
+                }
+              },
+              "example": {
+                "objectType": "work-items",
+                "leadingContentType": "snapshots",
+                "contentTypes": [
+                  "snapshots",
+                  "workflow",
+                  "analysis"
+                ],
+                "filter": {
+                  "data.status": "open"
+                },
+                "sort": [
+                  {
+                    "field": "recordId",
+                    "direction": "asc"
+                  }
+                ],
+                "limit": 50
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/data/lists": {
+      "post": {
+        "operationId": "dataRunList",
+        "summary": "Run a declared list view or an ad-hoc abstract property page",
+        "description": "Paginated abstract property page. Pass limit (1–200, default 50) and the previous pageInfo.nextCursor. Repeat the same listId or abstractType, filter, and sort on every page. recordId is an exact get and is not paginated. Concrete multi-CT pages stay on /api/data/compose/data/list (same cursor contract).",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "listId": { "type": "string" },
+                  "abstractType": { "type": "string" },
+                  "recordId": { "type": "string" },
+                  "properties": { "type": "array", "items": { "type": "string" } },
+                  "filter": { "type": "object", "additionalProperties": true },
+                  "sort": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+                  "limit": { "type": "integer" },
+                  "cursor": { "type": "string" }
+                }
+              },
+              "example": { "listId": "opx-work-items-list", "limit": 50 }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Abstract property page" },
+          "400": { "description": "Validation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } },
+          "404": { "description": "Unknown list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
+        }
+      }
+    },
+    "/api/data/items": {
+      "post": {
+        "operationId": "dataGetItem",
+        "summary": "Single subject by item view or ad-hoc abstract / content types",
+        "description": "recordId is required. itemId loads a metadata view of kind item (abstract properties plus section content-type .data). Or pass abstractType and/or contentTypes without a view. Not paginated.",
+        "tags": ["Data"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixCaller" },
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["recordId"],
+                "properties": {
+                  "recordId": { "type": "string" },
+                  "itemId": { "type": "string" },
+                  "abstractType": { "type": "string" },
+                  "contentTypes": { "type": "array", "items": { "type": "string" } },
+                  "properties": { "type": "array", "items": { "type": "string" } }
+                }
+              },
+              "example": { "itemId": "opx-work-items-item", "recordId": "wi-100" }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Single item properties and CT data" },
+          "400": { "description": "Validation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } },
+          "404": { "description": "Unknown item or subject", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }
+        }
+      }
+    },
     "/api/relationships/definitions": {
       "get": {
         "operationId": "relationshipsListDefinitions",

package/dist/routes/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/routes/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAgBtD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAwXf"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/routes/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAiBtD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAulBf"}