@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/chunk-2OQMOIR5.mjs

@@ -0,0 +1,170 @@
+import { A_FrameHashHelper } from './chunk-442DXGOD.mjs';
+import { A_FrameVector } from './chunk-PABEFHCO.mjs';
+import { A_Entity, A_FormatterHelper } from '@adaas/a-concept';
+
+// src/lib/A-FrameNamespace/A-FrameNamespace.constants.ts
+var A_FRAME_DEFAULT_NAMESPACE_KEY = "default";
+var A_FrameNamespaceFeatures = {
+  Load: "_A_FRAME_NAMESPACE_LOAD",
+  Save: "_A_FRAME_NAMESPACE_SAVE",
+  Embed: "_A_FRAME_NAMESPACE_EMBED",
+  Destroy: "_A_FRAME_NAMESPACE_DESTROY"
+};
+var A_FrameNamespace = class extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  // ─── Getters ──────────────────────────────────────────────────────────────
+  get id() {
+    return this.aseid.id;
+  }
+  get name() {
+    return this._name;
+  }
+  get hash() {
+    return this._hash;
+  }
+  get description() {
+    return this._description;
+  }
+  get metadata() {
+    return this._metadata || {};
+  }
+  get vector() {
+    return this._vector;
+  }
+  get embedding() {
+    return this._vector?.values ?? null;
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //--------------------------------------- Computed properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  get aFrameServerVersion() {
+    return this._aFrameServerVersion;
+  }
+  get aFrameVersion() {
+    return this._aFrameVersion;
+  }
+  get isEmbed() {
+    return this._vector !== void 0;
+  }
+  /**
+    * Saves Namespace to storage. The actual implementation of saving is handled by the A_FrameNamespaceFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.
+    * 
+    * @param scope 
+    * @returns 
+    */
+  save(scope) {
+    return this.call(A_FrameNamespaceFeatures.Save, scope);
+  }
+  /**
+   * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameNamespaceFeatures.Destroy feature, which can be implemented by the environment to remove the namespace from the database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  destroy(scope) {
+    return this.call(A_FrameNamespaceFeatures.Destroy, scope);
+  }
+  /**
+   * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameNamespaceFeatures.Load feature, which can be implemented by the environment to retrieve the namespace from the database, file system, or other storage mechanism and populate the entity's properties accordingly.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  async load(scope) {
+    return this.call(A_FrameNamespaceFeatures.Load, scope);
+  }
+  /**
+   * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.
+   * 
+   * @param updates 
+   */
+  update(updates) {
+    if (updates.name) this._name = updates.name;
+    if (updates.description !== void 0) this._description = updates.description;
+    if (updates.metadata !== void 0) this._metadata = updates.metadata;
+  }
+  /**
+   * Generates an embedding vector for the namespace using the A_FrameNamespaceFeatures.Embed feature. This typically involves sending the namespace's content (name + description) to an embedding model and storing the resulting vector in the entity. Once embedded, the namespace can be searched using its vector representation.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  embed(scope) {
+    console.log(`Embedding namespace "${this._name}"...`);
+    return this.call(A_FrameNamespaceFeatures.Embed, scope);
+  }
+  // ─── A_Entity lifecycle ───────────────────────────────────────────────────
+  fromNew(init) {
+    this.aseid = this.generateASEID({
+      id: A_FormatterHelper.toKebabCase(init.name),
+      scope: "a-frame"
+    });
+    this._name = init.name;
+    const hashSource = this._name + (init.description || "") + (init.metadata ? JSON.stringify(init.metadata) : "");
+    this._hash = A_FrameHashHelper.fnv1a(hashSource);
+    this._description = init.description;
+    this._metadata = init.metadata;
+  }
+  fromJSON(serialized) {
+    this._name = serialized.name;
+    this._hash = serialized.hash;
+    this._description = serialized.description;
+    this._metadata = serialized.metadata;
+    this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : void 0;
+    this._embeddedAt = serialized.embeddedAt;
+    this._embeddingModel = serialized.embeddingModel;
+    this._credentialId = serialized.credentialId;
+    this._aFrameVersion = serialized.aFrameVersion;
+    this._aFrameServerVersion = serialized.aFrameServerVersion;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      hash: this._hash,
+      name: this._name,
+      description: this._description,
+      metadata: this._metadata,
+      embedding: this._vector?.values,
+      embeddedAt: this._embeddedAt ?? Date.now(),
+      embeddingModel: this._embeddingModel,
+      credentialId: this._credentialId,
+      aFrameVersion: this._aFrameVersion,
+      aFrameServerVersion: this._aFrameServerVersion
+    };
+  }
+  // ─── Embedding hydration ──────────────────────────────────────────────────
+  hydrateFromRecord(record) {
+    if (record.hash !== this._hash) {
+      throw new Error(
+        `A_FrameNamespace.hydrateFromRecord: hash mismatch for "${this._name}" (expected ${this._hash}, got ${record.hash})`
+      );
+    }
+    this._vector = new A_FrameVector(record.embedding);
+    this._embeddedAt = record.embeddedAt;
+  }
+  hydrateFromEmbedding(embedding, meta) {
+    this._vector = new A_FrameVector(embedding);
+    this._embeddedAt = Date.now();
+    if (meta) {
+      this._embeddingModel = meta.model;
+      this._credentialId = meta.credentialId ?? void 0;
+      this._aFrameVersion = meta.aFrameVersion;
+      this._aFrameServerVersion = meta.aFrameServerVersion;
+    }
+  }
+  /**
+   * Build the text string sent to the embedding model.
+   * Uses name + description so the vector captures semantic intent.
+   */
+  toString() {
+    const parts = [`// namespace: ${this._name}`];
+    if (this._description) parts.push(`// ${this._description}`);
+    return parts.join("\n");
+  }
+};
+
+export { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespace, A_FrameNamespaceFeatures };
+//# sourceMappingURL=chunk-2OQMOIR5.mjs.map
+//# sourceMappingURL=chunk-2OQMOIR5.mjs.map

