@xfloor/memory-sdk-js 1.0.1

package/dist/api/EditFloorApi.js

@@ -0,0 +1,103 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _EditFloor400Response = _interopRequireDefault(require("../model/EditFloor400Response"));
+var _GetFloorInformation200Response = _interopRequireDefault(require("../model/GetFloorInformation200Response"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * Floor Memory
+ * The set APIs are used to develop Floor pds which can be used as their personal assistants.   This set of APIs are divided into two parts.  - Memory and  - Registration.   The developer has two ways of using the APIs for the app development. Developer can choose to the  Registration APIs for using the existing xfloor infracture or can implement custom Registration process. In the case of custom registration process, the developer is bound to provide proper authentication mechanisms and then send the user information to xlfoor.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@ipomo.in
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* EditFloor service.
+* @module api/EditFloorApi
+* @version 1.0.1
+*/
+var EditFloorApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new EditFloorApi. 
+  * @alias module:api/EditFloorApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function EditFloorApi(apiClient) {
+    _classCallCheck(this, EditFloorApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the editFloor operation.
+   * @callback module:api/EditFloorApi~editFloorCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/GetFloorInformation200Response} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Edit floor
+   * This API updates an existing floor’s profile metadata using **multipart form data**.  A floor **can be edited only by its owner**. If the authenticated user is **not the owner of the floor**, the request will be rejected, even if the user is a member or follower of the floor.  The API allows the floor owner to update:  * Floor **title** * Floor **details/description** * Floor **logo/avatar image**  After a successful update, the API returns the **latest floor object**, including the updated avatar and the current list of blocks associated with the floor.  ---  ## Authorization Rules (Critical)  * The caller **must be authenticated** * The caller **must be the owner of the floor** * Members, followers, or pod consumers **cannot** edit the floor * Ownership is validated internally using the authenticated user context  > **Ownership is mandatory. There are no partial permissions for this API.**  ---  ## Content-Type  `multipart/form-data`  ---  ## Request Body (Multipart Form Data)  ### Form Fields  | Field Name | Type   | Required     | Description                              | | ---------- | ------ | ------------ | ---------------------------------------- | | `fid`      | String | Recommended* | Immutable internal floor ID              | | `floor_id` | String | Optional*    | Public / human-readable floor identifier | | `title`    | String | Optional     | New floor title                          | | `details`  | String | Optional     | New floor description                    | | `logo`     | File   | Optional     | New floor logo image (PNG/JPG/WebP)      |  * At least **one floor identifier** (`fid` or `floor_id`) must be provided. **Best practice:** Use `fid` as the primary identifier.  ---  ## Update Rules  * At least one of `title`, `details`, or `logo` must be present * Missing update fields result in a validation error * If `logo` is provided, the previous logo is replaced  ---  ## Response Format  `application/json`  ---  ## Sample Success Response  ```json {   \"floor_id\": \"my_floor\",   \"title\": \"daughter ouch upon yummy clamor\",   \"details\": \"nostrud occaecat incididunt dolor adipisicing\",   \"fid\": \"86\",   \"blocks\": [     {       \"bid\": \"83\",       \"type\": \"pariatur\",       \"title\": \"wherever demobilise acidly refute\"     }   ],   \"avatar\": {     \"url\": \"https://legal-availability.name/\",     \"id\": \"98\"   } } ```  ---  ## Error Responses (Authorization Focus)  ### Not Floor Owner  ```json {   \"status\": \"ERROR\",   \"message\": \"Only the floor owner can edit this floor\" } ```  ### Floor Not Found  ```json {   \"status\": \"ERROR\",   \"message\": \"Floor not found\" } ```  ### No Update Fields  ```json {   \"status\": \"ERROR\",   \"message\": \"No update fields provided\" } ```  ---  ## Notes  * This API is **owner-only by design** * Pods and developer tools must operate using **owner credentials** * Blocks are returned for convenience but are **not editable through this API**  ---   
+   * @param {String} floorId 
+   * @param {String} userId User ID
+   * @param {String} appId App ID
+   * @param {Object} opts Optional parameters
+   * @param {File} [logoFile] Floor avatar
+   * @param {String} [title] Floor title
+   * @param {String} [details] Floor decription
+   * @param {module:api/EditFloorApi~editFloorCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/GetFloorInformation200Response}
+   */
+  return _createClass(EditFloorApi, [{
+    key: "editFloor",
+    value: function editFloor(floorId, userId, appId, opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'floorId' is set
+      if (floorId === undefined || floorId === null) {
+        throw new Error("Missing the required parameter 'floorId' when calling editFloor");
+      }
+      // verify the required parameter 'userId' is set
+      if (userId === undefined || userId === null) {
+        throw new Error("Missing the required parameter 'userId' when calling editFloor");
+      }
+      // verify the required parameter 'appId' is set
+      if (appId === undefined || appId === null) {
+        throw new Error("Missing the required parameter 'appId' when calling editFloor");
+      }
+      var pathParams = {
+        'floor_id': floorId
+      };
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {
+        'user_id': userId,
+        'app_id': appId,
+        'logo_file': opts['logoFile'],
+        'title': opts['title'],
+        'details': opts['details']
+      };
+      var authNames = ['bearer'];
+      var contentTypes = ['multipart/form-data'];
+      var accepts = ['application/json'];
+      var returnType = _GetFloorInformation200Response["default"];
+      return this.apiClient.callApi('/api/memory/edit/floor/{floor_id}', 'POST', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();

package/dist/api/EventApi.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _Event400Response = _interopRequireDefault(require("../model/Event400Response"));
+var _EventResponse = _interopRequireDefault(require("../model/EventResponse"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * Floor Memory
+ * The set APIs are used to develop Floor pds which can be used as their personal assistants.   This set of APIs are divided into two parts.  - Memory and  - Registration.   The developer has two ways of using the APIs for the app development. Developer can choose to the  Registration APIs for using the existing xfloor infracture or can implement custom Registration process. In the case of custom registration process, the developer is bound to provide proper authentication mechanisms and then send the user information to xlfoor.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@ipomo.in
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* Event service.
+* @module api/EventApi
+* @version 1.0.1
+*/
+var EventApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new EventApi. 
+  * @alias module:api/EventApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function EventApi(apiClient) {
+    _classCallCheck(this, EventApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the event operation.
+   * @callback module:api/EventApi~eventCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/EventResponse} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Create Event (Post Content)
+   * Posts into the given floor_id. This is asynchronous ingestion. 200 OK means queued, not immediately retrievable. This API allows a user to **post personal content into their POD (Personal Object Database)**. The posted content is stored under a specified **floor**, embedded by the platform, and made available for **semantic querying, conversational retrieval, and memory-based interactions**.  It is primarily used to:  * Save reminders, notes, writeups, or personal knowledge * Upload content that the user wants the system to remember * Add information that should later be discoverable via conversational queries  The content may consist of **text only** or **text combined with one or more media files**.  ---  ## **Key Capabilities**  * Stores user-generated content inside a specific floor * Supports **multi-modal inputs** (text + media) * Automatically embeds content for semantic search * Makes content available to:    * `/agent/memory/query`   * conversational agents   * future recall and analytics * Associates content with user, block, and application context  ---  ## **Authentication**  * Requires a valid, authenticated `user_id` * The calling application is responsible for user authentication * `app_id` identifies the application context  ---  ## **Request Type**  **Content-Type:** `multipart/form-data`  ---  ## **Request Parameters**  ### **1. Files (Optional)**  | Field   | Type   | Required | Description                                                           | | ------- | ------ | -------- | --------------------------------------------------------------------- | | `files` | file[] | Optional | Media files to attach to the content. Multiple files may be uploaded. |  **Supported formats include (but are not limited to):**  * Images: `jpg`, `png` * Audio: `mp3` * Documents: `pdf` * Video: `mp4`  These files are processed and embedded along with the textual content where applicable.  ---  ### **2. Input Information (Required)**  | Field        | Type          | Required | Description                                                       | | ------------ | ------------- | -------- | ----------------------------------------------------------------- | | `input_info` | string (JSON) | Yes      | JSON string containing metadata and textual content for the post. |  ---  ## **`input_info` Structure**  ```json {   \"floor_id\": \"my_floor\",   \"BID\": \"17845683456\",   \"user_id\": \"145623907625\",   \"title\": \"My floor\",   \"description\": \"My floor details\",   \"app_id\": \"165434879028\" } ```  ---  ### **Field Descriptions**  | Field         | Type   | Required | Description                                                                        | | ------------- | ------ | -------- | ---------------------------------------------------------------------------------- | | `floor_id`    | string | Yes      | Identifier of the user’s floor (POD) where the content will be stored.             | | `block_type`  | string | Yes      | Type of block under which the content is categorized (e.g., post, note, reminder). | | `BID`         | string | Yes      | Block identifier associated with this content.                                     | | `user_id`     | string | Yes      | Unique identifier of the user posting the content.                                 | | `title`       | string | Optional | Title or short heading for the content.                                            | | `description` | string | Yes      | Main textual content to be stored and embedded.                                    | | `app_id`      | string | Optional | Identifier of the calling application.                                             |  ---  ## **Behavior**  1. The API validates the user and floor context. 2. Textual content (`title` and `description`) is ingested. 3. Attached media files are processed and linked to the content. 4. Embeddings are generated for:     * Text    * Supported media (where applicable) 5. The content becomes part of the user’s **personal memory store**. 6. The stored data is immediately available for querying and conversational retrieval.  ---  ## **Successful Response**  On success, the API confirms that:  * The content has been stored * Embeddings have been generated * The memory item is available for future queries  A success status and reference identifiers are returned.  ---  ## **Error Handling**  The API may return errors if:  * Required fields are missing (`floor_id`, `user_id`, `description`) * Unsupported file formats are uploaded * The user does not have access to the specified floor * The request payload is malformed * Internal embedding or storage operations fail  ---  ## **Typical Use Cases**  * Saving personal reminders * Posting notes or observations * Uploading documents for future reference * Creating a personal knowledge base * Feeding data into conversational agents  ---  ## **One-Line Summary**  > Stores user-generated text and media into a personal POD, embeds it for semantic search, and makes it available for conversational querying.  ⚠️ Content Ingestion is Asynchronous  The Create Event API queues content for processing. A successful response indicates **acceptance**, not availability.  Newly ingested content may take time to become searchable via the Query API.  
+   * @param {String} inputInfo Input parameters, bid is optional
+   * @param {Object} opts Optional parameters
+   * @param {File} [files] Attach relevant media here, which includes, jpg, mp3, pdf, mp4 files. More than one media can be selected
+   * @param {module:api/EventApi~eventCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/EventResponse}
+   */
+  return _createClass(EventApi, [{
+    key: "event",
+    value: function event(inputInfo, opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'inputInfo' is set
+      if (inputInfo === undefined || inputInfo === null) {
+        throw new Error("Missing the required parameter 'inputInfo' when calling event");
+      }
+      var pathParams = {};
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {
+        'files': opts['files'],
+        'input_info': inputInfo
+      };
+      var authNames = ['bearer'];
+      var contentTypes = ['multipart/form-data'];
+      var accepts = ['application/json'];
+      var returnType = _EventResponse["default"];
+      return this.apiClient.callApi('/api/memory/events', 'POST', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();

package/dist/api/GetFloorInformationApi.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _GetFloorInformation200Response = _interopRequireDefault(require("../model/GetFloorInformation200Response"));
+var _GetRecentEvents400Response = _interopRequireDefault(require("../model/GetRecentEvents400Response"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * Floor Memory
+ * The set APIs are used to develop Floor pds which can be used as their personal assistants.   This set of APIs are divided into two parts.  - Memory and  - Registration.   The developer has two ways of using the APIs for the app development. Developer can choose to the  Registration APIs for using the existing xfloor infracture or can implement custom Registration process. In the case of custom registration process, the developer is bound to provide proper authentication mechanisms and then send the user information to xlfoor.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@ipomo.in
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* GetFloorInformation service.
+* @module api/GetFloorInformationApi
+* @version 1.0.1
+*/
+var GetFloorInformationApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new GetFloorInformationApi. 
+  * @alias module:api/GetFloorInformationApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function GetFloorInformationApi(apiClient) {
+    _classCallCheck(this, GetFloorInformationApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the getFloorInformation operation.
+   * @callback module:api/GetFloorInformationApi~getFloorInformationCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/GetFloorInformation200Response} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Basic information of a floor
+   * This API returns the **basic profile information of a floor**. It is used to fetch all essential metadata required to **render a floor landing page, header, or navigation context**.  The response includes:  * Floor identity and type * Ownership information relative to the requesting user * Floor metadata (title, description, avatar) * List of blocks available in the floor * App association (for pod / developer use cases)  This API does **not** return posts or content; it only provides **structural and descriptive information** about the floor.  ---  ## Typical Use Cases  * Render floor header (title, logo, description) * Decide UI permissions (owner vs non-owner) * Display available blocks (Feeds, Blog, Quiz, etc.) * Pod discovery or developer-managed floor rendering * Lightweight floor metadata fetch before loading content  ---  ## Authorization & Context  * The API may be called by authenticated or unauthenticated users (depending on floor visibility). * The `is_owner` field is calculated **relative to the requesting user context** (if authenticated).  ---  ## Response Format  `application/json`  ---  ## Response Structure  ### Top-Level Fields  | Field        | Type                   | Description                                                      | | ------------ | ---------------------- | ---------------------------------------------------------------- | | `floor_id`   | String                 | Public, human-readable identifier of the floor                   | | `floor_uid`  | String                 | Internal unique identifier of the floor                          | | `title`      | String                 | Display title of the floor                                       | | `details`    | String                 | Short description or summary of the floor                        | | `floor_type` | String                 | Type of floor (`PUBLIC`, `PRIVATE`, `POD`)                       | | `is_owner`   | String (`\"0\"` / `\"1\"`) | Indicates whether the requesting user is the owner               | | `blocks`     | Array                  | List of blocks available in the floor                            | | `avatar`     | Object                 | Floor logo / avatar metadata                                     | | `app_id`     | String                 | Associated application ID (used mainly for pod/developer floors) |  ---  ## Ownership Indicator  ### `is_owner`  ```json \"is_owner\": \"0\" ```  | Value | Meaning                                   | | ----- | ----------------------------------------- | | `\"1\"` | Requesting user is the owner of the floor | | `\"0\"` | Requesting user is not the owner          |  This field is typically used by clients to:  * Enable or disable edit/settings UI * Show owner-only actions  ---  ## Blocks Object  ```json \"blocks\": [   {     \"BID\": \"1765960948723\",     \"type\": \"1\",     \"title\": \"Feeds\"   } ] ```  Each block represents a **content category or service** available inside the floor.  ### Block Fields  | Field   | Type   | Description                                           | | ------- | ------ | ----------------------------------------------------- | | `BID`   | String | Unique identifier of the block                        | | `type`  | String | Block type identifier (e.g., feed, blog, forum, quiz) | | `title` | String | Display name of the block                             |  ---  ## Avatar Object  ```json \"avatar\": {   \"id\": \"1767009204367\",   \"url\": \"https://...\" } ```  | Field | Type   | Description                    | | ----- | ------ | ------------------------------ | | `id`  | String | Media identifier of the avatar | | `url` | String | CDN URL of the floor logo      |  Used to render the floor’s profile image or banner.  ---  ## Floor Type  ```json \"floor_type\": \"POD\" ```  | Value     | Meaning                               | | --------- | ------------------------------------- | | `PUBLIC`  | Open floor visible to everyone        | | `PRIVATE` | Restricted floor                      | | `POD`     | Aggregated or developer-managed floor |  `POD` floors are often associated with an `app_id` and may aggregate or serve content programmatically.  ---  ## Sample Success Response  ```json {   \"is_owner\": \"0\",   \"blocks\": [     {       \"BID\": \"1765960948723\",       \"type\": \"1\",       \"title\": \"Feeds\"     }   ],   \"floor_uid\": \"1765960956967\",   \"floor_id\": \"raghupodfloor1\",   \"details\": \"raghu\",   \"avatar\": {     \"id\": \"1767009204367\",     \"url\": \"https://d2e5822u5ecuq8.cloudfront.net/room/1765960956967/logo/1765960956967.jpg\"   },   \"title\": \"raghu\",   \"floor_type\": \"POD\",   \"app_id\": \"1765949734005\" } ```  ---  ## Notes for Developers  * This is a **lightweight metadata API** and is safe to call frequently. * Use this API **before** loading posts or analytics. * `blocks` ordering can be used directly for navigation UI. * `floor_type` + `is_owner` together determine which UI actions are allowed.  ---  ## Common Error Scenarios  ### Floor Not Found  ```json {   \"status\": \"ERROR\",   \"message\": \"Floor not found\" } ```  ### Access Restricted  ```json {   \"status\": \"ERROR\",   \"message\": \"Access denied for this floor\" } ```  ---  ### Final Mental Model  > **This API answers: “What is this floor, who owns it, and what can I do here?”** 
+   * @param {String} floorId 
+   * @param {Object} opts Optional parameters
+   * @param {String} [userId] User ID  - 13 digit numeric identity
+   * @param {String} [appId] App ID - 13 digit numeric identity
+   * @param {module:api/GetFloorInformationApi~getFloorInformationCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/GetFloorInformation200Response}
+   */
+  return _createClass(GetFloorInformationApi, [{
+    key: "getFloorInformation",
+    value: function getFloorInformation(floorId, opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'floorId' is set
+      if (floorId === undefined || floorId === null) {
+        throw new Error("Missing the required parameter 'floorId' when calling getFloorInformation");
+      }
+      var pathParams = {
+        'floor_id': floorId
+      };
+      var queryParams = {
+        'user_id': opts['userId'],
+        'app_id': opts['appId']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['bearer'];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _GetFloorInformation200Response["default"];
+      return this.apiClient.callApi('/api/memory/floor/info/{floor_id}', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();

package/dist/api/GetRecentEventsApi.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _GetRecentEvents200Response = _interopRequireDefault(require("../model/GetRecentEvents200Response"));
+var _GetRecentEvents400Response = _interopRequireDefault(require("../model/GetRecentEvents400Response"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * Floor Memory
+ * The set APIs are used to develop Floor pds which can be used as their personal assistants.   This set of APIs are divided into two parts.  - Memory and  - Registration.   The developer has two ways of using the APIs for the app development. Developer can choose to the  Registration APIs for using the existing xfloor infracture or can implement custom Registration process. In the case of custom registration process, the developer is bound to provide proper authentication mechanisms and then send the user information to xlfoor.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@ipomo.in
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* GetRecentEvents service.
+* @module api/GetRecentEventsApi
+* @version 1.0.1
+*/
+var GetRecentEventsApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new GetRecentEventsApi. 
+  * @alias module:api/GetRecentEventsApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function GetRecentEventsApi(apiClient) {
+    _classCallCheck(this, GetRecentEventsApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the getRecentEvents operation.
+   * @callback module:api/GetRecentEventsApi~getRecentEventsCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/GetRecentEvents200Response} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Recent Events
+   * This API retrieves the **latest posts (events)** from a specified floor.  The behaviour of the API changes based on whether a **user ID** is provided:  * **If `user_id` is provided**   → The API returns **recent posts relevant to that user**, scoped within the given floor.   This includes posts from:    * Floors the user follows   * Floors created by the user   * Pod floors associated with the user (if applicable)  * **If `user_id` is NOT provided**   → The API returns the **most recent posts available in the specified floor**, without user-specific filtering.  This makes the API suitable for:  * Personalized activity feeds * Floor-level public timelines * Pod-based content aggregation * Developer-built pods and custom clients  ---  ## **Key Concepts**  * A **floor** represents a content space (independent floor, followed floor, or pod floor) * A **pod floor** may aggregate content across multiple related floors * Posts are returned **in reverse chronological order** (latest first) * Each post belongs to a specific **block** within the floor  ---  ## **Request Method**  `GET`  ---  ## **Request Parameters (Query Params)**  | Parameter Name | Type   | Required | Description                                                                                                                | | -------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------- | | `floor_id`     | String | **Yes**  | Floor identifier from which events should be fetched. Can be a pod floor ID, followed floor ID, or an independent floor ID | | `user_id`      | String | No       | If provided, returns posts relevant to the user within the given floor                                                     | | `app_id`       | String | No       | Identifier for external developers or pod-based applications consuming this API                                            |  ---  ## **Behavior Summary**  | Scenario               | Result                                    | | ---------------------- | ----------------------------------------- | | `floor_id` only        | Latest posts from the specified floor     | | `floor_id` + `user_id` | User-relevant posts within that floor     | | Pod floor ID           | Aggregated posts across pod-linked floors | | Independent floor ID   | Posts only from that floor                |  ---  ## **Response Format**  `application/json`  ---  ## **Response Structure**  ### **Top-Level Fields**  | Field        | Type   | Description                    | | ------------ | ------ | ------------------------------ | | `post_count` | String | Total number of posts returned | | `items`      | Array  | List of recent post objects    |  ---  ### **Post Object (`items[]`)**  | Field           | Type   | Description                                                               | | --------------- | ------ | ------------------------------------------------------------------------- | | `event_id`      | String | Unique identifier of the post/event                                       | | `block_type`    | String | Type of block where the post was created (e.g., blog, forum, audio, etc.) | | `block_id`      | String | Identifier of the block within the floor                                  | | `floor_uid`     | String | Floor identifier where the post belongs                                   | | `title`         | String | Title of the post (may be empty)                                          | | `text`          | String | Text or HTML content of the post                                          | | `media`         | Array  | Media objects (audio, image, etc.), if any                                | | `created_at_ms` | String | Post creation time in milliseconds (epoch)                                |  ---  ### **Author Object**  | Field       | Type   | Description                  | | ----------- | ------ | ---------------------------- | | `name`      | String | Display name of the author   | | `floor_uid` | String | Author’s floor/user handle   | | `avatar`    | Object | Author profile image details |  ---  ### **Media Object**  | Field  | Type   | Description                         | | ------ | ------ | ----------------------------------- | | `type` | String | Media type (e.g., `AUDIO`, `IMAGE`) | | `url`  | String | Public URL of the media file        |  ---  ## **Sample Success Response**  *(structure abbreviated for clarity)*  ```json {   \"post_count\": \"18\",   \"items\": [     {       \"event_id\": \"1766557274836\",       \"block_type\": \"0\",       \"title\": \"voice-note-1766557272764.wav\",       \"text\": \"You\",       \"created_at_ms\": \"1766557275000\",       \"author\": {         \"name\": \"MEGHANA G\",         \"floor_uid\": \"meghanag\",         \"avatar\": {           \"type\": \"IMAGE\",           \"url\": \"https://...\"         }       },       \"media\": [         {           \"type\": \"AUDIO\",           \"url\": \"https://...\"         }       ]     }   ] } ```  ---  ## **Notes**  * Posts may contain **plain text or HTML** * Media is optional and may be absent * Ordering is **latest first** * The API is read-only and does not require authentication by default * Access control (public/private floors) is enforced internally  ---  ## **Typical Use Cases**  * Floor activity feed * Pod-level dashboards * User-personalized timelines * Public floor landing pages * External developer pods using `app_id`
+   * @param {String} floorId 
+   * @param {Object} opts Optional parameters
+   * @param {String} [userId] 
+   * @param {String} [appId] 
+   * @param {module:api/GetRecentEventsApi~getRecentEventsCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/GetRecentEvents200Response}
+   */
+  return _createClass(GetRecentEventsApi, [{
+    key: "getRecentEvents",
+    value: function getRecentEvents(floorId, opts, callback) {
+      opts = opts || {};
+      var postBody = null;
+      // verify the required parameter 'floorId' is set
+      if (floorId === undefined || floorId === null) {
+        throw new Error("Missing the required parameter 'floorId' when calling getRecentEvents");
+      }
+      var pathParams = {};
+      var queryParams = {
+        'user_id': opts['userId'],
+        'floor_id': floorId,
+        'app_id': opts['appId']
+      };
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['bearer'];
+      var contentTypes = [];
+      var accepts = ['application/json'];
+      var returnType = _GetRecentEvents200Response["default"];
+      return this.apiClient.callApi('/api/memory/recent/events', 'GET', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();

package/dist/api/QueryApi.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _ApiClient = _interopRequireDefault(require("../ApiClient"));
+var _Query422Response = _interopRequireDefault(require("../model/Query422Response"));
+var _QueryRequest = _interopRequireDefault(require("../model/QueryRequest"));
+var _QueryResponse = _interopRequireDefault(require("../model/QueryResponse"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * Floor Memory
+ * The set APIs are used to develop Floor pds which can be used as their personal assistants.   This set of APIs are divided into two parts.  - Memory and  - Registration.   The developer has two ways of using the APIs for the app development. Developer can choose to the  Registration APIs for using the existing xfloor infracture or can implement custom Registration process. In the case of custom registration process, the developer is bound to provide proper authentication mechanisms and then send the user information to xlfoor.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * Contact: contact@ipomo.in
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ *
+ */
+/**
+* Query service.
+* @module api/QueryApi
+* @version 1.0.1
+*/
+var QueryApi = exports["default"] = /*#__PURE__*/function () {
+  /**
+  * Constructs a new QueryApi. 
+  * @alias module:api/QueryApi
+  * @class
+  * @param {module:ApiClient} [apiClient] Optional API client implementation to use,
+  * default to {@link module:ApiClient#instance} if unspecified.
+  */
+  function QueryApi(apiClient) {
+    _classCallCheck(this, QueryApi);
+    this.apiClient = apiClient || _ApiClient["default"].instance;
+  }
+
+  /**
+   * Callback function to receive the result of the query operation.
+   * @callback module:api/QueryApi~queryCallback
+   * @param {String} error Error message, if any.
+   * @param {module:model/QueryResponse} data The data returned by the service call.
+   * @param {String} response The complete HTTP response.
+   */
+
+  /**
+   * Query (Primary API)
+   * # **Conversational Query API** This is the **core API** of xfloor.  It accepts a natural language query and returns a conversational response derived from: - Content ingested into the specified Floor - The user’s prior conversation history (if provided) - Relevant metadata and context  This API is designed for **multi-turn conversations** and can be used to build: - AI chatbots - Knowledge assistants - Floor-specific copilots  This API enables **conversational, context-aware querying** over data stored within xfloor.  It accepts a natural language query (for example, *“What options do I have in your institute?”*) and returns relevant information derived from the specified floors and their associated content.  The API is designed for **multi-turn conversations**. Follow-up questions from the same user automatically build upon prior context, allowing the system to refine, expand, or clarify results across successive calls.  ---  ## **Core Capabilities**  * Interprets **natural language queries** * Retrieves relevant information from one or more floors * Applies **time-, type-, and tag-based filters** * Supports **Top-K retrieval** for result control * Optionally includes metadata with responses * Can generate **summarized responses** when requested * Maintains **conversation continuity** across multiple queries from the same user  ---  ## **Authentication & Identity**  * A valid `user_id` is **required** * User authentication is assumed to be completed **before** calling this API * `app_id` identifies the calling application context * Conversational continuity is maintained **per `user_id`**  > **Note:** All queries from the same `user_id` are treated as part of a single conversational context unless explicitly reset by the application.  ---  ## **Request Contract**  ### **HTTP Method**  `POST`  ### **Content-Type**  ``` application/json ```  > **Important:** > This API accepts **JSON requests only**. > `multipart/form-data` is **not supported**.  ---  ## **Request Body (JSON)**  ### **Field Descriptions**  | Field               | Type                    | Required | Description                                                                                    | | ------------------- | ----------------------- | -------- | ---------------------------------------------------------------------------------------------- | | `user_id`           | string                  | Yes      | Unique xfloor user identifier. Used to maintain conversational continuity and personalization. | | `query`             | string                  | Yes      | Natural language query provided by the user.                                                   | | `floor_ids`         | array of strings        | Yes      | List of floor identifiers that define the search scope. Must be provided as a JSON array.      | | `filters`           | object                  | Optional | Additional constraints to narrow search results.                                               | | `filters.time_from` | string (ISO-8601)       | Optional | Start timestamp for filtering content by creation or update time.                              | | `filters.time_to`   | string (ISO-8601)       | Optional | End timestamp for filtering content by creation or update time.                                | | `filters.types`     | array of strings        | Optional | Content types to include (e.g., `post`, `blog`, `forum`).                                      | | `filters.tags`      | array of strings        | Optional | Tags used to further refine results.                                                           | | `k`                 | integer                 | Optional | Maximum number of results to retrieve (Top-K). Defaults to system-defined behavior if omitted. | | `include_metadata`  | string (`\"0\"` or `\"1\"`) | Optional | Whether to include metadata (source, timestamps, tags) in the response. Defaults to `\"0\"`.     | | `summary_needed`    | string (`\"0\"` or `\"1\"`) | Optional | Whether a summarized conversational answer should be generated. Defaults to `\"0\"`.             | | `app_id`            | string                  | Optional | Identifies the application invoking the API. Useful for multi-app integrations.                |  ---  ### **Important Encoding Rules**  * `floor_ids` **must** be provided as a JSON array    ```json   \"floor_ids\": [\"floor_1\", \"floor_2\"]   ``` * Boolean-style flags (`include_metadata`, `summary_needed`) are encoded as **string values**: `\"0\"` or `\"1\"` * `filters` must be provided as a **JSON object**, not a string  ---  ### **Canonical Request Example**  ```json {   \"user_id\": \"xf_user_123\",   \"query\": \"What options do I have in your institute?\",   \"floor_ids\": [\"institute_floor\"],   \"filters\": {     \"types\": [\"post\", \"blog\"],     \"tags\": [\"admissions\"]   },   \"k\": 5,   \"include_metadata\": \"1\",   \"summary_needed\": \"1\",   \"app_id\": \"student_portal\" } ```  ---  ## **Behavior**  1. The query is analyzed using conversational and semantic understanding. 2. Relevant content is retrieved from the specified floors. 3. Filters (time, type, tags) are applied if provided. 4. Results are ranked and limited based on `k`. 5. If `summary_needed = \"1\"`, a synthesized conversational summary is generated. 6. If `include_metadata = \"1\"`, metadata is attached to each result item. 7. The response is returned in a conversational format suitable for follow-up questions.  ---  ## **Response Contract**  ### **High-Level Response Structure**  ```json {   \"answer\": \"Assistant-generated conversational response\",   \"items\": [     {       \"id\": \"content_id\",       \"type\": \"post\",       \"text\": \"Original content snippet\",       \"metadata\": { }     }   ] } ```  ---  ### **Response Field Semantics**  | Field              | Always Present     | Description                                 | Rendering Guidance     | | ------------------ | ------------------ | ------------------------------------------- | ---------------------- | | `answer`           | Yes                | Assistant-generated conversational response | **Render prominently** | | `items`            | Yes (may be empty) | List of matched content used for grounding  | Render optionally      | | `items[].metadata` | Conditional        | Included only if `include_metadata = \"1\"`   | Render on demand       |  > **No-Result Case:** > If no relevant content is found, `items` will be an empty array and `answer` will contain a conversational fallback response.  ---  ## **Conversation Continuity**  * Conversation state is maintained **per `user_id`** * Follow-up queries automatically reference prior context * The API does not require explicit conversation IDs * Applications may reset conversation context by using a new `user_id`  ---  ## **Error Handling**  The API may return errors in the following cases:  * Missing or invalid `user_id` * Empty or unsupported `query` * Invalid or inaccessible `floor_ids` * Authorization or application context errors * Internal processing failures  All errors are returned with appropriate HTTP status codes and descriptive messages.  ---  ## **Typical Use Case Flow**  1. User asks an initial question    *“What options do I have in your institute?”* 2. Application calls `/agent/memory/query` 3. Results are displayed to the user 4. User asks a follow-up    *“Which ones are available on weekends?”* 5. Application calls the same API again with the new query 6. Conversation continues seamlessly using prior context  ---  ## **One-Line Summary**  > Executes a conversational query over xfloor content, returning context-aware, filtered, and optionally summarized results with support for multi-turn interactions.  
+   * @param {module:model/QueryRequest} queryRequest 
+   * @param {module:api/QueryApi~queryCallback} callback The callback function, accepting three arguments: error, data, response
+   * data is of type: {@link module:model/QueryResponse}
+   */
+  return _createClass(QueryApi, [{
+    key: "query",
+    value: function query(queryRequest, callback) {
+      var postBody = queryRequest;
+      // verify the required parameter 'queryRequest' is set
+      if (queryRequest === undefined || queryRequest === null) {
+        throw new Error("Missing the required parameter 'queryRequest' when calling query");
+      }
+      var pathParams = {};
+      var queryParams = {};
+      var headerParams = {};
+      var formParams = {};
+      var authNames = ['bearer'];
+      var contentTypes = ['application/json'];
+      var accepts = ['application/json'];
+      var returnType = _QueryResponse["default"];
+      return this.apiClient.callApi('/agent/memory/query', 'POST', pathParams, queryParams, headerParams, formParams, postBody, authNames, contentTypes, accepts, returnType, null, callback);
+    }
+  }]);
+}();