@pairsystems/goodmem-client 1.0.1-beta.2 → 1.0.2

package/dist/client.js

@@ -11,6 +11,7 @@ var _MemoriesApi = _interopRequireDefault(require("./api/MemoriesApi.js"));
 var _SpacesApi = _interopRequireDefault(require("./api/SpacesApi.js"));
 var _SystemApi = _interopRequireDefault(require("./api/SystemApi.js"));
 var _UsersApi = _interopRequireDefault(require("./api/UsersApi.js"));
+var _streaming = require("./streaming.js");
 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"); }
@@ -44,6 +45,9 @@ var Client = exports.Client = /*#__PURE__*/function () {
     this._spacesApi = new _SpacesApi["default"](this._apiClient);
     this._systemApi = new _SystemApi["default"](this._apiClient);
     this._usersApi = new _UsersApi["default"](this._apiClient);
+
+    // Initialize streaming client
+    this._streamingClient = new _streaming.StreamingClient(this._apiClient);
   }
 
   /**
@@ -156,5 +160,16 @@ var Client = exports.Client = /*#__PURE__*/function () {
     value: function getUsersApi() {
       return this._usersApi;
     }
+
+    /**
+     * Gets the Streaming Client for memory streaming operations.
+     * 
+     * @returns {StreamingClient} The StreamingClient instance
+     */
+  }, {
+    key: "getStreamingClient",
+    value: function getStreamingClient() {
+      return this._streamingClient;
+    }
   }]);
 }();

package/dist/index.js

@@ -339,4 +339,5 @@ var _RerankersApi = _interopRequireDefault(require("./api/RerankersApi"));
 var _SpacesApi = _interopRequireDefault(require("./api/SpacesApi"));
 var _SystemApi = _interopRequireDefault(require("./api/SystemApi"));
 var _UsersApi = _interopRequireDefault(require("./api/UsersApi"));
+var _streaming = require("./streaming.js");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }

package/dist/streaming.js