package/dist/node/chunk-2OQMOIR5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameNamespace/A-FrameNamespace.constants.ts","../../src/lib/A-FrameNamespace/A-FrameNamespace.entity.ts"],"names":[],"mappings":"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","file":"chunk-2OQMOIR5.mjs","sourcesContent":["import { A_FrameNamespace } from \"./A-FrameNamespace.entity\";\n\n\nexport const A_FRAME_DEFAULT_NAMESPACE_KEY = 'default';\n\n\nexport const A_FrameNamespaceFeatures = {\n    Load: '_A_FRAME_NAMESPACE_LOAD',\n    Save: '_A_FRAME_NAMESPACE_SAVE',\n    Embed: '_A_FRAME_NAMESPACE_EMBED',\n    Destroy: '_A_FRAME_NAMESPACE_DESTROY',\n} as const;","import { A_Context, A_Entity, A_FormatterHelper, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport {\n    A_FrameNamespace_Init,\n    A_FrameNamespace_Serialized,\n    A_FrameNamespace_Record,\n    A_FrameNamespace_EmbeddingMeta,\n} from \"./A-FrameNamespace.types\";\nimport { A_FrameHashHelper } from \"@adaas/a-frame/helpers/Hash.helper\";\nimport { A_FrameNamespaceFeatures } from \"./A-FrameNamespace.constants\";\n\n\nexport class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNamespace_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _name!: string;\n    protected _hash!: string;\n    protected _description?: string;\n    protected _metadata?: Record<string, any>;\n    protected _vector?: A_FrameVector;\n    protected _embeddedAt?: number;\n    // ─── Provenance ───────────────────────────────────────────────────────────\n    protected _embeddingModel?: string;\n    protected _credentialId?: string;\n    protected _aFrameVersion?: string;\n    protected _aFrameServerVersion?: string;\n\n\n    // ─── Getters ──────────────────────────────────────────────────────────────\n\n    get id(): string {\n        return this.aseid.id;\n    }\n\n    get name(): string {\n        return this._name;\n    }\n\n    get hash(): string {\n        return this._hash;\n    }\n\n    get description(): string | undefined {\n        return this._description;\n    }\n\n    get metadata(): Record<string, any> {\n        return this._metadata || {};\n    }\n\n    get vector(): A_FrameVector | undefined {\n        return this._vector;\n    }\n\n    get embedding(): Float32Array | null {\n        return this._vector?.values ?? null;\n    }\n\n    //-----------------------------------------------------------------------------------------------------\n    //--------------------------------------- Computed properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    get aFrameServerVersion(): string | undefined {\n        return this._aFrameServerVersion;\n    }\n\n    get aFrameVersion(): string | undefined {\n        return this._aFrameVersion;\n    }\n\n    get isEmbed(): boolean {\n        return this._vector !== undefined;\n    }\n    /**\n      * Saves Namespace to storage. The actual implementation of saving is handled by the A_FrameNamespaceFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.\n      * \n      * @param scope \n      * @returns \n      */\n    save(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameNamespaceFeatures.Save, scope);\n    }\n    /**\n     * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameNamespaceFeatures.Destroy feature, which can be implemented by the environment to remove the namespace from the database, file system, or other storage mechanism.\n     * \n     * @param scope \n     * @returns \n     */\n    destroy(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameNamespaceFeatures.Destroy, scope);\n    }\n    /**\n     * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameNamespaceFeatures.Load feature, which can be implemented by the environment to retrieve the namespace from the database, file system, or other storage mechanism and populate the entity's properties accordingly.\n     * \n     * @param scope \n     * @returns \n     */\n    async load(scope?: A_Scope): Promise<void> {\n        return this.call(A_FrameNamespaceFeatures.Load, scope);\n    }\n    /**\n     * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.\n     * \n     * @param updates \n     */\n    update(updates: Partial<Pick<A_FrameNamespace, 'name' | 'description' | 'metadata'>>): void {\n        if (updates.name) this._name = updates.name;\n        if (updates.description !== undefined) this._description = updates.description;\n        if (updates.metadata !== undefined) this._metadata = updates.metadata;\n    }\n    /**\n     * Generates an embedding vector for the namespace using the A_FrameNamespaceFeatures.Embed feature. This typically involves sending the namespace's content (name + description) to an embedding model and storing the resulting vector in the entity. Once embedded, the namespace can be searched using its vector representation.\n     * \n     * @param scope \n     * @returns \n     */\n    embed(scope?: A_Scope): Promise<void> | void {\n        console.log(`Embedding namespace \"${this._name}\"...`);\n        return this.call(A_FrameNamespaceFeatures.Embed, scope);\n    }\n\n    // ─── A_Entity lifecycle ───────────────────────────────────────────────────\n\n    fromNew(init: A_FrameNamespace_Init): void {\n\n        this.aseid = this.generateASEID({\n            id: A_FormatterHelper.toKebabCase(init.name),\n            scope: 'a-frame',\n        });\n\n        this._name = init.name;\n\n        const hashSource = this._name\n            + (init.description || '')\n            + (init.metadata ? JSON.stringify(init.metadata) : '');\n\n        this._hash = A_FrameHashHelper.fnv1a(hashSource);\n        this._description = init.description;\n        this._metadata = init.metadata;\n    }\n\n    fromJSON(serialized: A_FrameNamespace_Serialized): void {\n        this._name = serialized.name;\n        this._hash = serialized.hash;\n        this._description = serialized.description;\n        this._metadata = serialized.metadata;\n        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;\n        this._embeddedAt = serialized.embeddedAt;\n        this._embeddingModel = serialized.embeddingModel;\n        this._credentialId = serialized.credentialId;\n        this._aFrameVersion = serialized.aFrameVersion;\n        this._aFrameServerVersion = serialized.aFrameServerVersion;\n    }\n\n\n\n    toJSON(): A_FrameNamespace_Serialized {\n        return {\n            ...super.toJSON(),\n            hash: this._hash,\n            name: this._name,\n            description: this._description,\n            metadata: this._metadata,\n            embedding: this._vector?.values,\n            embeddedAt: this._embeddedAt ?? Date.now(),\n            embeddingModel: this._embeddingModel,\n            credentialId: this._credentialId,\n            aFrameVersion: this._aFrameVersion,\n            aFrameServerVersion: this._aFrameServerVersion,\n        };\n    }\n\n\n    // ─── Embedding hydration ──────────────────────────────────────────────────\n\n    hydrateFromRecord(record: A_FrameNamespace_Record): void {\n        if (record.hash !== this._hash) {\n            throw new Error(\n                `A_FrameNamespace.hydrateFromRecord: hash mismatch for \"${this._name}\" ` +\n                `(expected ${this._hash}, got ${record.hash})`\n            );\n        }\n        this._vector = new A_FrameVector(record.embedding);\n        this._embeddedAt = record.embeddedAt;\n    }\n\n    hydrateFromEmbedding(embedding: Float32Array, meta?: A_FrameNamespace_EmbeddingMeta): void {\n        this._vector = new A_FrameVector(embedding);\n        this._embeddedAt = Date.now();\n        if (meta) {\n            this._embeddingModel = meta.model;\n            this._credentialId = meta.credentialId ?? undefined;\n            this._aFrameVersion = meta.aFrameVersion;\n            this._aFrameServerVersion = meta.aFrameServerVersion;\n        }\n    }\n\n    /**\n     * Build the text string sent to the embedding model.\n     * Uses name + description so the vector captures semantic intent.\n     */\n    toString(): string {\n        const parts: string[] = [`// namespace: ${this._name}`];\n        if (this._description) parts.push(`// ${this._description}`);\n        return parts.join('\\n');\n    }\n}\n\n"]}

