@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/chunk-M6DJYGDO.cjs

@@ -0,0 +1,167 @@
+'use strict';
+
+var chunkZM2RLVVH_cjs = require('./chunk-ZM2RLVVH.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
+var chunk64QCZG53_cjs = require('./chunk-64QCZG53.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-FrameSegment/A-FrameSegment.constants.ts
+var A_FRAME_DEFAULT_SEGMENT_KEY = "default";
+var A_FrameSegmentFeatures = {
+  Load: "_A_FRAME_SEGMENT_LOAD",
+  Save: "_A_FRAME_SEGMENT_SAVE",
+  Embed: "_A_FRAME_SEGMENT_EMBED",
+  Destroy: "_A_FRAME_SEGMENT_DESTROY"
+};
+
+// src/lib/A-FrameSegment/A-FrameSegment.entity.ts
+var A_FrameSegment = class extends aConcept.A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  // ─── Getters ──────────────────────────────────────────────────────────────
+  get id() {
+    return this.aseid.id;
+  }
+  get content() {
+    return this._content;
+  }
+  get hash() {
+    return this._hash;
+  }
+  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;
+  }
+  get options() {
+    return this._options;
+  }
+  /**
+    * Saves Segment to storage. The actual implementation of saving is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.Save, scope);
+  }
+  /**
+   * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.Destroy, scope);
+  }
+  /**
+   * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.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.content) this._content = updates.content;
+  }
+  /**
+   * Generates an embedding vector for the namespace using the A_FrameSegmentFeatures.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) {
+    return this.call(A_FrameSegmentFeatures.Embed, scope);
+  }
+  // ─── A_Entity lifecycle ───────────────────────────────────────────────────
+  fromNew(init) {
+    super.fromNew(init);
+    this._content = init.content;
+    this._options = { model: chunk64QCZG53_cjs.A_FRAME_MODELS.ANTARES, ...init.options };
+    const hashSource = this._content;
+    this._hash = chunkZM2RLVVH_cjs.A_FrameHashHelper.fnv1a(hashSource);
+  }
+  fromJSON(serialized) {
+    this._content = serialized.content;
+    this._hash = serialized.hash;
+    this._vector = serialized.embedding ? new chunkHAORARSB_cjs.A_FrameVector(serialized.embedding) : void 0;
+    this._embeddedAt = serialized.embeddedAt;
+    this._model = serialized.model;
+    this._credentialId = serialized.credentialId;
+    this._aFrameVersion = serialized.aFrameVersion;
+    this._aFrameServerVersion = serialized.aFrameServerVersion;
+    if (serialized.task) {
+      this._options = { ...this._options, task: serialized.task };
+    }
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      hash: this._hash,
+      content: this._content,
+      embedding: this._vector?.values,
+      embeddedAt: this._embeddedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      task: this._options?.task,
+      model: this._model,
+      credentialId: this._credentialId,
+      aFrameVersion: this._aFrameVersion,
+      aFrameServerVersion: this._aFrameServerVersion
+    };
+  }
+  // ─── Embedding hydration ──────────────────────────────────────────────────
+  hydrateFromRecord(record) {
+    if (record.hash !== this._hash) {
+      throw new Error(
+        `A_FrameSegment.hydrateFromRecord: hash mismatch for "${this._content}" (expected ${this._hash}, got ${record.hash})`
+      );
+    }
+    this._vector = new chunkHAORARSB_cjs.A_FrameVector(record.embedding);
+    this._embeddedAt = record.embeddedAt;
+    if (record.task) {
+      this._options = { ...this._options, task: record.task };
+    }
+  }
+  /**
+   * Populate the embedding vector directly from a raw `Float32Array`.
+   * Use this when the vector is obtained externally (e.g. from a server
+   * response) without going through the full `embed()` feature pipeline.
+   */
+  hydrateFromEmbedding(embedding) {
+    this._vector = new chunkHAORARSB_cjs.A_FrameVector(embedding);
+  }
+  /**
+   * Build the text string sent to the embedding model.
+   * Uses content so the vector captures semantic intent.
+   */
+  toString() {
+    const parts = [`// content: ${this._content}`];
+    return parts.join("\n");
+  }
+};
+
+exports.A_FRAME_DEFAULT_SEGMENT_KEY = A_FRAME_DEFAULT_SEGMENT_KEY;
+exports.A_FrameSegment = A_FrameSegment;
+exports.A_FrameSegmentFeatures = A_FrameSegmentFeatures;
+//# sourceMappingURL=chunk-M6DJYGDO.cjs.map
+//# sourceMappingURL=chunk-M6DJYGDO.cjs.map

