@moss-js/moss 1.8.0

package/LICENSE.txt

@@ -0,0 +1,168 @@
+Copyright (c) 2025 InferEdge Inc.
+Required Notice: Copyright InferEdge Inc. (https://inferedge.dev)
+Licensor Line of Business: InferEdge MOSS Runtime (https://inferedge.dev)
+
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing any
+product that competes with the software or any product the
+licensor or any of its affiliates provides using the software.
+
+## Competition
+
+Goods and services compete even when they provide functionality
+through different kinds of interfaces or for different technical
+platforms.  Applications can compete with services, libraries
+with plugins, frameworks with development tools, and so on,
+even if they're written in different programming languages
+or for different computer architectures.  Goods and services
+compete even when provided free of charge.  If you market a
+product as a practical substitute for the software or another
+product, it definitely competes.
+
+## New Products
+
+If you are using the software to provide a product that does
+not compete, but the licensor or any of its affiliates brings
+your product into competition by providing a new version of
+the software or another product using the software, you may
+continue using versions of the software available under these
+terms beforehand to provide your competing product, but not
+any later versions.
+
+## Discontinued Products
+
+You may begin using the software to compete with a product
+or service that the licensor or any of its affiliates has
+stopped providing, unless the licensor includes a plain-text
+line beginning with `Licensor Line of Business:` with the
+software that mentions that line of business.  For example:
+
+> Licensor Line of Business: YoyodyneCMS Content Management
+System (http://example.com/cms)
+
+## Sales of Business
+
+If the licensor or any of its affiliates sells a line of
+business developing the software or using the software
+to provide a product, the buyer can also enforce
+[Noncompete](#noncompete) for that product.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+A **product** can be a good or service, or a combination
+of them.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+its affiliates.
+
+**Affiliates** means the other organizations than an
+organization has control over, is under the control of, or is
+under common control with.
+
+**Control** means ownership of substantially all the assets of
+an entity, or the power to direct its management and policies
+by vote, contract, or otherwise.  Control can be direct or
+indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,258 @@
+# Moss client library for JavaScript
+
+
+`@moss-js/moss` enables **private, on-device semantic search** in your web, mobile, and edge applications - without cloud dependencies.
+
+Built for developers who want **instant, memory-efficient, privacy-first AI features** inside their apps.
+
+## ✨ Features
+
+- ⚡ **On-Device Vector Search** - Sub-millisecond retrieval with zero network latency
+- 🔍 **Semantic Search & Hybrid Search** - Beyond keyword matching
+- 📦 **Multi-Index Support** - Manage multiple isolated search spaces
+- 🛠️ **Tiny SDK** - Optimized for edge deployments
+- 🛡️ **Privacy-First by Design** - No server-side cloud calls required to perform searches
+
+## 📦 Installation
+
+```bash
+npm install @moss-js/moss
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { MossClient, DocumentInfo } from "@moss-js/moss";
+
+async function main() {
+  // Initialize search client with project credentials
+  const mossClient = new MossClient(
+    "your-project-id",
+    "your-project-key"
+  );
+
+  // Prepare documents to index
+  const documents: DocumentInfo[] = [
+    {
+      id: "doc1",
+      text: "How do I track my order? You can track your order by logging into your account.",
+    },
+    {
+      id: "doc2", 
+      text: "What is your return policy? We offer a 30-day return policy for most items.",
+    },
+    {
+      id: "doc3",
+      text: "How can I change my shipping address? Contact our customer service team.",
+    },
+    // Add more documents here
+    // .
+    // .
+    // .
+  ];
+
+  try {
+    // Create an index with documents and model
+    const indexName = "faqs";
+    const created = await mossClient.createIndex(
+      indexName,
+      documents
+    ); // Defaults to the service's `moss-minilm` model when omitted
+    console.log("Index created:", created);
+
+    // Load the index before searching
+    await mossClient.loadIndex(indexName);
+
+    // Search the index
+    const result = await mossClient.query(indexName, "How do I return a damaged product?", {
+      topK: 3,
+    });
+
+    // Display results
+    console.log(`Query: ${result.query}`);
+    result.docs.forEach((match) => {
+      console.log(`Score: ${match.score.toFixed(4)}`);
+      console.log(`ID: ${match.id}`);
+      console.log(`Text: ${match.text}`);
+      console.log("---");
+    });
+  } finally {
+    // Release the client's underlying resources once you're done with it
+    await mossClient.close();
+  }
+}
+
+main().catch(console.error);
+```
+
+To use a host-managed stable id for MAD billing while retaining Moss's own
+device UUID for correlation:
+
+```typescript
+const mossClient = new MossClient("project", "key", {
+  identity: { deviceId: "host-installation-id", userId: "optional-user-id" },
+});
+```
+
+`deviceId` is billable. `userId` is optional and non-billable. Telemetry also
+includes Moss's file-backed UUID as `mossDeviceId`; without a host id, both
+device fields contain that Moss UUID.
+
+## Resource cleanup
+
+`MossClient` and sessions returned by `client.session(...)` hold native resources that must be released explicitly. Call `close()` on each one when you are done with it, in a `finally` block or equivalent. `close()` is idempotent, so it is safe to call more than once.
+
+`client.close()` also closes every live session created from that client. Closing a session individually first is fine; `close()` is idempotent on both.
+
+On Node 24 and later, both `MossClient` and sessions implement `Symbol.asyncDispose`, so you can use `await using` instead of a manual `try/finally`:
+
+```typescript
+await using mossClient = new MossClient("your-project-id", "your-project-key");
+// mossClient.close() is called automatically when it goes out of scope
+```
+
+## 🔥 Example Use Cases
+
+- Smart knowledge base search
+- Realtime Voice AI agents
+- Personal note-taking search
+- Private in-app AI features (recommendations, retrieval)
+- Local semantic search in edge devices, AR/VR, mobile apps
+
+## 🧠 Providing custom embeddings
+
+Already using your own embedding model? Supply vectors directly when managing indexes:
+
+```typescript
+const documents = [
+  {
+    id: "doc-1",
+    text: "Attach a caller-provided embedding",
+    embedding: myEmbeddingModel("doc-1"),
+  },
+  {
+    id: "doc-2",
+    text: "Fallback to the built-in model when the field is omitted.",
+  },
+];
+
+await mossClient.createIndex("custom-embeddings", documents);
+
+await mossClient.loadIndex("custom-embeddings");
+
+const results = await mossClient.query("custom-embeddings", "", {
+  embedding: myEmbeddingModel("query"),
+  topK: 10,
+});
+```
+
+Leaving `modelId` undefined defaults to `moss-minilm`. You can still pass `{ modelId: "moss-mediumlm" }` or another supported identifier if you want the service to generate embeddings for documents without the optional `embedding` field.
+
+### Foundation model identity
+
+Moss generates local query embeddings for a foundation-model index only when
+the service supplies the exact immutable model artifact identity used to build
+that index. This prevents a query from being embedded with different model
+bytes than the stored document vectors.
+
+Fresh local sessions using `moss-minilm`, `moss-mediumlm`, or `moss-litelm`
+bind that model's official current artifact automatically before model warmup.
+Caller-supplied artifact identities are validated and kept, while custom models
+are never auto-bound. `saveToDisk` records the exact model id, artifact version,
+and manifest SHA-256, so the same session can be restored and queried with raw
+text:
+
+```typescript
+const first = await mossClient.session("memory");
+await first.addDocs([{ id: "refund", text: "Customer requested a refund" }]);
+await first.saveToDisk(cachePath);
+await first.close();
+
+const restored = await mossClient.session("memory");
+await restored.loadFromDisk(cachePath);
+const results = await restored.query("refund");
+```
+
+Session caches created by older SDKs without an artifact version and manifest
+SHA-256 load as `custom` sessions through the legacy fail-closed path. Their raw
+text queries require an explicit caller-generated embedding. Rebuild those
+caches from their source documents with the current SDK, then save them again
+so the automatically bound foundation identity is persisted.
+
+Older indexes without that identity still load and remain queryable, but the
+query must include a caller-generated vector of the correct dimension:
+
+```typescript
+const results = await mossClient.query("legacy-index", "search text", {
+  embedding: myEmbeddingModel("search text"),
+  topK: 10,
+});
+```
+
+If the vector is omitted, the query fails closed with an error stating that an
+explicit query embedding is required. Moss does not silently fall back to an
+unverified local model or send the query to the cloud.
+
+## Multi-index search
+
+Search several loaded indexes in one call and get the global top-k back, with
+each result tagged by its source `indexName`. All indexes must be loaded
+locally and share the same embedding model.
+
+```typescript
+const { loaded, failed } = await mossClient.loadIndexes(["products", "reviews"]);
+if (loaded.length === 0) {
+  throw new Error(`No indexes loaded: ${JSON.stringify(failed)}`);
+}
+
+const results = await mossClient.queryMultiIndex(
+  loaded,
+  "noise cancelling headphones",
+  { topK: 5, alpha: 0.5 },
+);
+for (const doc of results.docs) {
+  console.log(`[${doc.indexName}] ${doc.id}: ${doc.text} (score: ${doc.score.toFixed(3)})`);
+}
+
+await mossClient.unloadIndexes(loaded);
+```
+
+`alpha` works exactly as in `query` (default 0.8): `1.0` is embedding-only,
+`0.0` is keyword-only, and anything in between blends both with Reciprocal
+Rank Fusion. Keyword scoring runs each index's own BM25 and merges each index's
+raw hits before fusion; because BM25 statistics stay per-corpus, cross-index
+keyword ranking is approximate. `topK` (default 10) caps the merged result, not
+each index, and `filter` applies to every index. `loadIndexes` is best-effort:
+names that fail are reported in `failed` without rolling back the ones that
+loaded.
+
+## Metadata filtering
+
+You can pass a metadata filter in `query` options after loading an index locally:
+
+```typescript
+const results = await mossClient.query("my-docs", "running shoes", {
+  topK: 5,
+  alpha: 0.6,
+  filter: {
+    $and: [
+      { field: "category", condition: { $eq: "shoes" } },
+      { field: "price", condition: { $lt: "100" } },
+    ],
+  },
+});
+```
+
+For a complete runnable example, see `javascript/user-facing-sdk/samples/metadata-filtering.ts`.
+
+## 📄 License
+
+This package is licensed under the [PolyForm Shield License 1.0.0](./LICENSE.txt).
+
+- ✅ Free for testing, evaluation, internal use, and modifications.
+- ❌ Not permitted for production or competing commercial use.
+- 📩 For commercial licenses, contact: <contact@inferedge.dev>
+
+## 📬 Contact
+
+For support, commercial licensing, or partnership inquiries, contact us: [contact@inferedge.dev](mailto:contact@inferedge.dev)

package/dist/index.esm.js

@@ -0,0 +1 @@
+const _0x310639=_0xc99c;(function(_0x2c71b3,_0x32fbcb){const _0x525940=_0xc99c,_0x36d657=_0x2c71b3();while(!![]){try{const _0x288ade=-parseInt(_0x525940(0x111))/0x1*(-parseInt(_0x525940(0x130))/0x2)+-parseInt(_0x525940(0x11c))/0x3+-parseInt(_0x525940(0x14f))/0x4*(-parseInt(_0x525940(0x146))/0x5)+-parseInt(_0x525940(0x174))/0x6+parseInt(_0x525940(0x153))/0x7+parseInt(_0x525940(0x15a))/0x8+-parseInt(_0x525940(0x105))/0x9;if(_0x288ade===_0x32fbcb)break;else _0x36d657['push'](_0x36d657['shift']());}catch(_0x5ab3d6){_0x36d657['push'](_0x36d657['shift']());}}}(_0x5ac6,0x82534));import{JobStatus as _0x3d66c2}from'@moss-js/moss-core';import*as _0x4323ad from'@moss-js/moss-core';import*as _0x145da4 from'@moss-js/moss-core';var p=_0x145da4,le=p['MODEL_DOWNLOAD_URL'],ce=p[_0x310639(0xcc)],me=p[_0x310639(0xd1)],O=p[_0x310639(0x11e)],he=typeof process<'u'&&process[_0x310639(0x173)]['MOSS_INDEX_URL']||p[_0x310639(0xe7)],E=typeof process<'u'?process[_0x310639(0x173)]:{},I=class{constructor(_0x47df0e,_0x3fc338){const _0x12d412=_0x310639;this[_0x12d412(0xd8)]=_0x47df0e,this['projectKey']=_0x3fc338,this['authUrl']=E[_0x12d412(0xda)]??O;}[_0x310639(0xd8)];[_0x310639(0x131)];[_0x310639(0x13e)];async[_0x310639(0x118)](){const _0x1a4b6d=_0x310639;let _0x2d3787=await fetch(this[_0x1a4b6d(0x13e)],{'method':'POST','headers':{'Content-Type':'application/json'},'body':JSON[_0x1a4b6d(0xf9)]({'projectId':this[_0x1a4b6d(0xd8)],'projectKey':this[_0x1a4b6d(0x131)]}),'signal':AbortSignal[_0x1a4b6d(0x180)](0x7530)});if(_0x2d3787[_0x1a4b6d(0x141)]===0x191){let _0x1e15ae=await _0x2d3787['text']();throw new Error(_0x1a4b6d(0x16d)+_0x1e15ae);}if(!_0x2d3787['ok']){let _0x5e8bc4=await _0x2d3787['text']();throw new Error(_0x1a4b6d(0x138)+_0x2d3787[_0x1a4b6d(0x141)]+':\x20'+_0x5e8bc4);}let _0x7d8167=await _0x2d3787[_0x1a4b6d(0xf2)]();return{'token':_0x7d8167[_0x1a4b6d(0xfd)],'expiresIn':_0x7d8167[_0x1a4b6d(0x17e)]};}async[_0x310639(0x181)](){const _0x4537ee=_0x310639;let {token:_0x937e6c}=await this['getAuthToken']();return _0x4537ee(0x134)+_0x937e6c;}},f=class{constructor(_0x524cbc){const _0x1aa186=_0x310639;this[_0x1aa186(0x14b)]=_0x524cbc;}[_0x310639(0x14b)];['cache']=null;[_0x310639(0x13d)]=null;async[_0x310639(0x118)](){const _0x2a3964=_0x310639;if(this[_0x2a3964(0x166)]&&this[_0x2a3964(0x166)]['expiresAt']>Date['now']())return{'token':this[_0x2a3964(0x166)][_0x2a3964(0xfd)],'expiresIn':this[_0x2a3964(0x166)]['expiresIn']};if(this[_0x2a3964(0x13d)])return this[_0x2a3964(0x13d)];this[_0x2a3964(0x13d)]=this[_0x2a3964(0x17c)]();try{return await this[_0x2a3964(0x13d)];}finally{this[_0x2a3964(0x13d)]=null;}}async['getAuthHeader'](){const _0x33ea40=_0x310639;let {token:_0x2b77cd}=await this[_0x33ea40(0x118)]();return _0x33ea40(0x134)+_0x2b77cd;}async['fetchAndCache'](){const _0x43adee=_0x310639;let {token:_0x28d0a7,expiresIn:_0x2cfc9c}=await this[_0x43adee(0x14b)][_0x43adee(0x118)](),_0xf34ec=Date[_0x43adee(0x15f)]()+(_0x2cfc9c-0x3c)*0x3e8;return this[_0x43adee(0x166)]={'token':_0x28d0a7,'expiresIn':_0x2cfc9c,'expiresAt':_0xf34ec},{'token':_0x28d0a7,'expiresIn':_0x2cfc9c};}};import{randomUUID as _0x45dc8a}from'node:crypto';import{existsSync as _0x3074b4,mkdirSync as _0x5f097b,readFileSync as _0xfad778,writeFileSync as _0x417842}from'node:fs';import{homedir as _0x35574e}from'node:os';import{join as _0x1c1cc0,resolve as _0x5261e2}from'node:path';var ee=_0x310639(0xeb),te='.moss',b=0x100,q=/[\p{Cc}\p{Cf}\p{Cs}\uFFFD]/u,L=_0x310639(0xec);function ne(_0x10e0be){const _0x12a8a0=_0x310639;return _0x10e0be['length']>0x0&&_0x10e0be[_0x12a8a0(0x112)]()===_0x10e0be&&!q['test'](_0x10e0be)&&new TextEncoder()[_0x12a8a0(0xc7)](_0x10e0be)[_0x12a8a0(0x17f)]<=b;}function re(_0x328b25){const _0x358584=_0x310639;try{let _0x4e5456=_0x5261e2(_0x328b25),_0x1b16fc=_0x1c1cc0(_0x4e5456,ee);if(_0x3074b4(_0x1b16fc)){let _0x242257=_0xfad778(_0x1b16fc,_0x358584(0x156))['trim']();if(ne(_0x242257))return _0x242257;}_0x5f097b(_0x4e5456,{'recursive':!0x0});let _0x5ee1ab=_0x45dc8a();return _0x417842(_0x1b16fc,_0x5ee1ab,'utf8'),_0x5ee1ab;}catch{return _0x45dc8a();}}function se(_0x5d6e22=process[_0x310639(0x173)]){const _0x23c238=_0x310639;let _0x26414b=_0x5d6e22[_0x23c238(0x17d)]?.[_0x23c238(0x112)]()||_0x5d6e22[_0x23c238(0x148)]?.['trim']()||_0x35574e();return _0x1c1cc0(_0x26414b,te);}function k(_0x25148a,_0x40e772){const _0x2b51d9=_0x310639;if(_0x25148a!==void 0x0){if(typeof _0x25148a!='string'||_0x25148a[_0x2b51d9(0x137)]===0x0)throw new TypeError(_0x2b51d9(0x109)+_0x40e772+_0x2b51d9(0x117));if(_0x25148a['trim']()!==_0x25148a)throw new TypeError('MossClient\x20options.identity.'+_0x40e772+_0x2b51d9(0x149));if(q[_0x2b51d9(0xd7)](_0x25148a))throw new TypeError('MossClient\x20options.identity.'+_0x40e772+'\x20contains\x20an\x20unsupported\x20character');if(new TextEncoder()['encode'](_0x25148a)[_0x2b51d9(0x17f)]>b)throw new TypeError(_0x2b51d9(0x109)+_0x40e772+_0x2b51d9(0xdf)+b+'\x20UTF-8\x20bytes');return _0x25148a;}}function F(_0x389d30){const _0x3c68b9=_0x310639;if(_0x389d30!==void 0x0){if(_0x389d30===null||typeof _0x389d30!='object'||Array[_0x3c68b9(0x179)](_0x389d30))throw new TypeError(_0x3c68b9(0x145));return Object[_0x3c68b9(0x161)]({'deviceId':k(_0x389d30[_0x3c68b9(0x10f)],_0x3c68b9(0x10f)),'userId':k(_0x389d30['userId'],_0x3c68b9(0xca))});}}function M(_0xabd57c){const _0x13d516=_0x310639;return _0xabd57c?.['deviceId']!==void 0x0||_0xabd57c?.[_0x13d516(0xca)]!==void 0x0;}function j(_0x23197a){const _0x5256ab=_0x310639;if(typeof _0x23197a['setIdentity']!=_0x5256ab(0xf7))throw new Error(L);}function oe(_0x3f2945,_0x2e169a,_0x3f2b4f=process[_0x310639(0x173)]){const _0xe0ed5e=_0x310639;if(_0x3f2945['id'])return _0x3f2945['id'];let _0x4de7d0=_0x2e169a?.[_0xe0ed5e(0x112)]()?_0x2e169a:se(_0x3f2b4f);return _0x3f2945['id']=re(_0x4de7d0),_0x3f2945['id'];}function ie(_0x252057,_0x2bb7fb){const _0x4a2b78=_0x310639;if(typeof _0x252057[_0x4a2b78(0x178)]!=_0x4a2b78(0xf7))return!0x0;try{return _0x252057[_0x4a2b78(0x178)](_0x2bb7fb),!0x0;}catch{return!0x1;}}function v(_0x4b1b10,_0x2cf131,_0x5edca5,_0x4d0fdd=process['env']){const _0x912a12=_0x310639;let _0x4d5aa7=oe(_0x4b1b10,_0x5edca5,_0x4d0fdd);return{'deviceId':_0x2cf131?.[_0x912a12(0x10f)]??_0x4d5aa7,'hostDeviceId':_0x2cf131?.[_0x912a12(0x10f)],'mossDeviceId':_0x4d5aa7,'userId':_0x2cf131?.[_0x912a12(0xca)],'callerSupplied':M(_0x2cf131)};}function P(_0x3fe071,_0xbef8e9){const _0x15c05a=_0x310639;if(typeof _0x3fe071[_0x15c05a(0x17b)]!='function'){if(_0xbef8e9[_0x15c05a(0xe0)])throw new Error(L);return ie(_0x3fe071,_0xbef8e9[_0x15c05a(0x10f)]);}if(!_0xbef8e9[_0x15c05a(0xe0)])try{return _0x3fe071['setIdentity'](null,null,_0xbef8e9[_0x15c05a(0xde)]),!0x0;}catch{return!0x1;}return _0x3fe071[_0x15c05a(0x17b)](_0xbef8e9[_0x15c05a(0xd0)]??null,_0xbef8e9[_0x15c05a(0xca)]??null,_0xbef8e9['mossDeviceId']),!0x0;}function _0xc99c(_0x419c90,_0xef20d9){_0x419c90=_0x419c90-0xc3;const _0x5ac6ba=_0x5ac6();let _0xc99c98=_0x5ac6ba[_0x419c90];return _0xc99c98;}function N(_0x3261f1,_0xef460b,_0x27e018,_0x3d229e,_0xc9b572=process[_0x310639(0x173)]){const _0x294a71=_0x310639;_0xef460b[_0x294a71(0x170)]||(_0xef460b['applied']=P(_0x3261f1,v(_0xef460b,_0x27e018,_0x3d229e,_0xc9b572)));}var ae=0x1;function y(_0x16c0e7){const _0x58a586=_0x310639;let _0x378cdf=_0x16c0e7[_0x58a586(0x124)];if(typeof _0x378cdf!=_0x58a586(0xf7))throw J();let _0x76d7eb=_0x378cdf['call'](_0x16c0e7);if(!Number[_0x58a586(0x186)](_0x76d7eb)||_0x76d7eb<ae)throw J();}function J(){const _0x175017=_0x310639;return new Error(_0x175017(0x172));}var ve=0x708*0x3e8;function A(_0x5996ac){const _0x343264=_0x310639;return _0x5996ac instanceof Error?_0x5996ac[_0x343264(0xf5)]:String(_0x5996ac);}function de(_0x301d55){const _0x3a7aad=_0x310639;if(_0x301d55===null||typeof _0x301d55!=_0x3a7aad(0xf3))return'received\x20'+String(_0x301d55);if(Array[_0x3a7aad(0x179)](_0x301d55))return _0x3a7aad(0x136);let _0x31c9f1=_0x301d55;return typeof _0x31c9f1[_0x3a7aad(0x16a)]!=_0x3a7aad(0x13a)||_0x31c9f1[_0x3a7aad(0x16a)][_0x3a7aad(0x137)]===0x0?_0x3a7aad(0x16b)+String(_0x31c9f1[_0x3a7aad(0x16a)])+')':typeof _0x31c9f1[_0x3a7aad(0x141)]!='string'||_0x31c9f1['status']['length']===0x0?_0x3a7aad(0x133)+String(_0x31c9f1[_0x3a7aad(0x141)])+')':typeof _0x31c9f1[_0x3a7aad(0x100)]!='number'||!Number['isFinite'](_0x31c9f1['progress'])?'received\x20a\x20progress\x20event\x20with\x20a\x20non-finite\x20progress\x20value\x20('+String(_0x31c9f1[_0x3a7aad(0x100)])+')':_0x31c9f1[_0x3a7aad(0xd3)]!==void 0x0&&_0x31c9f1[_0x3a7aad(0xd3)]!==null&&typeof _0x31c9f1[_0x3a7aad(0xd3)]!=_0x3a7aad(0x13a)?_0x3a7aad(0x115)+String(_0x31c9f1[_0x3a7aad(0xd3)])+')':null;}var x=class{[_0x310639(0x101)];[_0x310639(0xef)];[_0x310639(0xc5)];[_0x310639(0xc6)]={'applied':!0x1};['deviceIdCachePath'];['configuredIdentity'];['projectId'];['authNotifyFn'];constructor(_0xdb781e,_0x15d847,_0x231cbf){const _0x41ff0b=_0x310639;this[_0x41ff0b(0xfb)]=F(_0x231cbf?.[_0x41ff0b(0x110)]),this[_0x41ff0b(0x160)]=_0x231cbf?.[_0x41ff0b(0x177)],this[_0x41ff0b(0xd8)]=_0xdb781e;let _0x40062a=typeof _0x15d847==_0x41ff0b(0x13a)?new I(_0xdb781e,_0x15d847):_0x15d847;this[_0x41ff0b(0x101)]=new f(_0x40062a);let _0x48e383=_0x4323ad,_0x32a733=_0x48e383['ManageClient']??_0x48e383[_0x41ff0b(0x165)]?.['ManageClient'],_0x52b544=_0x48e383[_0x41ff0b(0x15d)]??_0x48e383[_0x41ff0b(0x165)]?.[_0x41ff0b(0x15d)];if(!_0x32a733||!_0x52b544)throw new Error('moss-core\x20runtime\x20is\x20missing\x20ManageClient/IndexManager\x20exports');if(typeof _0x15d847=='string')this[_0x41ff0b(0xef)]=new _0x32a733(_0xdb781e,_0x15d847),this[_0x41ff0b(0xc5)]=new _0x52b544(_0xdb781e,_0x15d847);else{let _0x51cc78=_0x48e383['resolveAuthRequest']??_0x48e383['default']?.[_0x41ff0b(0x12b)],_0x37c9de=_0x48e383[_0x41ff0b(0xd6)]??_0x48e383[_0x41ff0b(0x165)]?.[_0x41ff0b(0xd6)];if(!_0x51cc78||!_0x37c9de)throw new Error(_0x41ff0b(0x102));let _0x2942ed=this[_0x41ff0b(0x101)],_0x26c3b1=(_0x2b869e,_0x4a40df)=>{const _0x8609=_0x41ff0b;try{_0x37c9de(_0x2b869e,_0x4a40df);}catch(_0x18c46e){console['warn'](_0x8609(0x168)+_0x2b869e+'\x20could\x20not\x20be\x20settled:\x20'+A(_0x18c46e));}},_0x1926b5=(_0x4bda70,_0x89e129)=>{const _0x208bb7=_0x41ff0b;try{_0x51cc78(_0x4bda70,_0x89e129);}catch(_0x3e6be6){_0x26c3b1(_0x4bda70,_0x208bb7(0x119)+A(_0x3e6be6));}},_0x3da6b7=!0x1,_0x5620fe=(_0x55e3fb,_0x2e88ab)=>{const _0x3ccc2e=_0x41ff0b;if(_0x55e3fb||!Number[_0x3ccc2e(0x186)](_0x2e88ab)||_0x2e88ab<0x0){_0x3da6b7||(_0x3da6b7=!0x0,console[_0x3ccc2e(0x16f)]('[moss]\x20Ignoring\x20an\x20auth\x20request\x20with\x20no\x20usable\x20request\x20id;\x20custom\x20authentication\x20may\x20be\x20unavailable\x20for\x20this\x20client.\x20Cause:\x20'+(_0x55e3fb?_0x55e3fb[_0x3ccc2e(0xf5)]:'received\x20'+String(_0x2e88ab))));return;}_0x2942ed[_0x3ccc2e(0x181)]()[_0x3ccc2e(0x107)](_0x48fba0=>{const _0x31f65c=_0x3ccc2e;let _0x470199=_0x48fba0[_0x31f65c(0x144)](_0x31f65c(0x134))?_0x48fba0[_0x31f65c(0x16e)](0x7):_0x48fba0;_0x1926b5(_0x2e88ab,_0x470199);},_0x39ce54=>_0x26c3b1(_0x2e88ab,A(_0x39ce54)));};this[_0x41ff0b(0xce)]=_0x5620fe;let _0x54d5a6=_0x32a733,_0x5d9c9f=_0x52b544;if(!_0x54d5a6[_0x41ff0b(0x128)]||!_0x5d9c9f['withAuthenticator'])throw new Error(_0x41ff0b(0xe4));this[_0x41ff0b(0xef)]=_0x54d5a6[_0x41ff0b(0x128)](_0xdb781e,_0x5620fe),this['indexManager']=_0x5d9c9f[_0x41ff0b(0x128)](_0xdb781e,_0x5620fe);}M(this[_0x41ff0b(0xfb)])&&j(this['indexManager']);}async[_0x310639(0x135)](){const _0x2e2969=_0x310639;let _0x12d7db=this[_0x2e2969(0xc5)][_0x2e2969(0x135)];if(typeof _0x12d7db!='function')throw new Error(_0x2e2969(0x10e));await _0x12d7db[_0x2e2969(0x11d)](this[_0x2e2969(0xc5)]);}async[_0x310639(0x118)](){const _0x7637df=_0x310639;return this[_0x7637df(0x101)][_0x7637df(0x118)]();}[_0x310639(0x159)](_0x3851f7){if(!_0x3851f7)return;let _0xfb2250=!0x1;return(_0x372424,_0x544a26)=>{const _0x2be256=_0xc99c;let _0x1d4eed=_0x372424?_0x372424[_0x2be256(0xf5)]:de(_0x544a26);if(_0x1d4eed!==null){_0xfb2250||(_0xfb2250=!0x0,console[_0x2be256(0x16f)](_0x2be256(0xc9)+_0x1d4eed));return;}_0x3851f7(_0x544a26);};}[_0x310639(0x157)](_0x230a07){const _0x496626=_0x310639;let _0x3b65a0=_0x230a07['trim']()[_0x496626(0x122)]()[_0x496626(0x176)](/\s+/g,'_'),_0x43be5d=_0x3b65a0['replace'](/_/g,'');if(_0x3b65a0===_0x496626(0x114)||_0x43be5d===_0x496626(0x140))return _0x3d66c2[_0x496626(0x152)];if(_0x3b65a0===_0x496626(0xf1))return _0x3d66c2['Uploading'];if(_0x3b65a0===_0x496626(0x188))return _0x3d66c2[_0x496626(0xf4)];if(_0x3b65a0==='completed')return _0x3d66c2[_0x496626(0x113)];if(_0x3b65a0==='failed')return _0x3d66c2['Failed'];throw new Error(_0x496626(0xfa)+_0x230a07+_0x496626(0x126));}async[_0x310639(0xd2)](_0x20c3ac,_0x58e7fc,_0x592c8e,_0x309c04){const _0x249812=_0x310639;if(!_0x58e7fc['length'])throw new Error(_0x249812(0xe3));return await this['manageClient']['createIndex'](_0x20c3ac,_0x58e7fc,_0x592c8e,this[_0x249812(0x159)](_0x309c04?.[_0x249812(0xe9)]));}async[_0x310639(0x11a)](_0x426401){const _0x5ca9cc=_0x310639;if(_0x426401 instanceof Uint8Array)return Array[_0x5ca9cc(0xdc)](_0x426401);if(_0x426401 instanceof ArrayBuffer)return Array[_0x5ca9cc(0xdc)](new Uint8Array(_0x426401));if(typeof _0x426401[_0x5ca9cc(0x10b)]=='function'){let _0x236b63=await _0x426401[_0x5ca9cc(0x10b)]();return Array[_0x5ca9cc(0xdc)](new Uint8Array(_0x236b63));}throw new Error(_0x5ca9cc(0xfe));}async[_0x310639(0x10a)](_0x394d3f,_0x184bce,_0x836772){const _0x3555b4=_0x310639;if(_0x184bce[_0x3555b4(0x137)]===0x0)throw new Error(_0x3555b4(0x108));let _0x1852f6=_0x836772?.['modelId']??_0x3555b4(0xcb),_0x189a76=await Promise[_0x3555b4(0xf6)](_0x184bce[_0x3555b4(0x150)](async _0x5c9b25=>({'name':_0x5c9b25[_0x3555b4(0x16c)],'contentType':_0x5c9b25[_0x3555b4(0xd5)],'path':_0x5c9b25[_0x3555b4(0x11b)]??void 0x0,'data':_0x5c9b25[_0x3555b4(0x17a)]!=null?await this[_0x3555b4(0x11a)](_0x5c9b25[_0x3555b4(0x17a)]):void 0x0})));return await this['manageClient']['createIndexFromFiles'](_0x394d3f,_0x189a76,_0x1852f6,this[_0x3555b4(0x159)](_0x836772?.[_0x3555b4(0xe9)]),_0x836772?.[_0x3555b4(0xcf)]??null);}async['addDocs'](_0x3b4cce,_0x4cf916,_0xc1eca5){const _0xaccc3e=_0x310639;if(Array[_0xaccc3e(0x179)](_0x4cf916)&&_0x4cf916[_0xaccc3e(0x137)]===0x0)throw new Error(_0xaccc3e(0xdd));return await this['manageClient'][_0xaccc3e(0x164)](_0x3b4cce,_0x4cf916,_0xc1eca5??null,this[_0xaccc3e(0x159)](_0xc1eca5?.[_0xaccc3e(0xe9)]));}async[_0x310639(0x14d)](_0x4ec181,_0x42384d,_0x7568a9){const _0x5904d1=_0x310639;if(Array[_0x5904d1(0x179)](_0x42384d)&&_0x42384d['length']===0x0)throw new Error(_0x5904d1(0xd4));return await this['manageClient'][_0x5904d1(0x14d)](_0x4ec181,_0x42384d,this['wrapProgress'](_0x7568a9?.[_0x5904d1(0xe9)]));}async[_0x310639(0xe2)](_0x5dbc7a){const _0x1da798=_0x310639;let _0x135d80=await this[_0x1da798(0xef)][_0x1da798(0xe2)](_0x5dbc7a);return{..._0x135d80,'status':this[_0x1da798(0x157)](_0x135d80[_0x1da798(0x141)]),'currentPhase':_0x135d80[_0x1da798(0xd3)]??null,'error':_0x135d80[_0x1da798(0xc3)]??null};}async[_0x310639(0x185)](_0x42c868){const _0x92076e=_0x310639;return this[_0x92076e(0xef)][_0x92076e(0x185)](_0x42c868);}async['listIndexes'](){const _0x16e4c8=_0x310639;return this[_0x16e4c8(0xef)]['listIndexes']();}async[_0x310639(0x175)](_0x227d3e){const _0x2b58de=_0x310639;return this[_0x2b58de(0xef)]['deleteIndex'](_0x227d3e);}async[_0x310639(0xc8)](_0xb8931e,_0x19ca2e){const _0x1d5bf6=_0x310639;return this[_0x1d5bf6(0xef)][_0x1d5bf6(0xc8)](_0xb8931e,_0x19ca2e??null);}async[_0x310639(0x158)](_0x59cf5f,_0x5a44a3){const _0x327c85=_0x310639;this[_0x327c85(0x10d)](_0x5a44a3?.['cachePath']);let _0xfd32a2=await this[_0x327c85(0xc5)][_0x327c85(0x158)](_0x59cf5f,_0x5a44a3??null);return _0xfd32a2[_0x327c85(0x182)]['id']!==_0x327c85(0x154)&&await this['indexManager']['loadQueryModel'](_0x59cf5f),_0xfd32a2[_0x327c85(0x16c)];}async[_0x310639(0x15c)](_0x5e05f1,_0x11c619){const _0xc6729e=_0x310639;let _0x47894a=this[_0xc6729e(0x12f)]();return this[_0xc6729e(0x10d)](_0x11c619?.[_0xc6729e(0x177)]),_0x47894a[_0xc6729e(0x15c)](_0x5e05f1,_0x11c619??null);}async[_0x310639(0xd9)](_0x364421){const _0x46af63=_0x310639;return this[_0x46af63(0xc5)][_0x46af63(0xd9)](_0x364421);}async[_0x310639(0x120)](_0x1a06b1){const _0x4d8741=_0x310639;return this[_0x4d8741(0x12f)]()[_0x4d8741(0x120)](_0x1a06b1);}[_0x310639(0x12f)](){const _0x5c1552=_0x310639;let _0x328eff=this[_0x5c1552(0xc5)];if(typeof _0x328eff[_0x5c1552(0x155)]!='function'||typeof _0x328eff['queryMultiIndexText']!=_0x5c1552(0xf7)||typeof _0x328eff['loadIndexes']!='function'||typeof _0x328eff['unloadIndexes']!=_0x5c1552(0xf7))throw new Error(_0x5c1552(0x167));return{'queryMultiIndex':_0x328eff[_0x5c1552(0x155)][_0x5c1552(0x15b)](_0x328eff),'queryMultiIndexText':_0x328eff[_0x5c1552(0x12c)][_0x5c1552(0x15b)](_0x328eff),'loadIndexes':_0x328eff['loadIndexes'][_0x5c1552(0x15b)](_0x328eff),'unloadIndexes':_0x328eff[_0x5c1552(0x120)]['bind'](_0x328eff)};}[_0x310639(0x10d)](_0x1684b5){const _0x479814=_0x310639;N(this['indexManager'],this[_0x479814(0xc6)],this[_0x479814(0xfb)],this['deviceIdCachePath']??_0x1684b5);}[_0x310639(0xcd)](){const _0x4cf6d0=_0x310639;return v(this[_0x4cf6d0(0xc6)],this['configuredIdentity'],this[_0x4cf6d0(0x160)]);}[_0x310639(0x171)](){const _0x5c3441=_0x310639;return this[_0x5c3441(0xce)]!==void 0x0;}async[_0x310639(0xe1)](_0x482722,_0x356da0,_0x3ae24c){const _0x1efd05=_0x310639;if(!this[_0x1efd05(0xce)])throw new Error(_0x1efd05(0x14a));let _0x46e109=_0x4323ad,_0x46a6c1=_0x46e109[_0x1efd05(0x139)]??_0x46e109[_0x1efd05(0x165)]?.[_0x1efd05(0x139)];if(!_0x46a6c1||typeof _0x46a6c1['withAuthenticator']!=_0x1efd05(0xf7))throw new Error(_0x1efd05(0x162));return _0x3ae24c&&y(_0x46a6c1),_0x46a6c1[_0x1efd05(0x128)](_0x482722,_0x356da0,this[_0x1efd05(0xd8)],this[_0x1efd05(0xce)],null,null,_0x3ae24c?.[_0x1efd05(0x12e)]??null,_0x3ae24c?.[_0x1efd05(0xff)]??null);}async['query'](_0x3db233,_0x1ff752,_0x2f06c1){const _0x24f871=_0x310639;if(!await this[_0x24f871(0xc5)][_0x24f871(0xf8)](_0x3db233))throw new Error(_0x24f871(0x142)+_0x3db233+'\x22\x20is\x20not\x20loaded.\x20Call\x20loadIndex(\x22'+_0x3db233+_0x24f871(0xee));let _0x58d2d6=_0x2f06c1?.[_0x24f871(0xc4)]??0x5,_0x2c3f3c=_0x2f06c1?.[_0x24f871(0x151)]??0.8;return _0x2f06c1?.[_0x24f871(0xfc)]?this[_0x24f871(0xc5)][_0x24f871(0x14c)](_0x3db233,_0x1ff752,_0x2f06c1[_0x24f871(0xfc)],_0x58d2d6,_0x2c3f3c,_0x2f06c1?.[_0x24f871(0xe6)]):this[_0x24f871(0xc5)][_0x24f871(0x127)](_0x3db233,_0x1ff752,_0x58d2d6,_0x2c3f3c,_0x2f06c1?.[_0x24f871(0xe6)]);}async[_0x310639(0x155)](_0xb2446f,_0xbcd82b,_0x152f14){const _0x54007d=_0x310639;if(_0xb2446f[_0x54007d(0x137)]===0x0)throw new Error(_0x54007d(0xdb));let _0x1fe07c=this['requireMultiIndexCore'](),_0x4336c7=_0x152f14?.[_0x54007d(0xc4)]??0xa,_0x42ee40=_0x152f14?.[_0x54007d(0x151)]??0.8;if(_0x152f14?.[_0x54007d(0xfc)])return _0x1fe07c[_0x54007d(0x155)](_0xb2446f,_0xbcd82b,_0x152f14[_0x54007d(0xfc)],_0x4336c7,_0x42ee40,_0x152f14?.[_0x54007d(0xe6)]);try{return await _0x1fe07c[_0x54007d(0x12c)](_0xb2446f,_0xbcd82b,_0x4336c7,_0x42ee40,_0x152f14?.[_0x54007d(0xe6)]);}catch(_0x3c0c87){throw _0x3c0c87 instanceof Error&&_0x3c0c87[_0x54007d(0xf5)][_0x54007d(0x129)](_0x54007d(0xe5))?new Error(_0x3c0c87['message']+_0x54007d(0x123),{'cause':_0x3c0c87}):_0x3c0c87 instanceof Error&&_0x3c0c87[_0x54007d(0xf5)][_0x54007d(0x129)](_0x54007d(0xed))?new Error('One\x20or\x20more\x20indexes\x20use\x20custom\x20embeddings.\x20Provide\x20a\x20query\x20vector\x20via\x20options.embedding,\x20or\x20use\x20alpha\x200\x20for\x20keyword-only\x20search.',{'cause':_0x3c0c87}):_0x3c0c87;}}};function _0x5ac6(){const _0x2f13f2=['token','Unsupported\x20data\x20type\x20for\x20file\x20upload','manifestSha256','progress','authenticator','moss-core\x20runtime\x20is\x20missing\x20resolveAuthRequest/rejectAuthRequest\x20exports.\x20Ensure\x20you\x20are\x20using\x20a\x20moss-core\x20build\x20that\x20supports\x20custom\x20authenticators.','addDocumentsText','clear','11389680MXXVZm','updated','then','createIndexFromFiles\x20requires\x20at\x20least\x20one\x20file','MossClient\x20options.identity.','createIndexFromFiles','arrayBuffer','asyncDispose','applyIdentityToManager','@moss-js/moss-core\x20>=\x200.20.0\x20is\x20required\x20for\x20MossClient.close()','deviceId','identity','1jPWKjS','trim','Completed','pending_upload','received\x20a\x20progress\x20event\x20with\x20a\x20non-string\x20currentPhase\x20(','Documents\x20missing\x20.embedding\x20for\x20custom\x20model:\x20','\x20must\x20be\x20a\x20non-empty\x20string','getAuthToken','moss-core\x20rejected\x20the\x20auth\x20token:\x20','toByteArray','path','1188729OhDsHi','call','CLOUD_API_AUTH_URL','add','unloadIndexes','This\x20session\x20uses\x20custom\x20embeddings.\x20Provide\x20a\x20query\x20embedding\x20via\x20QueryOptions.embedding.','toLowerCase','\x20Provide\x20a\x20query\x20vector\x20via\x20options.embedding,\x20or\x20use\x20alpha\x200\x20for\x20keyword-only\x20search.','modelArtifactContractVersion','_create','\x27\x20returned\x20by\x20moss-core','queryText','withAuthenticator','includes','modelId','resolveAuthRequest','queryMultiIndexText','delete','version','requireMultiIndexCore','678698ULlwWT','projectKey','_warmModel','received\x20a\x20progress\x20event\x20with\x20a\x20missing\x20or\x20empty\x20status\x20(','Bearer\x20','close','received\x20an\x20array\x20where\x20a\x20JobProgress\x20object\x20was\x20expected','length','HTTP\x20','SessionIndex','string','join','docCount','inflight','authUrl','added','pendingupload','status','Index\x20\x22','deref','startsWith','MossClient\x20options.identity\x20must\x20be\x20an\x20object','25fmhmJG','upsert','USERPROFILE','\x20must\x20not\x20have\x20leading\x20or\x20trailing\x20whitespace','createAuthenticatedSessionInner\x20requires\x20a\x20custom\x20IAuthenticator\x20client','inner','query','deleteDocs','loadModel','283652tkMAGG','map','alpha','PendingUpload','7423227tIrisY','custom','queryMultiIndex','utf8','normalizeJobStatus','loadIndex','wrapProgress','6610720IyLKCO','bind','loadIndexes','IndexManager','_fromInner','now','deviceIdCachePath','freeze','moss-core\x20runtime\x20SessionIndex\x20is\x20missing\x20the\x20withAuthenticator\x20factory.\x20Upgrade\x20@moss-js/moss-core\x20to\x20a\x20build\x20that\x20supports\x20custom\x20authenticators\x20for\x20sessions.','create','addDocs','default','cache','The\x20installed\x20@moss-js/moss-core\x20does\x20not\x20support\x20multi-index\x20operations\x20(queryMultiIndex,\x20loadIndexes,\x20unloadIndexes).\x20Upgrade\x20@moss-js/moss-core.','[moss]\x20Auth\x20request\x20','MossClient\x20is\x20closed','jobId','received\x20a\x20progress\x20event\x20with\x20a\x20missing\x20or\x20empty\x20jobId\x20(','name','Authentication\x20failed\x20(HTTP\x20401):\x20','slice','warn','applied','hasCustomAuthenticator','The\x20installed\x20@moss-js/moss-core\x20runtime\x20does\x20not\x20support\x20exact\x20model\x20artifact\x20identities.\x20Upgrade\x20moss-core\x20before\x20creating\x20this\x20session.','env','2310840Jzxriu','deleteIndex','replace','cachePath','setDeviceId','isArray','data','setIdentity','fetchAndCache','HOME','expiresIn','byteLength','timeout','getAuthHeader','model','listIndexes','loadFromDisk','getIndex','isSafeInteger','\x27\x20is\x20closed','building','error','topK','indexManager','deviceIdState','encode','getDocs','[moss]\x20Dropping\x20a\x20malformed\x20job\x20progress\x20event;\x20progress\x20reporting\x20may\x20be\x20incomplete\x20for\x20this\x20operation.\x20Cause:\x20','userId','moss-minilm','SDK_VERSION_NUMBER','resolveIdentityForSession','authNotifyFn','parseOptions','hostDeviceId','CLOUD_API_IDENTITY_URL','createIndex','currentPhase','deleteDocs\x20requires\x20at\x20least\x20one\x20document\x20ID','contentType','rejectAuthRequest','test','projectId','unloadIndex','MOSS_AUTH_URL','queryMultiIndex\x20requires\x20at\x20least\x20one\x20index\x20name','from','addDocs\x20requires\x20at\x20least\x20one\x20document','mossDeviceId','\x20must\x20be\x20at\x20most\x20','callerSupplied','createAuthenticatedSessionInner','getJobStatus','createIndex\x20requires\x20at\x20least\x20one\x20document','moss-core\x20runtime\x20ManageClient/IndexManager\x20is\x20missing\x20withAuthenticator\x20factory.\x20Ensure\x20you\x20are\x20using\x20a\x20moss-core\x20build\x20that\x20supports\x20custom\x20authenticators.','no\x20exact\x20artifact\x20identity','filter','CLOUD_API_INDEX_URL','@moss-js/moss-core\x20>=\x200.20.0\x20is\x20required\x20for\x20SessionIndex.close()','onProgress','.\x20All\x20documents\x20must\x20have\x20.embedding\x20set\x20when\x20using\x20modelId=\x27custom\x27.','.moss-device-id','The\x20installed\x20@moss-js/moss-core\x20does\x20not\x20support\x20MossClient\x20identity.\x20Install\x20the\x20exact\x20@moss-js/moss-core\x20version\x20required\x20by\x20@moss-js/moss.','requires\x20explicit\x20query\x20embeddings','\x22)\x20or\x20loadIndexes([...])\x20before\x20querying;\x20queries\x20run\x20locally\x20and\x20there\x20is\x20no\x20cloud\x20query\x20fallback.','manageClient','saveToDisk','uploading','json','object','Building','message','all','function','hasIndex','stringify','Unsupported\x20job\x20status\x20\x27','configuredIdentity','embedding'];_0x5ac6=function(){return _0x2f13f2;};return _0x5ac6();}import{SessionIndex as _0x2c922d}from'@moss-js/moss-core';var h=class r{#e;#r;#s;#o=!0x1;#i;constructor(_0x18622e,_0x295f09,_0x1d20c4){this.#s=_0x18622e,this.#r=_0x295f09,this.#e=_0x1d20c4;}static async[_0x310639(0x125)](_0x1c94a4,_0x183055,_0x17285c,_0x361db4,_0x3d5dab,_0x4deaf6,_0xf425e8){const _0x3df0bc=_0x310639;let _0xca9954=_0x2c922d;_0xf425e8&&y(_0xca9954);let _0x2515e9=await _0xca9954[_0x3df0bc(0x163)](_0x1c94a4,_0x183055,_0x17285c,_0x361db4,_0x3d5dab??null,_0xf425e8?.[_0x3df0bc(0x12e)]??null,_0xf425e8?.['manifestSha256']??null);return r['_fromInner'](_0x1c94a4,_0x183055,_0x2515e9,_0x4deaf6);}static[_0x310639(0x15e)](_0x383c73,_0x52bf2e,_0x1a796d,_0x7b29f1){return _0x7b29f1&&P(_0x1a796d,_0x7b29f1),new r(_0x383c73,_0x52bf2e,_0x1a796d);}get[_0x310639(0x16c)](){return this.#s;}get[_0x310639(0x13c)](){const _0x1a8091=_0x310639;return this.#n(),this.#e[_0x1a8091(0x13c)];}get[_0x310639(0x12a)](){return this.#r;}async[_0x310639(0x164)](_0x5ba041,_0x3d7f65){const _0x1189c6=_0x310639;this.#n();let _0x200028=_0x3d7f65?{'upsert':_0x3d7f65[_0x1189c6(0x147)]??!0x0}:void 0x0;if(this.#r===_0x1189c6(0x154)){let _0x2fe1f5=r.#a(_0x5ba041),_0x7c0a5e=_0x5ba041[_0x1189c6(0x150)](_0x2cde9a=>{const _0x308c91=_0x1189c6;let _0x4c7a16={..._0x2cde9a};return delete _0x4c7a16[_0x308c91(0xfc)],_0x4c7a16;}),_0x37ed0b=this.#e['addDocuments'](_0x7c0a5e,_0x2fe1f5,_0x200028);return{'added':_0x37ed0b[_0x1189c6(0x13f)],'updated':_0x37ed0b[_0x1189c6(0x106)]};}let _0xd97bdf=this.#e[_0x1189c6(0x103)](_0x5ba041,_0x200028);return{'added':_0xd97bdf['added'],'updated':_0xd97bdf[_0x1189c6(0x106)]};}async[_0x310639(0x14d)](_0x317854){return this.#n(),this.#e['deleteDocuments'](_0x317854);}async[_0x310639(0xc8)](_0x28ce78){return this.#n(),this.#e['getDocuments'](_0x28ce78??null);}async[_0x310639(0x14c)](_0x2e829b,_0x3eb3ca){const _0x5a5061=_0x310639;this.#n();let _0x15c972=_0x3eb3ca?.[_0x5a5061(0xc4)]??0x5,_0xaf66ba=_0x3eb3ca?.[_0x5a5061(0x151)]??0.8,_0x1686f0=_0x3eb3ca?.[_0x5a5061(0xe6)]??null,_0x2d878a=_0x3eb3ca?.[_0x5a5061(0xfc)];if(_0x2d878a==null){if(this.#r===_0x5a5061(0x154))throw new Error(_0x5a5061(0x121));return this.#e[_0x5a5061(0x127)](_0x2e829b,_0x15c972,_0xaf66ba,_0x1686f0);}return this.#e[_0x5a5061(0x14c)](_0x2e829b,_0x15c972,Array[_0x5a5061(0xdc)](_0x2d878a),_0xaf66ba,_0x1686f0);}async[_0x310639(0x158)](_0x42acaf,_0x1af35d){const _0x57c35d=_0x310639;return this.#n(),this.#e[_0x57c35d(0x158)](_0x42acaf,_0x1af35d??null);}async['pushIndex'](){return this.#n(),this.#e['pushIndex']();}async[_0x310639(0xf0)](_0x5d6c32){this.#n(),this.#e['saveToDisk'](_0x5d6c32);}async[_0x310639(0x184)](_0x2a3d37){return this.#n(),this.#e['loadFromDisk'](_0x2a3d37);}#n(){const _0x547c1a=_0x310639;if(this.#o)throw new Error('SessionIndex\x20\x27'+this.#s+_0x547c1a(0x187));}[_0x310639(0x135)](){return this.#i??=this.#t(),this.#i;}async #t(){const _0x1e2595=_0x310639;this.#o=!0x0;let _0x41accf=this.#e[_0x1e2595(0x135)];if(typeof _0x41accf!=_0x1e2595(0xf7))throw new Error(_0x1e2595(0xe8));await _0x41accf[_0x1e2595(0x11d)](this.#e);}async[Symbol['asyncDispose']](){const _0x24e8b2=_0x310639;return this[_0x24e8b2(0x135)]();}async[_0x310639(0x132)](){const _0x2e4aea=_0x310639;this.#n(),this.#r!=='custom'&&this.#e[_0x2e4aea(0x14e)]();}static#a(_0x2fff69){const _0xb5acda=_0x310639;let _0x216629=_0x2fff69['filter'](_0x58c0b1=>!_0x58c0b1[_0xb5acda(0xfc)]||_0x58c0b1[_0xb5acda(0xfc)][_0xb5acda(0x137)]===0x0)[_0xb5acda(0x150)](_0x4f1bd7=>_0x4f1bd7['id']);if(_0x216629['length']>0x0)throw new Error(_0xb5acda(0x116)+_0x216629[_0xb5acda(0x13b)](',\x20')+_0xb5acda(0xea));return _0x2fff69['map'](_0x48d65b=>Array[_0xb5acda(0xdc)](_0x48d65b[_0xb5acda(0xfc)]??[]));}},B=_0x310639(0xcb),S=class{#e;#r;#s;#o=!0x1;#i;#n=new Set();constructor(_0x166d0e,_0x42c519,_0x445436){const _0x35181f=_0x310639;this.#e=new x(_0x166d0e,_0x42c519,_0x445436),this.#r=_0x166d0e,this.#s=typeof _0x42c519==_0x35181f(0x13a)?_0x42c519:null;}async[_0x310639(0x118)](){const _0x5c2755=_0x310639;return this.#t(),this.#e[_0x5c2755(0x118)]();}async[_0x310639(0xd2)](_0x5b61a4,_0x129496,_0x1ac73c){const _0x53acd6=_0x310639;this.#t();let _0xd99223;return _0x1ac73c?.[_0x53acd6(0x12a)]!==void 0x0?_0xd99223=_0x1ac73c[_0x53acd6(0x12a)]:_0xd99223=_0x129496['some'](_0x44ca4e=>Array[_0x53acd6(0x179)](_0x44ca4e[_0x53acd6(0xfc)])&&_0x44ca4e['embedding'][_0x53acd6(0x137)]>0x0)?_0x53acd6(0x154):B,this.#e[_0x53acd6(0xd2)](_0x5b61a4,_0x129496,_0xd99223,_0x1ac73c);}async[_0x310639(0x10a)](_0x10c758,_0x5af78f,_0x41f0ef){const _0x5581e0=_0x310639;return this.#t(),this.#e[_0x5581e0(0x10a)](_0x10c758,_0x5af78f,_0x41f0ef);}async['getIndex'](_0x46a224){const _0x209e8a=_0x310639;return this.#t(),this.#e[_0x209e8a(0x185)](_0x46a224);}async[_0x310639(0x183)](){return this.#t(),this.#e['listIndexes']();}async[_0x310639(0x175)](_0x3bea95){const _0xab3f47=_0x310639;return this.#t(),this.#e[_0xab3f47(0x175)](_0x3bea95);}async[_0x310639(0x164)](_0x422cce,_0xc4b14b,_0x3b306b){const _0x53c823=_0x310639;return this.#t(),this.#e[_0x53c823(0x164)](_0x422cce,_0xc4b14b,_0x3b306b);}async[_0x310639(0x14d)](_0xb5b6b3,_0x2a4ea9,_0x268ac6){return this.#t(),this.#e['deleteDocs'](_0xb5b6b3,_0x2a4ea9,_0x268ac6);}async[_0x310639(0xe2)](_0x4ab7a8){const _0x3fdb46=_0x310639;return this.#t(),this.#e[_0x3fdb46(0xe2)](_0x4ab7a8);}async[_0x310639(0xc8)](_0x23f2f0,_0x58427a){const _0xd6f08e=_0x310639;return this.#t(),this.#e[_0xd6f08e(0xc8)](_0x23f2f0,_0x58427a);}async[_0x310639(0x158)](_0x1aff41,_0x43b1bb){const _0x481ecd=_0x310639;return this.#t(),this.#e[_0x481ecd(0x158)](_0x1aff41,_0x43b1bb);}async[_0x310639(0x15c)](_0x356f56,_0x590a68){const _0x9fa35b=_0x310639;return this.#t(),this.#e[_0x9fa35b(0x15c)](_0x356f56,_0x590a68);}async[_0x310639(0xd9)](_0x372ca1){const _0x2e0a82=_0x310639;return this.#t(),this.#e[_0x2e0a82(0xd9)](_0x372ca1);}async['unloadIndexes'](_0x4df792){const _0x2e092d=_0x310639;return this.#t(),this.#e[_0x2e092d(0x120)](_0x4df792);}async[_0x310639(0x14c)](_0x44ee7c,_0x3516b7,_0x26a59a){const _0x33bdf2=_0x310639;return this.#t(),this.#e[_0x33bdf2(0x14c)](_0x44ee7c,_0x3516b7,_0x26a59a);}async[_0x310639(0x155)](_0x3b724e,_0x3376e6,_0x126de6){const _0x33b21a=_0x310639;return this.#t(),this.#e[_0x33b21a(0x155)](_0x3b724e,_0x3376e6,_0x126de6);}async['session'](_0x4bdb29,_0x4dd7cb=B,_0x2adad5){const _0x384ee0=_0x310639;this.#t();let _0x501511=this.#e[_0x384ee0(0xcd)](),_0x36425c;if(this.#s!==null)_0x36425c=await h[_0x384ee0(0x125)](_0x4bdb29,_0x4dd7cb,this.#r,this.#s,void 0x0,_0x501511,_0x2adad5);else{let _0x5054c7=await this.#e[_0x384ee0(0xe1)](_0x4bdb29,_0x4dd7cb,_0x2adad5);_0x36425c=h['_fromInner'](_0x4bdb29,_0x4dd7cb,_0x5054c7,_0x501511);}await _0x36425c[_0x384ee0(0x132)]();for(let _0x3967db of this.#n)_0x3967db[_0x384ee0(0x143)]()||this.#n[_0x384ee0(0x12d)](_0x3967db);return this.#n[_0x384ee0(0x11f)](new WeakRef(_0x36425c)),_0x36425c;}#t(){const _0x3a8944=_0x310639;if(this.#o)throw new Error(_0x3a8944(0x169));}['close'](){return this.#i??=this.#a(),this.#i;}async #a(){const _0x57008f=_0x310639;this.#o=!0x0;let _0x2df3a0=[...this.#n][_0x57008f(0x150)](_0x4d935b=>_0x4d935b['deref']())[_0x57008f(0xe6)](_0x30b2d4=>_0x30b2d4!==void 0x0);this.#n[_0x57008f(0x104)](),await Promise[_0x57008f(0xf6)](_0x2df3a0[_0x57008f(0x150)](_0x3eec42=>_0x3eec42[_0x57008f(0x135)]())),await this.#e[_0x57008f(0x135)]();}async[Symbol[_0x310639(0x10c)]](){const _0x3382e8=_0x310639;return this[_0x3382e8(0x135)]();}};export{S as MossClient,h as SessionIndex};

package/dist/moss.d.ts

@@ -0,0 +1,794 @@
+/// <reference lib="esnext.disposable" />
+
+import { DocumentInfo } from '@moss-js/moss-core';
+import { GetDocumentsOptions } from '@moss-js/moss-core';
+import type { IndexInfo } from '@moss-js/moss-core';
+import { JobPhase } from '@moss-js/moss-core';
+import { JobStatus } from '@moss-js/moss-core';
+import { JobStatusResponse } from '@moss-js/moss-core';
+import { LoadSessionOptions } from '@moss-js/moss-core';
+import { MutationResult } from '@moss-js/moss-core';
+import { PushIndexResult } from '@moss-js/moss-core';
+import { QueryOptions } from '@moss-js/moss-core';
+import { QueryResultDocumentInfo } from '@moss-js/moss-core';
+import { RefreshResult } from '@moss-js/moss-core';
+import { SearchResult } from '@moss-js/moss-core';
+import { SessionIndex as SessionIndex_2 } from '@moss-js/moss-core';
+
+export declare interface AuthToken {
+    token: string;
+    expiresIn: number;
+}
+
+/**
+ * Options for creating an index from files via the parse pipeline.
+ */
+export declare interface CreateIndexFromFilesOptions {
+    /**
+     * Embedding model to use. Defaults to "moss-minilm".
+     * "custom" is not supported — the parse pipeline generates embeddings server-side.
+     */
+    modelId?: "moss-minilm" | "moss-mediumlm";
+    /**
+     * Extraction controls, including OCR mode. Omit for server defaults.
+     */
+    parseOptions?: ParseOptions;
+    /**
+     * Callback invoked with progress updates (~every 2s) while the server is processing.
+     */
+    onProgress?: (progress: JobProgress) => void;
+}
+
+/**
+ * Options for creating an index.
+ */
+export declare interface CreateIndexOptions {
+    /**
+     * Embedding model to use. Defaults to "moss-minilm", or "custom" if
+     * documents have pre-computed embeddings.
+     */
+    modelId?: string;
+    /**
+     * Callback invoked with progress updates (~every 2s) while the server is processing.
+     */
+    onProgress?: (progress: JobProgress) => void;
+}
+
+export { DocumentInfo }
+
+export { GetDocumentsOptions }
+
+export declare interface IAuthenticator {
+    getAuthToken(): Promise<AuthToken>;
+    getAuthHeader(): Promise<string>;
+}
+
+/**
+ * ISO 8601 date string format.
+ * @example "2025-09-26T15:04:05Z"
+ */
+export declare type ISODate = string;
+
+export { JobPhase }
+
+/**
+ * Progress update passed to the `onProgress` callback during async operations.
+ */
+export declare interface JobProgress {
+    jobId: string;
+    status: "pending_upload" | "uploading" | "building" | "completed" | "failed";
+    progress: number;
+    currentPhase: "queued" | "crawling" | "parsing_documents" | "parsing" | "waiting_for_parser" | "parsing_complete" | "downloading" | "deserializing" | "generating_embeddings" | "building_index" | "uploading" | "cleanup" | null;
+}
+
+export { JobStatus }
+
+export { JobStatusResponse }
+
+/**
+ * Outcome of a best-effort bulk `loadIndexes` call.
+ */
+export declare interface LoadIndexesResult {
+    /**
+     * Names of indexes that were successfully loaded into memory.
+     */
+    loaded: string[];
+    /**
+     * Names that failed to load, mapping name to error message.
+     */
+    failed: Record<string, string>;
+}
+
+/**
+ * Options for loading an index with auto-refresh configuration.
+ * Note: SDK makes fields optional with defaults, moss-core requires them.
+ */
+export declare interface LoadIndexOptions {
+    /**
+     * Whether to enable auto-refresh polling for this index.
+     * When enabled, the index will periodically check for updates from the cloud.
+     * @default false
+     */
+    autoRefresh?: boolean;
+    /**
+     * Polling interval in seconds. Only used when autoRefresh is true.
+     * @default 600 (10 minutes)
+     */
+    pollingIntervalInSeconds?: number;
+    /**
+     * Filesystem path for caching index data to disk.
+     * When set, downloaded indexes are persisted and reused on subsequent loads
+     * if the cloud data hasn't changed. Auto-refresh also persists to cache.
+     */
+    cachePath?: string;
+}
+
+export { LoadSessionOptions }
+
+/** Exact immutable publisher identity required for local foundation models. */
+export declare interface ModelArtifactIdentity {
+    /** Version embedded in the publisher manifest and immutable artifact URL. */
+    version: string;
+    /** Lowercase SHA-256 digest of the exact publisher manifest bytes. */
+    manifestSha256: string;
+}
+
+/**
+ * MossClient - Async-first semantic search client for vector similarity operations.
+ *
+ * All mutations (createIndex, addDocs, deleteDocs) are async operations
+ * that run server-side and poll until complete.
+ *
+ * @example
+ * ```typescript
+ * import { MossClient } from '@moss-js/moss';
+ *
+ * const client = new MossClient('your-project-id', 'your-project-key');
+ *
+ * // Create an index with documents (polls until complete)
+ * const result = await client.createIndex('docs', [
+ *   { id: '1', text: 'Machine learning fundamentals' },
+ *   { id: '2', text: 'Deep learning neural networks' }
+ * ]);
+ *
+ * // Add docs (polls until complete)
+ * await client.addDocs('docs', [
+ *   { id: '3', text: 'Natural language processing' }
+ * ]);
+ *
+ * // Query the index
+ * await client.loadIndex('docs');
+ * const results = await client.query('docs', 'AI and neural networks');
+ * ```
+ */
+export declare class MossClient {
+    #private;
+    /**
+     * Creates a new MossClient instance.
+     * @param projectId - Your project identifier.
+     * @param projectKey - Your project key (server-side use).
+     * @param options - Optional cache path and stable host identity.
+     */
+    constructor(projectId: string, projectKey: string, options?: MossClientOptions);
+    /**
+     * Creates a new MossClient instance.
+     * @param projectId - Your project identifier.
+     * @param authenticator - Custom IAuthenticator (browser/delegated auth use).
+     * @param options - Optional cache path and stable host identity.
+     */
+    constructor(projectId: string, authenticator: IAuthenticator, options?: MossClientOptions);
+    getAuthToken(): Promise<AuthToken>;
+    /**
+     * Creates a new index with the provided documents via async upload.
+     *
+     * Handles the full flow: init → upload → build → poll until complete.
+     * Returns when the index is ready.
+     *
+     * When all documents have pre-computed embeddings, they are serialized as raw
+     * float32 in the binary upload. When no documents have embeddings, the server
+     * generates embeddings in batches (dimension=0 flow).
+     *
+     * Mixed documents (some with embeddings, some without) are rejected.
+     *
+     * @param indexName - Name of the index to create.
+     * @param docs - Documents, optionally with pre-computed embeddings.
+     * @param options - Optional model ID and progress callback.
+     * @returns Promise that resolves to MutationResult when the index is ready.
+     * @throws {Error} If the index already exists or creation fails.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.createIndex('knowledge-base', [
+     *   { id: 'doc1', text: 'Introduction to AI' },
+     *   { id: 'doc2', text: 'Machine learning basics' }
+     * ], {
+     *   onProgress: (p) => console.log(`${p.status} ${p.progress}%`),
+     * });
+     * ```
+     */
+    createIndex(indexName: string, docs: DocumentInfo[], options?: CreateIndexOptions): Promise<MutationResult>;
+    /**
+     * Creates a new index by uploading raw files for server-side parsing and embedding.
+     *
+     * Handles the full flow: init → upload files → confirm → poll until complete.
+     * Returns when the index is ready.
+     *
+     * @param indexName - Name of the index to create.
+     * @param files - File descriptors. `name` and `contentType` are required on
+     * each; supply either `path` or `data`. Supported types are PDF and DOCX.
+     * @param options - Model ID (defaults to "moss-minilm"), extraction controls
+     * via `parseOptions`, and a progress callback.
+     * @returns Promise that resolves to MutationResult when the index is ready.
+     * @throws {Error} If files is empty, exceeds 20 files, or creation fails.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.createIndexFromFiles('knowledge-base', [
+     *   {
+     *     name: 'report.pdf',
+     *     contentType: 'application/pdf',
+     *     path: '/docs/report.pdf',
+     *   },
+     *   {
+     *     name: 'manual.docx',
+     *     contentType:
+     *       'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+     *     path: '/docs/manual.docx',
+     *   },
+     * ]);
+     * ```
+     *
+     * @example Scanned documents with no text layer need OCR forced on.
+     * ```typescript
+     * await client.createIndexFromFiles('scans', files, {
+     *   parseOptions: { ocrMode: 'full_ocr' },
+     * });
+     * ```
+     */
+    createIndexFromFiles(indexName: string, files: ParseFileInput[], options?: CreateIndexFromFilesOptions): Promise<MutationResult>;
+    /**
+     * Gets information about a specific index.
+     *
+     * @param indexName - Name of the index to retrieve.
+     * @returns Promise that resolves to IndexInfo object.
+     * @throws {Error} If the index does not exist.
+     *
+     * @example
+     * ```typescript
+     * const info = await client.getIndex('knowledge-base');
+     * console.log(`Index has ${info.docCount} documents`);
+     * ```
+     */
+    getIndex(indexName: string): Promise<IndexInfo>;
+    /**
+     * Lists all available indexes.
+     *
+     * @returns Promise that resolves to array of IndexInfo objects.
+     *
+     * @example
+     * ```typescript
+     * const indexes = await client.listIndexes();
+     * indexes.forEach(index => {
+     *   console.log(`${index.name}: ${index.docCount} docs`);
+     * });
+     * ```
+     */
+    listIndexes(): Promise<IndexInfo[]>;
+    /**
+     * Deletes an index and all its data.
+     *
+     * @param indexName - Name of the index to delete.
+     * @returns Promise that resolves to true if successful.
+     * @throws {Error} If the index does not exist.
+     *
+     * @example
+     * ```typescript
+     * const deleted = await client.deleteIndex('old-index');
+     * ```
+     */
+    deleteIndex(indexName: string): Promise<boolean>;
+    /**
+     * Adds or updates documents in an index asynchronously.
+     *
+     * The index rebuild happens server-side. This method polls until
+     * the rebuild is complete and then returns.
+     *
+     * @param indexName - Name of the target index.
+     * @param docs - Documents to add or update.
+     * @param options - Optional configuration (upsert, onProgress callback).
+     * @returns Promise that resolves to MutationResult when the operation is complete.
+     * @throws {Error} If the index does not exist.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.addDocs('knowledge-base', [
+     *   { id: 'new-doc', text: 'New content to index' }
+     * ], { upsert: true });
+     * console.log(`Job ${result.jobId} completed`);
+     * ```
+     */
+    addDocs(indexName: string, docs: DocumentInfo[], options?: MutationOptions): Promise<MutationResult>;
+    /**
+     * Deletes documents from an index by their IDs asynchronously.
+     *
+     * The index rebuild happens server-side. This method polls until
+     * the rebuild is complete and then returns.
+     *
+     * @param indexName - Name of the target index.
+     * @param docIds - Array of document IDs to delete.
+     * @param options - Optional configuration (onProgress callback).
+     * @returns Promise that resolves to MutationResult when the operation is complete.
+     * @throws {Error} If the index does not exist.
+     *
+     * @example
+     * ```typescript
+     * const result = await client.deleteDocs('knowledge-base', ['doc1', 'doc2']);
+     * console.log(`Job ${result.jobId} completed`);
+     * ```
+     */
+    deleteDocs(indexName: string, docIds: string[], options?: MutationOptions): Promise<MutationResult>;
+    /**
+     * Gets the current status of an async job.
+     *
+     * @param jobId - The job ID returned by createIndex, addDocs, or deleteDocs.
+     * @returns Promise that resolves to JobStatusResponse with progress details.
+     *
+     * @example
+     * ```typescript
+     * const status = await client.getJobStatus(jobId);
+     * console.log(`${status.status} — ${status.progress}%`);
+     * ```
+     */
+    getJobStatus(jobId: string): Promise<JobStatusResponse>;
+    /**
+     * Retrieves documents from an index.
+     *
+     * @param indexName - Name of the target index.
+     * @param options - Optional configuration for retrieval.
+     * @returns Promise that resolves to array of documents.
+     * @throws {Error} If the index does not exist.
+     *
+     * @example
+     * ```typescript
+     * // Get all documents
+     * const allDocs = await client.getDocs('knowledge-base');
+     *
+     * // Get specific documents
+     * const specificDocs = await client.getDocs('knowledge-base', {
+     *   docIds: ['doc1', 'doc2']
+     * });
+     * ```
+     */
+    getDocs(indexName: string, options?: GetDocumentsOptions): Promise<DocumentInfo[]>;
+    /**
+     * Downloads an index from the cloud into memory for fast local querying.
+     *
+     * **How it works:**
+     * 1. Fetches the index assets from the cloud
+     * 2. Loads the exact embedding model when the index has an immutable model
+     *    artifact identity
+     * 3. Executes a local similarity match between the query embedding and the retrieved index.
+     *
+     * A foundation index without an exact artifact identity can still be loaded,
+     * but local queries must provide `QueryOptions.embedding`. The client will
+     * not generate an embedding from an unverified model artifact.
+     *
+     * **Why use this?**
+     * - `query()` requires a loaded index; without `loadIndex()` it rejects with a not-loaded error
+     * - With `loadIndex()`: Queries run entirely in-memory (~1-10ms) with no network round-trip
+     *
+     * **Reload behavior:**
+     * If the index is already loaded, calling `loadIndex()` again will:
+     * - Stop any existing auto-refresh polling
+     * - Download a fresh copy from the cloud
+     * - Replace the in-memory index
+     *
+     * **Auto-refresh (optional):**
+     * Enable `autoRefresh: true` to periodically poll the cloud for updates.
+     * When a newer version is detected, the index is automatically hot-swapped
+     * without interrupting queries.
+     *
+     * @param indexName - Name of the index to load.
+     * @param options - Optional configuration including auto-refresh settings.
+     * @returns Promise that resolves to the index name.
+     * @throws {Error} If the index does not exist in the cloud or loading fails.
+     *
+     * @example
+     * ```typescript
+     * // Simple load - enables fast local queries
+     * await client.loadIndex('my-index');
+     *
+     * // Now queries run locally (fast, no network calls)
+     * // A text-only query requires an exact immutable model artifact identity.
+     * const results = await client.query('my-index', 'search text');
+     *
+     * // Load with auto-refresh to keep index up-to-date
+     * await client.loadIndex('my-index', {
+     *   autoRefresh: true,
+     *   pollingIntervalInSeconds: 300, // Check cloud every 5 minutes
+     * });
+     *
+     * // Stop auto-refresh by reloading without the option
+     * await client.loadIndex('my-index');
+     * ```
+     */
+    loadIndex(indexName: string, options?: LoadIndexOptions): Promise<string>;
+    /**
+     * Loads several indexes into memory in one call. Best-effort: a name that
+     * fails (typo, deleted index, download error) is reported in `failed` and
+     * does not roll back the indexes that loaded. `options` apply to the whole
+     * batch, and each distinct embedding model is warmed once.
+     *
+     * @param indexNames - Names of the indexes to load.
+     * @param options - Auto-refresh and cache settings shared by the batch.
+     * @returns `{ loaded, failed }` where `failed` maps a name to its error.
+     *
+     * @example
+     * ```typescript
+     * const { loaded, failed } = await client.loadIndexes(['products', 'reviews']);
+     * ```
+     */
+    loadIndexes(indexNames: string[], options?: LoadIndexOptions): Promise<LoadIndexesResult>;
+    /**
+     * Removes a loaded index from memory and stops its auto-refresh poller.
+     * Subsequent `query` calls for that name fail until it is loaded again.
+     */
+    unloadIndex(indexName: string): Promise<void>;
+    /**
+     * Removes several loaded indexes from memory. Best-effort and idempotent:
+     * names that are not loaded are ignored.
+     */
+    unloadIndexes(indexNames: string[]): Promise<void>;
+    /**
+     * Performs a semantic similarity search against a locally loaded index.
+     *
+     * The index must have been loaded via `loadIndex()` or `loadIndexes()`;
+     * queries run entirely in-memory with no network round-trip. Querying an
+     * index that is not loaded rejects with an error naming the load call.
+     *
+     * Loaded foundation indexes require an exact model artifact identity before
+     * Moss can generate query embeddings locally. For an older identity-less
+     * index, provide a caller-generated vector through `options.embedding`.
+     *
+     * @param indexName - Name of the target index to search.
+     * @param query - The search query text.
+     * @param options - Optional query configuration including topK (default: 5) and embedding overrides.
+     * @returns Promise that resolves to SearchResult with matching documents.
+     * @throws {Error} If the index is not loaded.
+     *
+     * @example
+     * ```typescript
+     * await client.loadIndex('knowledge-base');
+     * const results = await client.query('knowledge-base', 'machine learning');
+     * results.docs.forEach(doc => {
+     *   console.log(`${doc.id}: ${doc.text} (score: ${doc.score})`);
+     * });
+     * ```
+     */
+    query(indexName: string, query: string, options?: QueryOptions): Promise<SearchResult>;
+    /**
+     * Searches several loaded indexes in one call and returns the global top-k
+     * across all of them, with each result's `indexName` set to its source.
+     *
+     * All names must already be loaded (`loadIndex` / `loadIndexes`) and share
+     * the same embedding model; there is no cloud fallback. `options.alpha`
+     * works exactly as in `query` (default 0.8): `1.0` is embedding-only and
+     * returns raw cosine scores, `0.0` is keyword-only, and values in between
+     * fuse both signals with Reciprocal Rank Fusion. Keyword scoring runs each
+     * index's own BM25 and merges hits by score before fusion. `options.topK`
+     * (default 10) caps the merged result, not each index. `options.filter`
+     * applies uniformly to every index.
+     *
+     * @param indexNames - Names of the loaded indexes to search.
+     * @param query - The search query text.
+     * @param options - Optional topK, alpha, embedding, and filter.
+     * @returns SearchResult whose docs carry `indexName`.
+     * @throws {Error} If no names are given, a name is not loaded, or models differ.
+     *
+     * @example
+     * ```typescript
+     * await client.loadIndexes(['products', 'reviews']);
+     * const results = await client.queryMultiIndex(
+     *   ['products', 'reviews'],
+     *   'noise cancelling headphones',
+     *   { topK: 5, alpha: 0.5 },
+     * );
+     * results.docs.forEach(doc => console.log(doc.indexName, doc.id, doc.score));
+     * ```
+     */
+    queryMultiIndex(indexNames: string[], query: string, options?: QueryOptions): Promise<SearchResult>;
+    /**
+     * Create a local-first session index for real-time, in-process indexing
+     * and querying. The session starts empty; call `loadIndex` to pull an
+     * existing cloud index in, `addDocs` to populate, `query` to search,
+     * and `pushIndex` at session end to persist to the cloud.
+     *
+     * @param indexName Logical name for the session. Identifies the cloud
+     *   index when `pushIndex` / `loadIndex` is called.
+     * @param modelId Embedding model to use. Defaults to `moss-minilm`.
+     *   Pass `"custom"` if you'll supply embeddings yourself.
+     *
+     * Works with both a static project key and a custom `IAuthenticator`
+     * (the session authenticates via the same bridge as `loadIndex`).
+     *
+     * @example
+     * ```typescript
+     * const session = await client.session('chat-session-123');
+     * await session.addDocs([{ id: '1', text: 'Customer asked about billing' }]);
+     * const results = await session.query('billing question');
+     * await session.pushIndex();
+     * ```
+     */
+    session(indexName: string, modelId?: MossModel, modelArtifact?: ModelArtifactIdentity): Promise<SessionIndex>;
+    /**
+     * Release the client's native resources (the index manager's loaded
+     * indexes, pollers, and telemetry). Idempotent. All client methods
+     * reject with "MossClient is closed" afterwards. Does not stop the
+     * process-wide shared runtime.
+     *
+     * Also closes every live session created by this client (sessions can
+     * still be closed individually first; close is idempotent).
+     */
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+export declare interface MossClientOptions {
+    /**
+     * Filesystem path under which Moss's stable device UUID persists
+     * (`<cachePath>/.moss-device-id`). It is emitted as `mossDeviceId`, and also
+     * as the billable `deviceId` when no host device id is configured. When
+     * omitted, `loadIndex` can use its `cachePath` only when it resolves the
+     * device ID first; a session created first uses the per-user location. Set
+     * this option to use one path consistently across client and session
+     * telemetry.
+     */
+    cachePath?: string;
+    /**
+     * Stable host identity attached to telemetry from this client and its
+     * sessions. `deviceId` is the billable MAD key. `userId` is optional and
+     * non-billable. Moss's own stable UUID is still sent as `mossDeviceId`.
+     */
+    identity?: MossIdentity;
+}
+
+/**
+ * Caller-managed stable identity for a MossClient lifetime. Supplied values
+ * must be 1-256 UTF-8 bytes with no leading or trailing whitespace, Unicode
+ * control or format characters, lone surrogates, or replacement characters.
+ */
+export declare interface MossIdentity {
+    /** Stable device or app-installation id used for MAD billing. */
+    deviceId?: string;
+    /** Optional non-billable user grouping id. */
+    userId?: string;
+}
+
+/**
+ * Available embedding models for text-to-vector conversion.
+ *
+ * Each model offers different trade-offs between speed, accuracy, and resource usage:
+ *
+ * - **`"moss-minilm"`**: Lightweight model optimized for speed and efficiency.
+ *   Best for applications requiring fast response times with moderate accuracy requirements.
+ *
+ * - **`"moss-mediumlm"`**: Balanced model offering higher accuracy with reasonable performance.
+ *   Best for applications where search quality is important and moderate latency is acceptable.
+ *
+ * - **`"custom"`**: Use this when providing pre-computed embeddings from external sources.
+ *   No embedding model is loaded. All documents must include embeddings, and all queries
+ *   must provide embeddings via QueryOptions.embedding.
+ */
+export declare type MossModel = "moss-minilm" | "moss-mediumlm" | "custom";
+
+/**
+ * Options for async mutation operations (addDocs, deleteDocs).
+ * Extends moss-core MutationOptions with SDK-specific onProgress callback.
+ */
+export declare interface MutationOptions {
+    /**
+     * Whether to update existing documents with the same ID.
+     * Only applies to addDocs.
+     * @default true
+     */
+    upsert?: boolean;
+    /**
+     * Callback invoked with progress updates (~every 2s) while the server is processing.
+     */
+    onProgress?: (progress: JobProgress) => void;
+}
+
+export { MutationResult }
+
+/**
+ * Input descriptor for a single file in the parse pipeline.
+ *
+ * Either `path` (server/Node.js) or `data` (browser) must be provided.
+ * Supported `contentType` values are `"application/pdf"` and
+ * `"application/vnd.openxmlformats-officedocument.wordprocessingml.document"` (DOCX).
+ */
+export declare interface ParseFileInput {
+    /**
+     * File identifier sent to the server. Required.
+     */
+    name: string;
+    /**
+     * MIME content type. Required. Supported values are `"application/pdf"` and
+     * `"application/vnd.openxmlformats-officedocument.wordprocessingml.document"` (DOCX).
+     */
+    contentType: string;
+    /**
+     * Filesystem path to the file (Node.js / server-side).
+     * Required when `data` is not provided.
+     */
+    path?: string;
+    /**
+     * Raw file bytes (browser / in-memory).
+     * Takes precedence over `path` when provided.
+     * Accepts `Uint8Array`, `ArrayBuffer`, `Blob`, or a browser `File` object.
+     */
+    data?: Uint8Array | ArrayBuffer | Blob | File;
+}
+
+/**
+ * Controls how the server extracts text from uploaded documents.
+ *
+ * Every field is optional; omitted fields use the server defaults.
+ */
+export declare interface ParseOptions {
+    /**
+     * Slower, higher fidelity extraction. Useful for dense tables.
+     */
+    useHighResolution?: boolean;
+    /**
+     * How the document is segmented before extraction.
+     */
+    segmentationMethod?: "smart_layout_detection" | "page_by_page";
+    /**
+     * `"full_ocr"` forces OCR on every page, which is what scanned documents
+     * with no text layer need. `"auto_ocr"` runs it only where it looks
+     * necessary.
+     */
+    ocrMode?: "auto_ocr" | "full_ocr";
+    /**
+     * Merge a table split across a page break into a single segment.
+     */
+    mergeTables?: boolean;
+}
+
+export { PushIndexResult }
+
+export { QueryOptions }
+
+export { QueryResultDocumentInfo }
+
+export { RefreshResult }
+
+declare interface ResolvedTelemetryIdentity {
+    /** Billable MAD key: the caller's id when supplied, otherwise Moss's UUID. */
+    deviceId: string;
+    /** Caller-owned device id. Omitted when Moss's UUID remains billable. */
+    hostDeviceId?: string;
+    /** Moss's file-backed stable UUID, always retained for correlation. */
+    mossDeviceId: string;
+    userId?: string;
+    callerSupplied: boolean;
+}
+
+export { SearchResult }
+
+/**
+ * A local in-session index for real-time indexing and querying.
+ *
+ * All operations (`addDocs`, `deleteDocs`, `query`) run entirely in
+ * process memory with no cloud round-trip. Call `pushIndex()` at the
+ * end of a session to persist the result to the cloud.
+ *
+ * @example
+ * ```typescript
+ * const session = await client.session('session-abc');
+ * await session.addDocs([
+ *   { id: '1', text: 'Customer asked about billing' },
+ * ]);
+ * const results = await session.query('billing question');
+ * const result = await session.pushIndex();
+ * ```
+ */
+export declare class SessionIndex {
+    #private;
+    /**
+     * @internal Construct via `MossClient.session()` — direct instantiation
+     * is intentionally unsupported so the auth context flows from the client.
+     */
+    constructor(name: string, modelId: MossModel, inner: SessionIndex_2);
+    /**
+     * @internal Factory used by `MossClient.session()`. Constructs the
+     * underlying Rust `SessionIndex` and wraps it. Async because the
+     * napi `SessionIndex.create` runs credential validation on a
+     * worker thread — `await`ing here keeps the Node main thread
+     * responsive while auth is in flight.
+     */
+    static _create(name: string, modelId: MossModel, projectId: string, projectKey: string, clientId?: string, identity?: ResolvedTelemetryIdentity, modelArtifact?: ModelArtifactIdentity): Promise<SessionIndex>;
+    /**
+     * @internal Wrap an already-constructed core `SessionIndex` — used for the
+     * custom-authenticator path, where `InternalMossClient` builds the core
+     * handle via the auth bridge (`SessionIndex.withAuthenticator`).
+     */
+    static _fromInner(name: string, modelId: MossModel, inner: SessionIndex_2, identity?: ResolvedTelemetryIdentity): SessionIndex;
+    /** The session index name. Identifies the cloud index on `pushIndex` / `loadIndex`. */
+    get name(): string;
+    /** Number of documents currently in the local session. */
+    get docCount(): number;
+    /** The embedding model this session is configured for. */
+    get modelId(): MossModel;
+    /**
+     * Add or update documents in the local session index.
+     *
+     * For models other than `"custom"`, embeddings are generated locally
+     * via the Rust core — no cloud round-trip. For `modelId="custom"`,
+     * each document **must** carry an `.embedding` field.
+     *
+     * @returns `{ added, updated }` counts.
+     */
+    addDocs(docs: DocumentInfo[], options?: MutationOptions): Promise<{
+        added: number;
+        updated: number;
+    }>;
+    /** Delete documents from the local session by id. Returns the number actually removed. */
+    deleteDocs(docIds: string[]): Promise<number>;
+    /** Fetch documents currently in the local session. Pass `options.docIds` to filter. */
+    getDocs(options?: GetDocumentsOptions): Promise<DocumentInfo[]>;
+    /**
+     * Hybrid (keyword + semantic) search over the local session index.
+     * Runs entirely in-memory, no cloud call.
+     *
+     * For `modelId="custom"`, an explicit `options.embedding` is required.
+     * For built-in models the query is embedded locally by the Rust core
+     * if `options.embedding` is omitted.
+     */
+    query(query: string, options?: QueryOptions): Promise<SearchResult>;
+    /**
+     * Load an existing cloud index into the session by name. With
+     * `options.autoRefresh = true`, the SDK polls the cloud index and
+     * pulls newer versions in on subsequent reads; the poller pauses
+     * while local un-pushed edits exist.
+     *
+     * @returns Number of documents loaded into the session.
+     */
+    loadIndex(indexName: string, options?: LoadSessionOptions): Promise<number>;
+    /**
+     * Upload the session to the cloud, creating or replacing the index
+     * with the same name. Documents are pushed with their locally-computed
+     * embeddings — no server-side re-embedding.
+     */
+    pushIndex(): Promise<PushIndexResult>;
+    /**
+     * Persist the session to `<cachePath>/<name>/` for offline reuse
+     * without a cloud round-trip.
+     */
+    saveToDisk(cachePath: string): Promise<void>;
+    /**
+     * Restore a session previously written by `saveToDisk`.
+     * @returns Number of documents loaded.
+     */
+    loadFromDisk(cachePath: string): Promise<number>;
+    /**
+     * Release the session's native resources deterministically: the
+     * auto-refresh poller, the in-memory index, and this session's
+     * reference to the shared embedding model. Safe to call more than
+     * once. Afterwards `name` and `modelId` stay readable (JS-side
+     * metadata); `docCount` and all methods throw "is closed".
+     *
+     * Also invoked by `await using` (Symbol.asyncDispose).
+     */
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * @internal Pre-loads the bundled embedding model for built-in
+     * `modelId`s; no-op for `"custom"`. Called by `MossClient.session()`
+     * so the first `addDocs` / `query` doesn't pay cold-start latency.
+     */
+    _warmModel(): Promise<void>;
+}
+
+export { }

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@moss-js/moss",
+  "version": "1.8.0",
+  "main": "dist/index.esm.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/moss.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/moss.d.ts",
+      "node": "./dist/index.esm.js",
+      "default": "./dist/index.esm.js"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist temp .log",
+    "build": "npm run build:types && npm run build:js && api-extractor run --local",
+    "build:dev": "npm run build:types && npm run build:js",
+    "build:watch": "tsx esbuild.watch.config.ts",
+    "build:types": "tsc --emitDeclarationOnly",
+    "build:js": "tsx esbuild.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/**/*.ts test/**/*.ts",
+    "run-query-sample": "tsx samples/query.ts",
+    "run-multi-index": "tsx samples/multiple-indexes.ts",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "extract-api": "npm run build && api-extractor run --local",
+    "prepack": "npm run clean && npm run build",
+    "docs": "typedoc --options typedoc.json && mkdir -p ../../documentation/docs/public/reference/js/_media && cp LICENSE.txt ../../documentation/docs/public/reference/js/_media/LICENSE.txt"
+  },
+  "files": [
+    "dist/index.esm.js",
+    "dist/moss.d.ts",
+    "README.md",
+    "LICENSE.txt"
+  ],
+  "keywords": [
+    "search",
+    "semantic",
+    "embeddings",
+    "vector",
+    "inferedge"
+  ],
+  "author": "InferEdge Inc.",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "@moss-js/moss-core": "0.24.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@microsoft/api-extractor": "^7.58.9",
+    "@types/javascript-obfuscator": "^0.0.5",
+    "@types/node": "^22.20.0",
+    "dotenv": "^17.4.2",
+    "esbuild": "^0.28.1",
+    "esbuild-plugin-obfuscator": "^1.2.4",
+    "eslint": "^9.39.4",
+    "globals": "^16.5.0",
+    "prettier": "^3.9.4",
+    "rimraf": "^6.1.3",
+    "tsx": "^4.23.0",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.63.0",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=20.4"
+  }
+}