package/dist/node/chunk-2UI7RJ4Q.mjs

@@ -0,0 +1,207 @@
+import { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespace } from './chunk-AMMQ76RJ.mjs';
+import { A_Fragment, A_Scope, ASEID } from '@adaas/a-concept';
+
+var A_FrameIndex = class _A_FrameIndex extends A_Fragment {
+  constructor() {
+    if (_A_FrameIndex._instance)
+      return _A_FrameIndex._instance;
+    super({ name: "A_FrameIndex" });
+    // -------------------------------------------------------------------------------------
+    // ------------------------------ Instance State --------------------------------------
+    // -------------------------------------------------------------------------------------
+    this.definitions = /* @__PURE__ */ new Map();
+    this.namespaces = /* @__PURE__ */ new Map();
+    this.scope = new A_Scope({ name: "A_FrameIndexScope" });
+  }
+  static get instance() {
+    if (!_A_FrameIndex._instance) {
+      _A_FrameIndex._instance = new _A_FrameIndex();
+    }
+    return _A_FrameIndex._instance;
+  }
+  static get indexSize() {
+    return _A_FrameIndex.instance.indexSize;
+  }
+  // ------------------------------------------------------------------------------------
+  // --------------------Static Access to Instance Methods-------------------------------
+  // ------------------------------------------------------------------------------------
+  static inherit(scope) {
+    _A_FrameIndex.instance.inherit(scope);
+  }
+  static addDefinition(def) {
+    _A_FrameIndex.instance.addDefinition(def);
+  }
+  static getDefinition(nameOrHash) {
+    return _A_FrameIndex.instance.getDefinition(nameOrHash);
+  }
+  static listDefinitions(filter) {
+    return _A_FrameIndex.instance.listDefinitions(filter);
+  }
+  static removeDefinition(def) {
+    _A_FrameIndex.instance.removeDefinition(def);
+  }
+  static addNamespace(namespace) {
+    _A_FrameIndex.instance.addNamespace(namespace);
+  }
+  static getDefaultNamespace() {
+    return _A_FrameIndex.instance.getDefaultNamespace();
+  }
+  static getNamespace(nameOrASEID) {
+    return _A_FrameIndex.instance.getNamespace(nameOrASEID);
+  }
+  static listNamespaces() {
+    return _A_FrameIndex.instance.listNamespaces();
+  }
+  static removeNamespace(namespace) {
+    _A_FrameIndex.instance.removeNamespace(namespace);
+  }
+  static search(vector, options = {}) {
+    return _A_FrameIndex.instance.search(vector, options);
+  }
+  /** Number of loaded records */
+  get indexSize() {
+    return this.definitions.size;
+  }
+  // static searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     return A_FrameIndex.instance.searchByText(query, channel, options);
+  // }
+  // ------------------------------------------------------------------------------------
+  // ------------------------------ Instance Methods ------------------------------------
+  // ------------------------------------------------------------------------------------
+  inherit(scope) {
+    this.scope.inherit(scope);
+  }
+  addDefinition(def) {
+    this.scope.register(def);
+    const existingNamespace = this.namespaces.get(def.namespace.id);
+    if (!existingNamespace) {
+      this.addNamespace(def.namespace);
+    }
+    this.definitions.set(def.id, def);
+  }
+  getDefinition(name) {
+    for (const def of this.definitions.values()) {
+      if (def.name === name) {
+        return def;
+      }
+    }
+    return void 0;
+  }
+  listDefinitions(filter = {}) {
+    const namespaceName = filter.namespace ? typeof filter.namespace === "string" ? ASEID.isASEID(filter.namespace) ? new ASEID(filter.namespace).id : filter.namespace : filter.namespace.id : void 0;
+    return [...this.definitions.values()].filter((r) => !namespaceName || r.namespace.name === namespaceName);
+  }
+  removeDefinition(def) {
+    this.scope.deregister(def);
+  }
+  addNamespace(namespace) {
+    this.scope.register(namespace);
+    this.namespaces.set(namespace.id, namespace);
+  }
+  getNamespace(nameOrASEID) {
+    const targetKey = typeof nameOrASEID === "string" ? ASEID.isASEID(nameOrASEID) ? new ASEID(nameOrASEID).id : nameOrASEID : nameOrASEID.id;
+    return this.namespaces.get(targetKey);
+  }
+  getDefaultNamespace() {
+    let defaultNamespace = this.getNamespace(A_FRAME_DEFAULT_NAMESPACE_KEY);
+    if (!defaultNamespace) {
+      defaultNamespace = new A_FrameNamespace({
+        name: A_FRAME_DEFAULT_NAMESPACE_KEY
+      });
+      this.addNamespace(defaultNamespace);
+    }
+    return defaultNamespace;
+  }
+  listNamespaces() {
+    return [...this.namespaces.values()];
+  }
+  removeNamespace(namespace) {
+    this.scope.deregister(namespace);
+    this.namespaces.delete(namespace.id);
+  }
+  /**
+   * Search by a pre-computed embedding vector (cosine similarity).
+   */
+  search(vector, options = {}) {
+    const { topK = 10, namespace, minScore = 0 } = options;
+    const pool = namespace ? [...this.definitions.values()].filter((r) => r.namespace.id === namespace) : [...this.definitions.values()];
+    const scored = pool.map((r) => ({
+      record: r,
+      score: this.cosineSimilarity(vector, r.vector)
+    }));
+    return scored.filter((s) => s.score >= minScore).sort((a, b) => b.score - a.score).slice(0, topK).map(({ record: r, score }) => ({
+      record: r,
+      score
+    }));
+  }
+  // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {
+  //     const a = vectorA.values ?? new Float32Array();
+  //     const b = vectorB?.values ?? new Float32Array();
+  //     if (a.length !== b.length) {
+  //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);
+  //     }
+  //     let dot = 0, normA = 0, normB = 0;
+  //     for (let i = 0; i < a.length; i++) {
+  //         dot += a[i] * b[i];
+  //         normA += a[i] * a[i];
+  //         normB += b[i] * b[i];
+  //     }
+  //     const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  //     return denom === 0 ? 0 : dot / denom;
+  // }
+  cosineSimilarity(a, b) {
+    if (!b) return 0;
+    const dot = a.dot(b);
+    const mag = a.magnitude() * b.magnitude();
+    return mag === 0 ? 0 : dot / mag;
+  }
+  euclideanDistance(a, b) {
+    this.assertSameLength(a, b);
+    let sum = 0;
+    for (let i = 0; i < a.length; i++) {
+      const diff = a.values[i] - b.values[i];
+      sum += diff * diff;
+    }
+    return Math.sqrt(sum);
+  }
+  nearest(query, vectors, limit = 1) {
+    return [...vectors].map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score).slice(0, limit).map((r) => r.vector);
+  }
+  rank(query, vectors) {
+    return vectors.map((v) => ({
+      vector: v,
+      score: this.cosineSimilarity(query, v)
+    })).sort((a, b) => b.score - a.score);
+  }
+  assertSameLength(a, b) {
+    if (a.length !== b.length) {
+      throw new Error(
+        `Embedding dimension mismatch: ${a.length} vs ${b.length}`
+      );
+    }
+  }
+  /**
+   * Search by plain text — sends the query to the embed server via channel first.
+   */
+  // async searchByText(
+  //     query: string,
+  //     channel: A_FrameChannel,
+  //     options: A_FrameSearchOptions = {},
+  // ): Promise<A_FrameDefinition_SearchResult[]> {
+  //     this.assertLoaded();
+  //     const resp = await channel.embed(query);
+  //     const queryEmbedding = new Float32Array(resp.data[0].embedding);
+  //     return this.search(queryEmbedding, options);
+  // }
+};
+
+export { A_FrameIndex };
+//# sourceMappingURL=chunk-2UI7RJ4Q.mjs.map
+//# sourceMappingURL=chunk-2UI7RJ4Q.mjs.map