package/dist/node/chunk-M6DJYGDO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameSegment/A-FrameSegment.constants.ts","../../src/lib/A-FrameSegment/A-FrameSegment.entity.ts"],"names":["A_Entity","A_FRAME_MODELS","A_FrameHashHelper","A_FrameVector"],"mappings":"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","file":"chunk-M6DJYGDO.cjs","sourcesContent":["import { A_FrameSegment } from \"./A-FrameSegment.entity\";\n\n\nexport const A_FRAME_DEFAULT_SEGMENT_KEY = 'default';\n\n\nexport const A_FrameSegmentFeatures = {\n    Load: '_A_FRAME_SEGMENT_LOAD',\n    Save: '_A_FRAME_SEGMENT_SAVE',\n    Embed: '_A_FRAME_SEGMENT_EMBED',\n    Destroy: '_A_FRAME_SEGMENT_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_FrameSegment_Init,\n    A_FrameSegment_Serialized,\n    A_FrameSegment_Record,\n    A_FrameSegment_EmbeddingMeta,\n    A_FrameSegmentOptions,\n} from \"./A-FrameSegment.types\";\nimport { A_FrameHashHelper } from \"@adaas/a-frame/helpers/Hash.helper\";\nimport { A_FrameSegmentFeatures } from \"./A-FrameSegment.constants\";\nimport { A_FRAME_MODELS } from \"../A-FrameModels\";\n\n\nexport class A_FrameSegment extends A_Entity<A_FrameSegment_Init, A_FrameSegment_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _content!: string;\n    protected _hash!: string;\n    protected _vector?: A_FrameVector;\n    protected _embeddedAt?: string;\n    protected _model?: string;\n    protected _credentialId?: string;\n    protected _aFrameVersion?: string;\n    protected _aFrameServerVersion?: string;\n    protected _options?: Partial<A_FrameSegmentOptions>;\n\n\n    // ─── Getters ──────────────────────────────────────────────────────────────\n\n    get id(): string {\n        return this.aseid.id;\n    }\n\n    get content(): string {\n        return this._content;\n    }\n\n    get hash(): string {\n        return this._hash;\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    get options(): Partial<A_FrameSegmentOptions> | undefined {\n        return this._options;\n    }\n    /**\n      * Saves Segment to storage. The actual implementation of saving is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.Save, scope);\n    }\n    /**\n     * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.Destroy, scope);\n    }\n    /**\n     * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameSegmentFeatures.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_FrameSegmentFeatures.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_FrameSegment, 'content'>>): void {\n        if (updates.content) this._content = updates.content;\n    }\n    /**\n     * Generates an embedding vector for the namespace using the A_FrameSegmentFeatures.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        return this.call(A_FrameSegmentFeatures.Embed, scope);\n    }\n\n    // ─── A_Entity lifecycle ───────────────────────────────────────────────────\n\n    fromNew(init: A_FrameSegment_Init): void {\n        super.fromNew(init);\n\n        this._content = init.content;\n        this._options = { model: A_FRAME_MODELS.ANTARES, ...init.options };\n\n        const hashSource = this._content;\n\n        this._hash = A_FrameHashHelper.fnv1a(hashSource);\n    }\n\n    fromJSON(serialized: A_FrameSegment_Serialized): void {\n        this._content = serialized.content;\n        this._hash = serialized.hash;\n        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;\n        this._embeddedAt = serialized.embeddedAt;\n        this._model = serialized.model;\n        this._credentialId = serialized.credentialId;\n        this._aFrameVersion = serialized.aFrameVersion;\n        this._aFrameServerVersion = serialized.aFrameServerVersion;\n        if (serialized.task) {\n            this._options = { ...this._options, task: serialized.task };\n        }\n    }\n\n\n\n    toJSON(): A_FrameSegment_Serialized {\n        return {\n            ...super.toJSON(),\n            hash: this._hash,\n            content: this._content,\n            embedding: this._vector?.values,\n            embeddedAt: this._embeddedAt ?? new Date().toISOString(),\n            task: this._options?.task,\n            model: this._model,\n            credentialId: this._credentialId,\n            aFrameVersion: this._aFrameVersion,\n            aFrameServerVersion: this._aFrameServerVersion,\n        };\n    }\n\n\n    // ─── Embedding hydration ──────────────────────────────────────────────────\n\n    hydrateFromRecord(record: A_FrameSegment_Record): void {\n        if (record.hash !== this._hash) {\n            throw new Error(\n                `A_FrameSegment.hydrateFromRecord: hash mismatch for \"${this._content}\" ` +\n                `(expected ${this._hash}, got ${record.hash})`\n            );\n        }\n        this._vector = new A_FrameVector(record.embedding);\n        this._embeddedAt = record.embeddedAt;\n        if (record.task) {\n            this._options = { ...this._options, task: record.task };\n        }\n    }\n\n    /**\n     * Populate the embedding vector directly from a raw `Float32Array`.\n     * Use this when the vector is obtained externally (e.g. from a server\n     * response) without going through the full `embed()` feature pipeline.\n     */\n    hydrateFromEmbedding(embedding: Float32Array): void {\n        this._vector = new A_FrameVector(embedding);\n    }\n\n    /**\n     * Build the text string sent to the embedding model.\n     * Uses content so the vector captures semantic intent.\n     */\n    toString(): string {\n        const parts: string[] = [`// content: ${this._content}`];\n        return parts.join('\\n');\n    }\n}\n\n"]}

package/dist/node/chunk-MAHKDTOQ.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-MAHKDTOQ.mjs.map
+//# sourceMappingURL=chunk-MAHKDTOQ.mjs.map

package/dist/node/chunk-MAHKDTOQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-MAHKDTOQ.mjs"}