@@ -0,0 +1,649 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.StreamingClient = exports.StreamError = void 0;
+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 _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _possibleConstructorReturn(t, e) { if (e && ("object" == _typeof(e) || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
+function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
+function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
+function _wrapNativeSuper(t) { var r = "function" == typeof Map ? new Map() : void 0; return _wrapNativeSuper = function _wrapNativeSuper(t) { if (null === t || !_isNativeFunction(t)) return t; if ("function" != typeof t) throw new TypeError("Super expression must either be null or a function"); if (void 0 !== r) { if (r.has(t)) return r.get(t); r.set(t, Wrapper); } function Wrapper() { return _construct(t, arguments, _getPrototypeOf(this).constructor); } return Wrapper.prototype = Object.create(t.prototype, { constructor: { value: Wrapper, enumerable: !1, writable: !0, configurable: !0 } }), _setPrototypeOf(Wrapper, t); }, _wrapNativeSuper(t); }
+function _construct(t, e, r) { if (_isNativeReflectConstruct()) return Reflect.construct.apply(null, arguments); var o = [null]; o.push.apply(o, e); var p = new (t.bind.apply(t, o))(); return r && _setPrototypeOf(p, r.prototype), p; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+function _isNativeFunction(t) { try { return -1 !== Function.toString.call(t).indexOf("[native code]"); } catch (n) { return "function" == typeof t; } }
+function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { if (r) i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n;else { var o = function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); }; o("next", 0), o("throw", 1), o("return", 2); } }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+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 _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, 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); }
+function _asyncIterator(r) { var n, t, o, e = 2; for ("undefined" != typeof Symbol && (t = Symbol.asyncIterator, o = Symbol.iterator); e--;) { if (t && null != (n = r[t])) return n.call(r); if (o && null != (n = r[o])) return new AsyncFromSyncIterator(n.call(r)); t = "@@asyncIterator", o = "@@iterator"; } throw new TypeError("Object is not async iterable"); }
+function AsyncFromSyncIterator(r) { function AsyncFromSyncIteratorContinuation(r) { if (Object(r) !== r) return Promise.reject(new TypeError(r + " is not an object.")); var n = r.done; return Promise.resolve(r.value).then(function (r) { return { value: r, done: n }; }); } return AsyncFromSyncIterator = function AsyncFromSyncIterator(r) { this.s = r, this.n = r.next; }, AsyncFromSyncIterator.prototype = { s: null, n: null, next: function next() { return AsyncFromSyncIteratorContinuation(this.n.apply(this.s, arguments)); }, "return": function _return(r) { var n = this.s["return"]; return void 0 === n ? Promise.resolve({ value: r, done: !0 }) : AsyncFromSyncIteratorContinuation(n.apply(this.s, arguments)); }, "throw": function _throw(r) { var n = this.s["return"]; return void 0 === n ? Promise.reject(r) : AsyncFromSyncIteratorContinuation(n.apply(this.s, arguments)); } }, new AsyncFromSyncIterator(r); }
+function _awaitAsyncGenerator(e) { return new _OverloadYield(e, 0); }
+function _wrapAsyncGenerator(e) { return function () { return new AsyncGenerator(e.apply(this, arguments)); }; }
+function AsyncGenerator(e) { var r, t; function resume(r, t) { try { var n = e[r](t), o = n.value, u = o instanceof _OverloadYield; Promise.resolve(u ? o.v : o).then(function (t) { if (u) { var i = "return" === r ? "return" : "next"; if (!o.k || t.done) return resume(i, t); t = e[i](t).value; } settle(n.done ? "return" : "normal", t); }, function (e) { resume("throw", e); }); } catch (e) { settle("throw", e); } } function settle(e, n) { switch (e) { case "return": r.resolve({ value: n, done: !0 }); break; case "throw": r.reject(n); break; default: r.resolve({ value: n, done: !1 }); } (r = r.next) ? resume(r.key, r.arg) : t = null; } this._invoke = function (e, n) { return new Promise(function (o, u) { var i = { key: e, arg: n, resolve: o, reject: u, next: null }; t ? t = t.next = i : (r = t = i, resume(e, n)); }); }, "function" != typeof e["return"] && (this["return"] = void 0); }
+AsyncGenerator.prototype["function" == typeof Symbol && Symbol.asyncIterator || "@@asyncIterator"] = function () { return this; }, AsyncGenerator.prototype.next = function (e) { return this._invoke("next", e); }, AsyncGenerator.prototype["throw"] = function (e) { return this._invoke("throw", e); }, AsyncGenerator.prototype["return"] = function (e) { return this._invoke("return", e); };
+function _OverloadYield(e, d) { this.v = e, this.k = d; }
+/**
+ * GoodMem JavaScript Streaming Client
+ * 
+ * This module provides streaming support for memory retrieval operations,
+ * ported from the Go client implementation.
+ * 
+ * @module StreamingClient
+ * @version 1.0.0
+ */
+/**
+ * StreamingClient provides streaming support for memory retrieval operations
+ */
+var StreamingClient = exports.StreamingClient = /*#__PURE__*/function () {
+  /**
+   * Creates a new streaming client instance
+   * @param {ApiClient} client - The main API client instance
+   */
+  function StreamingClient(client) {
+    _classCallCheck(this, StreamingClient);
+    this.client = client;
+  }
+
+  /**
+   * Streaming formats supported by the client
+   * @readonly
+   * @enum {string}
+   */
+  return _createClass(StreamingClient, [{
+    key: "retrieveMemoryStream",
+    value: (
+    /**
+     * Starts streaming memory retrieval
+     * @param {AbortSignal} signal - Abort signal for cancellation
+     * @param {MemoryStreamRequest} request - The streaming request parameters
+     * @returns {Promise<AsyncIterableIterator<MemoryStreamResponse>>} Async iterator of streaming events
+     */
+    function () {
+      var _retrieveMemoryStream = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(signal, request) {
+        var baseURL, endpoint, params, fullURL, headers, response, errorText;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              if (request) {
+                _context.n = 1;
+                break;
+              }
+              throw new Error('Request cannot be null');
+            case 1:
+              if (request.message) {
+                _context.n = 2;
+                break;
+              }
+              throw new Error('Message is required');
+            case 2:
+              if (!request.format) {
+                request.format = StreamingClient.StreamingFormat.NDJSON;
+              }
+
+              // Build URL and query parameters
+              baseURL = this.client.basePath || 'http://localhost:8080';
+              endpoint = "".concat(baseURL, "/v1/memories:retrieve");
+              params = new URLSearchParams();
+              params.append('message', request.message);
+              if (request.spaceIds && request.spaceIds.length > 0) {
+                params.append('spaceIds', request.spaceIds.join(','));
+              }
+              if (request.requestedSize !== undefined) {
+                params.append('requestedSize', request.requestedSize.toString());
+              }
+              if (request.fetchMemory !== undefined) {
+                params.append('fetchMemory', request.fetchMemory.toString());
+              }
+              if (request.fetchMemoryContent !== undefined) {
+                params.append('fetchMemoryContent', request.fetchMemoryContent.toString());
+              }
+              if (request.generateAbstract !== undefined) {
+                params.append('generateAbstract', request.generateAbstract.toString());
+              }
+              fullURL = "".concat(endpoint, "?").concat(params.toString()); // Set appropriate headers
+              headers = {
+                'Accept': request.format === StreamingClient.StreamingFormat.SSE ? 'text/event-stream' : 'application/x-ndjson'
+              }; // Add authentication headers
+              if (this.client.defaultHeaders) {
+                Object.assign(headers, this.client.defaultHeaders);
+              }
+
+              // Make the fetch request
+              _context.n = 3;
+              return fetch(fullURL, {
+                method: 'GET',
+                headers: headers,
+                signal: signal
+              });
+            case 3:
+              response = _context.v;
+              if (response.ok) {
+                _context.n = 5;
+                break;
+              }
+              _context.n = 4;
+              return response.text();
+            case 4:
+              errorText = _context.v;
+              throw new StreamError(errorText, response.status);
+            case 5:
+              if (!(request.format === StreamingClient.StreamingFormat.SSE)) {
+                _context.n = 6;
+                break;
+              }
+              return _context.a(2, this._processSSEStream(response));
+            case 6:
+              return _context.a(2, this._processNDJSONStream(response));
+            case 7:
+              return _context.a(2);
+          }
+        }, _callee, this);
+      }));
+      function retrieveMemoryStream(_x, _x2) {
+        return _retrieveMemoryStream.apply(this, arguments);
+      }
+      return retrieveMemoryStream;
+    }()
+    /**
+     * Processes NDJSON streaming response
+     * @private
+     * @param {Response} response - The fetch response
+     * @returns {AsyncIterableIterator<MemoryStreamResponse>} Async iterator of events
+     */
+    )
+  }, {
+    key: "_processNDJSONStream",
+    value: function _processNDJSONStream(response) {
+      return _wrapAsyncGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+        var reader, decoder, buffer, _yield$_awaitAsyncGen, done, value, lines, _iterator2, _step2, line, event, _event, _t, _t2, _t3;
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              reader = response.body.getReader();
+              decoder = new TextDecoder();
+              buffer = '';
+              _context2.p = 1;
+            case 2:
+              if (!true) {
+                _context2.n = 15;
+                break;
+              }
+              _context2.n = 3;
+              return _awaitAsyncGenerator(reader.read());
+            case 3:
+              _yield$_awaitAsyncGen = _context2.v;
+              done = _yield$_awaitAsyncGen.done;
+              value = _yield$_awaitAsyncGen.value;
+              if (!done) {
+                _context2.n = 4;
+                break;
+              }
+              return _context2.a(3, 15);
+            case 4:
+              buffer += decoder.decode(value, {
+                stream: true
+              });
+
+              // Process complete lines
+              lines = buffer.split('\n');
+              buffer = lines.pop() || ''; // Keep the last incomplete line
+              _iterator2 = _createForOfIteratorHelper(lines);
+              _context2.p = 5;
+              _iterator2.s();
+            case 6:
+              if ((_step2 = _iterator2.n()).done) {
+                _context2.n = 11;
+                break;
+              }
+              line = _step2.value;
+              if (!line.trim()) {
+                _context2.n = 10;
+                break;
+              }
+              _context2.p = 7;
+              event = JSON.parse(line);
+              _context2.n = 8;
+              return event;
+            case 8:
+              _context2.n = 10;
+              break;
+            case 9:
+              _context2.p = 9;
+              _t = _context2.v;
+              // Skip invalid JSON lines
+              console.warn('Failed to parse JSON line:', line, _t);
+            case 10:
+              _context2.n = 6;
+              break;
+            case 11:
+              _context2.n = 13;
+              break;
+            case 12:
+              _context2.p = 12;
+              _t2 = _context2.v;
+              _iterator2.e(_t2);
+            case 13:
+              _context2.p = 13;
+              _iterator2.f();
+              return _context2.f(13);
+            case 14:
+              _context2.n = 2;
+              break;
+            case 15:
+              if (!buffer.trim()) {
+                _context2.n = 19;
+                break;
+              }
+              _context2.p = 16;
+              _event = JSON.parse(buffer);
+              _context2.n = 17;
+              return _event;
+            case 17:
+              _context2.n = 19;
+              break;
+            case 18:
+              _context2.p = 18;
+              _t3 = _context2.v;
+              console.warn('Failed to parse final JSON:', buffer, _t3);
+            case 19:
+              _context2.p = 19;
+              reader.releaseLock();
+              return _context2.f(19);
+            case 20:
+              return _context2.a(2);
+          }
+        }, _callee2, null, [[16, 18], [7, 9], [5, 12, 13, 14], [1,, 19, 20]]);
+      }))();
+    }
+
+    /**
+     * Processes Server-Sent Events streaming response
+     * @private
+     * @param {Response} response - The fetch response
+     * @returns {AsyncIterableIterator<MemoryStreamResponse>} Async iterator of events
+     */
+  }, {
+    key: "_processSSEStream",
+    value: function _processSSEStream(response) {
+      var _this = this;
+      return _wrapAsyncGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+        var reader, decoder, buffer, _yield$_awaitAsyncGen2, done, value, events, _iterator3, _step3, eventText, event, _event2, _t4;
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
+            case 0:
+              reader = response.body.getReader();
+              decoder = new TextDecoder();
+              buffer = '';
+              _context3.p = 1;
+            case 2:
+              if (!true) {
+                _context3.n = 12;
+                break;
+              }
+              _context3.n = 3;
+              return _awaitAsyncGenerator(reader.read());
+            case 3:
+              _yield$_awaitAsyncGen2 = _context3.v;
+              done = _yield$_awaitAsyncGen2.done;
+              value = _yield$_awaitAsyncGen2.value;
+              if (!done) {
+                _context3.n = 4;
+                break;
+              }
+              return _context3.a(3, 12);
+            case 4:
+              buffer += decoder.decode(value, {
+                stream: true
+              });
+
+              // Process complete events (separated by double newlines)
+              events = buffer.split('\n\n');
+              buffer = events.pop() || ''; // Keep the last incomplete event
+              _iterator3 = _createForOfIteratorHelper(events);
+              _context3.p = 5;
+              _iterator3.s();
+            case 6:
+              if ((_step3 = _iterator3.n()).done) {
+                _context3.n = 8;
+                break;
+              }
+              eventText = _step3.value;
+              if (!eventText.trim()) {
+                _context3.n = 7;
+                break;
+              }
+              event = _this._parseSSEEvent(eventText);
+              if (!event) {
+                _context3.n = 7;
+                break;
+              }
+              _context3.n = 7;
+              return event;
+            case 7:
+              _context3.n = 6;
+              break;
+            case 8:
+              _context3.n = 10;
+              break;
+            case 9:
+              _context3.p = 9;
+              _t4 = _context3.v;
+              _iterator3.e(_t4);
+            case 10:
+              _context3.p = 10;
+              _iterator3.f();
+              return _context3.f(10);
+            case 11:
+              _context3.n = 2;
+              break;
+            case 12:
+              if (!buffer.trim()) {
+                _context3.n = 13;
+                break;
+              }
+              _event2 = _this._parseSSEEvent(buffer);
+              if (!_event2) {
+                _context3.n = 13;
+                break;
+              }
+              _context3.n = 13;
+              return _event2;
+            case 13:
+              _context3.p = 13;
+              reader.releaseLock();
+              return _context3.f(13);
+            case 14:
+              return _context3.a(2);
+          }
+        }, _callee3, null, [[5, 9, 10, 11], [1,, 13, 14]]);
+      }))();
+    }
+
+    /**
+     * Parses a single SSE event
+     * @private
+     * @param {string} eventText - The raw SSE event text
+     * @returns {MemoryStreamResponse|null} Parsed event or null if invalid
+     */
+  }, {
+    key: "_parseSSEEvent",
+    value: function _parseSSEEvent(eventText) {
+      var lines = eventText.split('\n');
+      var eventType = '';
+      var data = '';
+      var _iterator4 = _createForOfIteratorHelper(lines),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var line = _step4.value;
+          if (line.startsWith('event:')) {
+            eventType = line.substring(6).trim();
+          } else if (line.startsWith('data:')) {
+            data = line.substring(5).trim();
+          }
+        }
+
+        // Skip close events and events without data
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+      if (eventType === 'close' || !data) {
+        return null;
+      }
+      try {
+        return JSON.parse(data);
+      } catch (parseError) {
+        console.warn('Failed to parse SSE event data:', data, parseError);
+        return null;
+      }
+    }
+
+    /**
+     * Provides a simplified interface for memory streaming
+     * @param {AbortSignal} signal - Abort signal for cancellation
+     * @param {string} message - The search message
+     * @param {string[]} spaceIds - Array of space IDs to search
+     * @returns {Promise<AsyncIterableIterator<MemoryStreamResponse>>} Async iterator of streaming events
+     */
+  }, {
+    key: "retrieveMemoryStreamSimple",
+    value: (function () {
+      var _retrieveMemoryStreamSimple = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(signal, message, spaceIds) {
+        var request;
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
+            case 0:
+              request = {
+                message: message,
+                spaceIds: spaceIds,
+                format: StreamingClient.StreamingFormat.NDJSON
+              };
+              return _context4.a(2, this.retrieveMemoryStream(signal, request));
+          }
+        }, _callee4, this);
+      }));
+      function retrieveMemoryStreamSimple(_x3, _x4, _x5) {
+        return _retrieveMemoryStreamSimple.apply(this, arguments);
+      }
+      return retrieveMemoryStreamSimple;
+    }()
+    /**
+     * Collects all streaming results into an array
+     * @param {AbortSignal} signal - Abort signal for cancellation
+     * @param {AsyncIterableIterator<MemoryStreamResponse>} stream - The streaming iterator
+     * @returns {Promise<MemoryStreamResponse[]>} Array of all streaming events
+     */
+    )
+  }, {
+    key: "streamWithTimeout",
+    value: (
+    /**
+     * Provides streaming with a timeout
+     * @param {string} message - The search message
+     * @param {string[]} spaceIds - Array of space IDs to search
+     * @param {number} timeoutMs - Timeout in milliseconds
+     * @returns {Promise<MemoryStreamResponse[]>} Array of streaming events
+     */
+    function () {
+      var _streamWithTimeout = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(message, spaceIds, timeoutMs) {
+        var controller, timeoutId, stream, results, _t5;
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
+            case 0:
+              controller = new AbortController();
+              timeoutId = setTimeout(function () {
+                return controller.abort();
+              }, timeoutMs);
+              _context5.p = 1;
+              _context5.n = 2;
+              return this.retrieveMemoryStreamSimple(controller.signal, message, spaceIds);
+            case 2:
+              stream = _context5.v;
+              _context5.n = 3;
+              return StreamingClient.collectStreamResults(controller.signal, stream);
+            case 3:
+              results = _context5.v;
+              clearTimeout(timeoutId);
+              return _context5.a(2, results);
+            case 4:
+              _context5.p = 4;
+              _t5 = _context5.v;
+              clearTimeout(timeoutId);
+              if (!(_t5.name === 'AbortError' || _t5.message === 'Operation was aborted')) {
+                _context5.n = 5;
+                break;
+              }
+              throw new Error('Streaming operation timed out');
+            case 5:
+              throw _t5;
+            case 6:
+              return _context5.a(2);
+          }
+        }, _callee5, this, [[1, 4]]);
+      }));
+      function streamWithTimeout(_x6, _x7, _x8) {
+        return _streamWithTimeout.apply(this, arguments);
+      }
+      return streamWithTimeout;
+    }())
+  }], [{
+    key: "collectStreamResults",
+    value: (function () {
+      var _collectStreamResults = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(signal, stream) {
+        var results, _iteratorAbruptCompletion, _didIteratorError, _iteratorError, _iterator, _step, event, _t6, _t7;
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
+            case 0:
+              results = [];
+              _context6.p = 1;
+              _iteratorAbruptCompletion = false;
+              _didIteratorError = false;
+              _context6.p = 2;
+              _iterator = _asyncIterator(stream);
+            case 3:
+              _context6.n = 4;
+              return _iterator.next();
+            case 4:
+              if (!(_iteratorAbruptCompletion = !(_step = _context6.v).done)) {
+                _context6.n = 7;
+                break;
+              }
+              event = _step.value;
+              if (!(signal && signal.aborted)) {
+                _context6.n = 5;
+                break;
+              }
+              throw new Error('Operation was aborted');
+            case 5:
+              results.push(event);
+            case 6:
+              _iteratorAbruptCompletion = false;
+              _context6.n = 3;
+              break;
+            case 7:
+              _context6.n = 9;
+              break;
+            case 8:
+              _context6.p = 8;
+              _t6 = _context6.v;
+              _didIteratorError = true;
+              _iteratorError = _t6;
+            case 9:
+              _context6.p = 9;
+              _context6.p = 10;
+              if (!(_iteratorAbruptCompletion && _iterator["return"] != null)) {
+                _context6.n = 11;
+                break;
+              }
+              _context6.n = 11;
+              return _iterator["return"]();
+            case 11:
+              _context6.p = 11;
+              if (!_didIteratorError) {
+                _context6.n = 12;
+                break;
+              }
+              throw _iteratorError;
+            case 12:
+              return _context6.f(11);
+            case 13:
+              return _context6.f(9);
+            case 14:
+              _context6.n = 17;
+              break;
+            case 15:
+              _context6.p = 15;
+              _t7 = _context6.v;
+              if (!(_t7.name === 'AbortError' || _t7.message === 'Operation was aborted')) {
+                _context6.n = 16;
+                break;
+              }
+              throw _t7;
+            case 16:
+              throw _t7;
+            case 17:
+              return _context6.a(2, results);
+          }
+        }, _callee6, null, [[10,, 11, 13], [2, 8, 9, 14], [1, 15]]);
+      }));
+      function collectStreamResults(_x9, _x0) {
+        return _collectStreamResults.apply(this, arguments);
+      }
+      return collectStreamResults;
+    }())
+  }]);
+}();
+/**
+ * Request parameters for streaming memory retrieval
+ * @typedef {Object} MemoryStreamRequest
+ * @property {string} message - The search message
+ * @property {string[]} [spaceIds] - Array of space IDs to search
+ * @property {number} [requestedSize] - Maximum number of results to return
+ * @property {boolean} [fetchMemory] - Whether to fetch memory content
+ * @property {boolean} [fetchMemoryContent] - Whether to fetch memory content details
+ * @property {boolean} [generateAbstract] - Whether to generate abstract
+ * @property {string} [format] - Streaming format (ndjson or sse)
+ */
+/**
+ * Streaming response event
+ * @typedef {Object} MemoryStreamResponse
+ * @property {Object} [resultSetBoundary] - Result set boundary information
+ * @property {StreamRetrievedItem} [retrievedItem] - Retrieved item data
+ * @property {Object} [abstractReply] - Abstract reply data
+ * @property {Object} [memoryDefinition] - Memory definition data
+ * @property {Object} [status] - Status information
+ */
+/**
+ * Retrieved item in streaming format
+ * @typedef {Object} StreamRetrievedItem
+ * @property {Object} [memory] - Memory data
+ * @property {StreamChunkReference} [chunk] - Chunk reference data
+ */
+/**
+ * Chunk reference with relevance score
+ * @typedef {Object} StreamChunkReference
+ * @property {string} resultSetId - Result set identifier
+ * @property {Object} chunk - Chunk data
+ * @property {number} memoryIndex - Memory index
+ * @property {number} relevanceScore - Relevance score
+ */
+/**
+ * Error that occurred during streaming
+ */
+_defineProperty(StreamingClient, "StreamingFormat", {
+  NDJSON: 'ndjson',
+  SSE: 'sse'
+});
+var StreamError = exports.StreamError = /*#__PURE__*/function (_Error) {
+  /**
+   * Creates a new StreamError
+   * @param {string} message - Error message
+   * @param {number} code - HTTP status code
+   */
+  function StreamError(message, code) {
+    var _this2;
+    _classCallCheck(this, StreamError);
+    _this2 = _callSuper(this, StreamError, ["Streaming error (code ".concat(code, "): ").concat(message)]);
+    _this2.name = 'StreamError';
+    _this2.code = code;
+    _this2.message = message;
+    return _this2;
+  }
+  _inherits(StreamError, _Error);
+  return _createClass(StreamError);
+}(/*#__PURE__*/_wrapNativeSuper(Error)); // Export the classes and types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pairsystems/goodmem-client",
-  "version": "1.0.1-beta.2",
+  "version": "1.0.2",
   "description": "JavaScript client for GoodMem API",
   "license": "Unlicense",
   "main": "dist/index.js",