package/dist/node/chunk-2UI7RJ4Q.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameIndex/A-FrameIndex.context.ts"],"names":[],"mappings":";;;AASO,IAAM,YAAA,GAAN,MAAM,aAAA,SAAqB,UAAA,CAAW;AAAA,EA6EzC,WAAA,GAAc;AACV,IAAA,IAAI,aAAA,CAAa,SAAA;AACb,MAAA,OAAO,aAAA,CAAa,SAAA;AAExB,IAAA,KAAA,CAAM,EAAE,IAAA,EAAM,cAAA,EAAgB,CAAA;AApBlC;AAAA;AAAA;AAAA,IAAA,IAAA,CAAQ,WAAA,uBAAkD,GAAA,EAAI;AAE9D,IAAA,IAAA,CAAQ,UAAA,uBAAgD,GAAA,EAAI;AAoBxD,IAAA,IAAA,CAAK,QAAQ,IAAI,OAAA,CAAQ,EAAE,IAAA,EAAM,qBAAqB,CAAA;AAAA,EAC1D;AAAA,EAhFA,WAAW,QAAA,GAAyB;AAChC,IAAA,IAAI,CAAC,cAAa,SAAA,EAAW;AACzB,MAAA,aAAA,CAAa,SAAA,GAAY,IAAI,aAAA,EAAa;AAAA,IAC9C;AACA,IAAA,OAAO,aAAA,CAAa,SAAA;AAAA,EACxB;AAAA,EAEA,WAAW,SAAA,GAAoB;AAC3B,IAAA,OAAO,cAAa,QAAA,CAAS,SAAA;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAQ,KAAA,EAAgB;AAC3B,IAAA,aAAA,CAAa,QAAA,CAAS,QAAQ,KAAK,CAAA;AAAA,EACvC;AAAA,EACA,OAAO,cAAc,GAAA,EAA8B;AAC/C,IAAA,aAAA,CAAa,QAAA,CAAS,cAAc,GAAG,CAAA;AAAA,EAC3C;AAAA,EACA,OAAO,cAAc,UAAA,EAAmD;AACpE,IAAA,OAAO,aAAA,CAAa,QAAA,CAAS,aAAA,CAAc,UAAU,CAAA;AAAA,EACzD;AAAA,EACA,OAAO,gBAAgB,MAAA,EAEC;AACpB,IAAA,OAAO,aAAA,CAAa,QAAA,CAAS,eAAA,CAAgB,MAAM,CAAA;AAAA,EACvD;AAAA,EACA,OAAO,iBAAiB,GAAA,EAA8B;AAClD,IAAA,aAAA,CAAa,QAAA,CAAS,iBAAiB,GAAG,CAAA;AAAA,EAC9C;AAAA,EACA,OAAO,aAAa,SAAA,EAAmC;AACnD,IAAA,aAAA,CAAa,QAAA,CAAS,aAAa,SAAS,CAAA;AAAA,EAChD;AAAA,EACA,OAAO,mBAAA,GAAwC;AAC3C,IAAA,OAAO,aAAA,CAAa,SAAS,mBAAA,EAAoB;AAAA,EACrD;AAAA,EACA,OAAO,aAAa,WAAA,EAA2D;AAC3E,IAAA,OAAO,aAAA,CAAa,QAAA,CAAS,YAAA,CAAa,WAAW,CAAA;AAAA,EACzD;AAAA,EACA,OAAO,cAAA,GAAqC;AACxC,IAAA,OAAO,aAAA,CAAa,SAAS,cAAA,EAAe;AAAA,EAChD;AAAA,EACA,OAAO,gBAAgB,SAAA,EAAmC;AACtD,IAAA,aAAA,CAAa,QAAA,CAAS,gBAAgB,SAAS,CAAA;AAAA,EACnD;AAAA,EACA,OAAO,MAAA,CACH,MAAA,EACA,OAAA,GAAgC,EAAC,EACD;AAChC,IAAA,OAAO,aAAA,CAAa,QAAA,CAAS,MAAA,CAAO,MAAA,EAAQ,OAAO,CAAA;AAAA,EACvD;AAAA;AAAA,EAgCA,IAAI,SAAA,GAAoB;AACpB,IAAA,OAAO,KAAK,WAAA,CAAY,IAAA;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,QAAQ,KAAA,EAAgB;AACpB,IAAA,IAAA,CAAK,KAAA,CAAM,QAAQ,KAAK,CAAA;AAAA,EAC5B;AAAA,EAEA,cAAc,GAAA,EAA8B;AACxC,IAAA,IAAA,CAAK,KAAA,CAAM,SAAS,GAAG,CAAA;AAEvB,IAAA,MAAM,oBAAoB,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,GAAA,CAAI,UAAU,EAAE,CAAA;AAC9D,IAAA,IAAI,CAAC,iBAAA,EAAmB;AACpB,MAAA,IAAA,CAAK,YAAA,CAAa,IAAI,SAAS,CAAA;AAAA,IACnC;AAEA,IAAA,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,GAAA,CAAI,EAAA,EAAI,GAAG,CAAA;AAAA,EACpC;AAAA,EAEA,cAAc,IAAA,EAA6C;AAEvD,IAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,WAAA,CAAY,MAAA,EAAO,EAAG;AACzC,MAAA,IAAI,GAAA,CAAI,SAAS,IAAA,EAAM;AACnB,QAAA,OAAO,GAAA;AAAA,MACX;AAAA,IACJ;AAEA,IAAA,OAAO,MAAA;AAAA,EACX;AAAA,EAEA,eAAA,CAAgB,MAAA,GAEZ,EAAC,EAAwB;AACzB,IAAA,MAAM,aAAA,GAAgB,OAAO,SAAA,GACvB,OAAO,OAAO,SAAA,KAAc,QAAA,GACxB,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,SAAS,IAC1B,IAAI,KAAA,CAAM,OAAO,SAAS,CAAA,CAAE,KAC5B,MAAA,CAAO,SAAA,GACX,MAAA,CAAO,SAAA,CAAU,EAAA,GACrB,MAAA;AAEN,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,WAAA,CAAY,QAAQ,CAAA,CAAE,MAAA,CAAO,CAAA,CAAA,KAAK,CAAC,aAAA,IAAiB,CAAA,CAAE,SAAA,CAAU,SAAS,aAAa,CAAA;AAAA,EAC1G;AAAA,EAEA,iBAAiB,GAAA,EAA8B;AAC3C,IAAA,IAAA,CAAK,KAAA,CAAM,WAAW,GAAG,CAAA;AAAA,EAC7B;AAAA,EAEA,aAAa,SAAA,EAAmC;AAC5C,IAAA,IAAA,CAAK,KAAA,CAAM,SAAS,SAAS,CAAA;AAE7B,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,SAAA,CAAU,EAAA,EAAI,SAAS,CAAA;AAAA,EAC/C;AAAA,EAEA,aAAa,WAAA,EAA2D;AACpE,IAAA,MAAM,SAAA,GAAY,OAAO,WAAA,KAAgB,QAAA,GACnC,MAAM,OAAA,CAAQ,WAAW,CAAA,GACrB,IAAI,KAAA,CAAM,WAAW,CAAA,CAAE,EAAA,GACvB,cACJ,WAAA,CAAY,EAAA;AAElB,IAAA,OAAO,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,SAAS,CAAA;AAAA,EACxC;AAAA,EAEA,mBAAA,GAAwC;AAEpC,IAAA,IAAI,gBAAA,GAAmB,IAAA,CAAK,YAAA,CAAa,6BAA6B,CAAA;AACtE,IAAA,IAAI,CAAC,gBAAA,EAAkB;AACnB,MAAA,gBAAA,GAAmB,IAAI,gBAAA,CAAiB;AAAA,QACpC,IAAA,EAAM;AAAA,OACT,CAAA;AACD,MAAA,IAAA,CAAK,aAAa,gBAAgB,CAAA;AAAA,IACtC;AACA,IAAA,OAAO,gBAAA;AAAA,EACX;AAAA,EAEA,cAAA,GAAqC;AACjC,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,UAAA,CAAW,QAAQ,CAAA;AAAA,EACvC;AAAA,EAEA,gBAAgB,SAAA,EAAmC;AAC/C,IAAA,IAAA,CAAK,KAAA,CAAM,WAAW,SAAS,CAAA;AAC/B,IAAA,IAAA,CAAK,UAAA,CAAW,MAAA,CAAO,SAAA,CAAU,EAAE,CAAA;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAMA,MAAA,CACI,MAAA,EACA,OAAA,GAAgC,EAAC,EACD;AAEhC,IAAA,MAAM,EAAE,IAAA,GAAO,EAAA,EAAI,SAAA,EAAW,QAAA,GAAW,GAAE,GAAI,OAAA;AAE/C,IAAA,MAAM,IAAA,GAAO,YACP,CAAC,GAAG,KAAK,WAAA,CAAY,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,OAAK,CAAA,CAAE,SAAA,CAAU,OAAO,SAAS,CAAA,GACvE,CAAC,GAAG,IAAA,CAAK,WAAA,CAAY,MAAA,EAAQ,CAAA;AAEnC,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,CAAA,CAAA,MAAM;AAAA,MAC1B,MAAA,EAAQ,CAAA;AAAA,MACR,KAAA,EAAO,IAAA,CAAK,gBAAA,CAAiB,MAAA,EAAQ,EAAE,MAAM;AAAA,KACjD,CAAE,CAAA;AAEF,IAAA,OAAO,MAAA,CACF,MAAA,CAAO,CAAA,CAAA,KAAK,CAAA,CAAE,KAAA,IAAS,QAAQ,CAAA,CAC/B,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,CAAE,KAAA,GAAQ,EAAE,KAAK,CAAA,CAChC,KAAA,CAAM,CAAA,EAAG,IAAI,CAAA,CACb,GAAA,CAAI,CAAC,EAAE,MAAA,EAAQ,CAAA,EAAG,KAAA,EAAM,MAAO;AAAA,MAC5B,MAAA,EAAQ,CAAA;AAAA,MACR;AAAA,KACJ,CAAE,CAAA;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,gBAAA,CACI,GACA,CAAA,EACM;AACN,IAAA,IAAI,CAAC,GAAG,OAAO,CAAA;AAEf,IAAA,MAAM,GAAA,GAAM,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA;AACnB,IAAA,MAAM,GAAA,GAAM,CAAA,CAAE,SAAA,EAAU,GAAI,EAAE,SAAA,EAAU;AACxC,IAAA,OAAO,GAAA,KAAQ,CAAA,GAAI,CAAA,GAAI,GAAA,GAAM,GAAA;AAAA,EACjC;AAAA,EAEA,iBAAA,CACI,GACA,CAAA,EACM;AACN,IAAA,IAAA,CAAK,gBAAA,CAAiB,GAAG,CAAC,CAAA;AAE1B,IAAA,IAAI,GAAA,GAAM,CAAA;AACV,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK;AAC/B,MAAA,MAAM,OAAO,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA,GAAI,CAAA,CAAE,OAAO,CAAC,CAAA;AACrC,MAAA,GAAA,IAAO,IAAA,GAAO,IAAA;AAAA,IAClB;AACA,IAAA,OAAO,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACxB;AAAA,EAEA,OAAA,CACI,KAAA,EACA,OAAA,EACA,KAAA,GAAQ,CAAA,EACO;AACf,IAAA,OAAO,CAAC,GAAG,OAAO,CAAA,CACb,IAAI,CAAA,CAAA,MAAM;AAAA,MACP,MAAA,EAAQ,CAAA;AAAA,MACR,KAAA,EAAO,IAAA,CAAK,gBAAA,CAAiB,KAAA,EAAO,CAAC;AAAA,MACvC,CAAA,CACD,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAA,CAChC,MAAM,CAAA,EAAG,KAAK,EACd,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,MAAM,CAAA;AAAA,EAC1B;AAAA,EAEA,IAAA,CACI,OACA,OAAA,EAC+C;AAC/C,IAAA,OAAO,OAAA,CACF,IAAI,CAAA,CAAA,MAAM;AAAA,MACP,MAAA,EAAQ,CAAA;AAAA,MACR,KAAA,EAAO,IAAA,CAAK,gBAAA,CAAiB,KAAA,EAAO,CAAC;AAAA,KACzC,CAAE,EACD,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM,CAAA,CAAE,KAAA,GAAQ,CAAA,CAAE,KAAK,CAAA;AAAA,EACzC;AAAA,EAEQ,gBAAA,CACJ,GACA,CAAA,EACF;AACE,IAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ;AACvB,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,CAAA,8BAAA,EAAiC,CAAA,CAAE,MAAM,CAAA,IAAA,EAAO,EAAE,MAAM,CAAA;AAAA,OAC5D;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBJ","file":"chunk-2UI7RJ4Q.mjs","sourcesContent":["import { A_Dependency, A_Fragment, A_Scope, ASEID } from \"@adaas/a-concept\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameNamespace } from \"../A-FrameNamespace/A-FrameNamespace.entity\";\nimport { A_FrameDefinition_SearchResult, A_FrameSearchOptions } from \"./A-FrameIndex.types\";\nimport { A_FrameDefinition } from \"../A-FrameDefinition\";\nimport { A_FRAME_DEFAULT_NAMESPACE_KEY } from \"../A-FrameNamespace/A-FrameNamespace.constants\";\n\n\n\nexport class A_FrameIndex extends A_Fragment {\n\n    private static _instance: A_FrameIndex;\n\n    static get instance(): A_FrameIndex {\n        if (!A_FrameIndex._instance) {\n            A_FrameIndex._instance = new A_FrameIndex();\n        }\n        return A_FrameIndex._instance;\n    }\n\n    static get indexSize(): number {\n        return A_FrameIndex.instance.indexSize;\n    }\n\n    // ------------------------------------------------------------------------------------\n    // --------------------Static Access to Instance Methods-------------------------------\n    // ------------------------------------------------------------------------------------\n    static inherit(scope: A_Scope) {\n        A_FrameIndex.instance.inherit(scope);\n    }\n    static addDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.addDefinition(def);\n    }\n    static getDefinition(nameOrHash: string): A_FrameDefinition | undefined {\n        return A_FrameIndex.instance.getDefinition(nameOrHash);\n    }\n    static listDefinitions(filter: {\n        namespace?: string | A_FrameNamespace\n    }): A_FrameDefinition[] {\n        return A_FrameIndex.instance.listDefinitions(filter);\n    }\n    static removeDefinition(def: A_FrameDefinition): void {\n        A_FrameIndex.instance.removeDefinition(def);\n    }\n    static addNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.addNamespace(namespace);\n    }\n    static getDefaultNamespace(): A_FrameNamespace {\n        return A_FrameIndex.instance.getDefaultNamespace();\n    }\n    static getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        return A_FrameIndex.instance.getNamespace(nameOrASEID);\n    }\n    static listNamespaces(): A_FrameNamespace[] {\n        return A_FrameIndex.instance.listNamespaces();\n    }\n    static removeNamespace(namespace: A_FrameNamespace): void {\n        A_FrameIndex.instance.removeNamespace(namespace);\n    }\n    static search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n        return A_FrameIndex.instance.search(vector, options);\n    }\n\n    // -------------------------------------------------------------------------------------\n    // ------------------------------ Instance State --------------------------------------\n    // -------------------------------------------------------------------------------------\n\n    private definitions: Map<string, A_FrameDefinition> = new Map();\n\n    private namespaces: Map<string, A_FrameNamespace> = new Map();\n\n    private _index!: {\n\n        namespaceToDefinitions: WeakMap<A_FrameNamespace, Set<A_FrameDefinition>>,\n\n        definitionToNamespace: WeakMap<A_FrameDefinition, A_FrameNamespace>,\n    };\n    /**\n     * Scope where all definitions and namespaces are registered as dependencies, allowing for lookup by ASEID or constructor reference.\n     */\n    private scope!: A_Scope\n\n\n    constructor() {\n        if (A_FrameIndex._instance)\n            return A_FrameIndex._instance;\n\n        super({ name: 'A_FrameIndex' });\n\n        this.scope = new A_Scope({ name: 'A_FrameIndexScope' });\n    }\n\n    /** Number of loaded records */\n    get indexSize(): number {\n        return this.definitions.size;\n    }\n\n\n    // static searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     return A_FrameIndex.instance.searchByText(query, channel, options);\n    // }\n\n\n    // ------------------------------------------------------------------------------------\n    // ------------------------------ Instance Methods ------------------------------------\n    // ------------------------------------------------------------------------------------\n    inherit(scope: A_Scope) {\n        this.scope.inherit(scope);\n    }\n\n    addDefinition(def: A_FrameDefinition): void {\n        this.scope.register(def);\n\n        const existingNamespace = this.namespaces.get(def.namespace.id);\n        if (!existingNamespace) {\n            this.addNamespace(def.namespace);\n        }\n\n        this.definitions.set(def.id, def);\n    }\n\n    getDefinition(name: string): A_FrameDefinition | undefined {\n        // Then try name lookup\n        for (const def of this.definitions.values()) {\n            if (def.name === name) {\n                return def;\n            }\n        }\n\n        return undefined;\n    }\n\n    listDefinitions(filter: {\n        namespace?: string | A_FrameNamespace\n    } = {}): A_FrameDefinition[] {\n        const namespaceName = filter.namespace\n            ? typeof filter.namespace === 'string'\n                ? ASEID.isASEID(filter.namespace)\n                    ? new ASEID(filter.namespace).id\n                    : filter.namespace\n                : filter.namespace.id\n            : undefined;\n\n        return [...this.definitions.values()].filter(r => !namespaceName || r.namespace.name === namespaceName);\n    }\n\n    removeDefinition(def: A_FrameDefinition): void {\n        this.scope.deregister(def);\n    }\n\n    addNamespace(namespace: A_FrameNamespace): void {\n        this.scope.register(namespace);\n\n        this.namespaces.set(namespace.id, namespace);\n    }\n\n    getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined {\n        const targetKey = typeof nameOrASEID === 'string'\n            ? ASEID.isASEID(nameOrASEID)\n                ? new ASEID(nameOrASEID).id\n                : nameOrASEID\n            : nameOrASEID.id;\n\n        return this.namespaces.get(targetKey);\n    }\n\n    getDefaultNamespace(): A_FrameNamespace {\n        // Ensure default namespace always exists\n        let defaultNamespace = this.getNamespace(A_FRAME_DEFAULT_NAMESPACE_KEY);\n        if (!defaultNamespace) {\n            defaultNamespace = new A_FrameNamespace({\n                name: A_FRAME_DEFAULT_NAMESPACE_KEY,\n            });\n            this.addNamespace(defaultNamespace);\n        }\n        return defaultNamespace;\n    }\n\n    listNamespaces(): A_FrameNamespace[] {\n        return [...this.namespaces.values()];\n    }\n\n    removeNamespace(namespace: A_FrameNamespace): void {\n        this.scope.deregister(namespace);\n        this.namespaces.delete(namespace.id);\n    }\n\n\n    /**\n     * Search by a pre-computed embedding vector (cosine similarity).\n     */\n    search(\n        vector: A_FrameVector,\n        options: A_FrameSearchOptions = {},\n    ): A_FrameDefinition_SearchResult[] {\n\n        const { topK = 10, namespace, minScore = 0 } = options;\n\n        const pool = namespace\n            ? [...this.definitions.values()].filter(r => r.namespace.id === namespace)\n            : [...this.definitions.values()];\n\n        const scored = pool.map(r => ({\n            record: r,\n            score: this.cosineSimilarity(vector, r.vector),\n        }));\n\n        return scored\n            .filter(s => s.score >= minScore)\n            .sort((a, b) => b.score - a.score)\n            .slice(0, topK)\n            .map(({ record: r, score }) => ({\n                record: r,\n                score,\n            }));\n    }\n\n    // protected cosineSimilarity(vectorA: A_FrameVector, vectorB?: A_FrameVector): number {\n    //     const a = vectorA.values ?? new Float32Array();\n    //     const b = vectorB?.values ?? new Float32Array();\n\n    //     if (a.length !== b.length) {\n    //         throw new Error(`A_FrameIndex: dimension mismatch ${a.length} vs ${b.length}`);\n    //     }\n    //     let dot = 0, normA = 0, normB = 0;\n    //     for (let i = 0; i < a.length; i++) {\n    //         dot += a[i] * b[i];\n    //         normA += a[i] * a[i];\n    //         normB += b[i] * b[i];\n    //     }\n    //     const denom = Math.sqrt(normA) * Math.sqrt(normB);\n    //     return denom === 0 ? 0 : dot / denom;\n    // }\n\n    cosineSimilarity(\n        a: A_FrameVector,\n        b?: A_FrameVector\n    ): number {\n        if (!b) return 0\n\n        const dot = a.dot(b)\n        const mag = a.magnitude() * b.magnitude()\n        return mag === 0 ? 0 : dot / mag\n    }\n\n    euclideanDistance(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ): number {\n        this.assertSameLength(a, b)\n\n        let sum = 0\n        for (let i = 0; i < a.length; i++) {\n            const diff = a.values[i] - b.values[i]\n            sum += diff * diff\n        }\n        return Math.sqrt(sum)\n    }\n\n    nearest(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[],\n        limit = 1\n    ): A_FrameVector[] {\n        return [...vectors]\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n            .slice(0, limit)\n            .map(r => r.vector)\n    }\n\n    rank(\n        query: A_FrameVector,\n        vectors: readonly A_FrameVector[]\n    ): Array<{ vector: A_FrameVector; score: number }> {\n        return vectors\n            .map(v => ({\n                vector: v,\n                score: this.cosineSimilarity(query, v),\n            }))\n            .sort((a, b) => b.score - a.score)\n    }\n\n    private assertSameLength(\n        a: A_FrameVector,\n        b: A_FrameVector\n    ) {\n        if (a.length !== b.length) {\n            throw new Error(\n                `Embedding dimension mismatch: ${a.length} vs ${b.length}`\n            )\n        }\n    }\n\n\n\n    /**\n     * Search by plain text — sends the query to the embed server via channel first.\n     */\n    // async searchByText(\n    //     query: string,\n    //     channel: A_FrameChannel,\n    //     options: A_FrameSearchOptions = {},\n    // ): Promise<A_FrameDefinition_SearchResult[]> {\n    //     this.assertLoaded();\n    //     const resp = await channel.embed(query);\n    //     const queryEmbedding = new Float32Array(resp.data[0].embedding);\n    //     return this.search(queryEmbedding, options);\n    // }\n\n}"]}