@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-UCAWV2IG.mjs

@@ -0,0 +1,184 @@
+import { A_FrameHashHelper } from './chunk-442DXGOD.mjs';
+import { A_FrameVector } from './chunk-IAL2NK2V.mjs';
+import { A_FRAME_MODELS } from './chunk-2HUSP34L.mjs';
+import { A_Entity } from '@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 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;
+  }
+  /**
+   * Physical model name returned by the server after embedding.
+   * `undefined` until `embed()` has been called successfully.
+   */
+  get model() {
+    return this._model;
+  }
+  /**
+   * ISO timestamp of when the embedding was produced.
+   * `undefined` until `embed()` has been called successfully.
+   */
+  get embeddedAt() {
+    return this._embeddedAt;
+  }
+  /**
+   * ID of the server credential (API key) used during embedding.
+   * `undefined` until `embed()` has been called successfully.
+   */
+  get credentialId() {
+    return this._credentialId;
+  }
+  /**
+    * 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: A_FRAME_MODELS.ANTARES, ...init.options };
+    const hashSource = this._content;
+    this._hash = A_FrameHashHelper.fnv1a(hashSource);
+  }
+  fromJSON(serialized) {
+    this._content = serialized.content;
+    this._hash = serialized.hash;
+    this._vector = serialized.embedding ? new 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 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 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");
+  }
+};
+
+export { A_FRAME_DEFAULT_SEGMENT_KEY, A_FrameSegment, A_FrameSegmentFeatures };
+//# sourceMappingURL=chunk-UCAWV2IG.mjs.map
+//# sourceMappingURL=chunk-UCAWV2IG.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameSegment/A-FrameSegment.constants.ts","../../src/lib/A-FrameSegment/A-FrameSegment.entity.ts"],"names":[],"mappings":"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","file":"chunk-UCAWV2IG.mjs","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    /**\n     * Physical model name returned by the server after embedding.\n     * `undefined` until `embed()` has been called successfully.\n     */\n    get model(): string | undefined {\n        return this._model;\n    }\n\n    /**\n     * ISO timestamp of when the embedding was produced.\n     * `undefined` until `embed()` has been called successfully.\n     */\n    get embeddedAt(): string | undefined {\n        return this._embeddedAt;\n    }\n\n    /**\n     * ID of the server credential (API key) used during embedding.\n     * `undefined` until `embed()` has been called successfully.\n     */\n    get credentialId(): string | undefined {\n        return this._credentialId;\n    }\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-UDUJDEAO.cjs

@@ -0,0 +1,189 @@
+'use strict';
+
+var chunkC6BBKHQG_cjs = require('./chunk-C6BBKHQG.cjs');
+var chunkBBYOL3LM_cjs = require('./chunk-BBYOL3LM.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
+var chunkQFHZIG7Y_cjs = require('./chunk-QFHZIG7Y.cjs');
+var aConcept = require('@adaas/a-concept');
+
+var A_FrameComponentMapper = class extends aConcept.A_Component {
+  async mapStructure(structure, mapIndex, frameIndex, channel) {
+    const def = structure.definition;
+    if (!def) return;
+    const tryMatch = (el, minScore, inherit) => {
+      if (!el.embedding?.length) {
+        return { matchedClass: null, matchScore: 0 };
+      }
+      const results = frameIndex.search(new chunkHAORARSB_cjs.A_FrameVector(el.embedding), { topK: 1, inherit });
+      const top = results[0];
+      if (top && top.score >= minScore) {
+        return { matchedClass: top.record.name, matchScore: top.score };
+      }
+      return { matchedClass: null, matchScore: top?.score ?? 0 };
+    };
+    const allElements = (d) => [
+      ...d.containers,
+      ...d.containers.flatMap((c) => [
+        ...c.components ?? [],
+        ...c.fragments ?? [],
+        ...c.entities ?? []
+      ]),
+      ...d.components,
+      ...d.fragments,
+      ...d.entities
+    ];
+    const inferInherit = (el, d) => {
+      if (d.containers.some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Container };
+      if (d.components.some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Component };
+      if (d.fragments.some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Fragment };
+      if (d.entities.some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Entity };
+      for (const ct of d.containers) {
+        if ((ct.components ?? []).some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Component };
+        if ((ct.fragments ?? []).some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Fragment };
+        if ((ct.entities ?? []).some((c) => c.prompt === el.prompt)) return { class: aConcept.A_Entity };
+      }
+      return void 0;
+    };
+    const updateElementEmbedding = (d, oldPrompt, newPrompt, newEmbedding, newRole) => {
+      const update = (el) => {
+        if (el.prompt === oldPrompt) {
+          el.prompt = newPrompt;
+          el.embedding = newEmbedding;
+          if (newRole !== void 0) el.role = newRole;
+        }
+      };
+      d.containers.forEach(update);
+      d.containers.forEach((ct) => {
+        (ct.components ?? []).forEach(update);
+        (ct.fragments ?? []).forEach(update);
+        (ct.entities ?? []).forEach(update);
+      });
+      d.components.forEach(update);
+      d.fragments.forEach(update);
+      d.entities.forEach(update);
+    };
+    const matchAll = (d) => {
+      mapIndex.clear();
+      const score = structure.minScore;
+      for (const ct of d.containers) {
+        mapIndex.set({
+          prompt: ct.prompt,
+          role: ct.role,
+          class: ct.class,
+          ...tryMatch(ct, score, { class: aConcept.A_Container })
+        });
+        for (const el of ct.components ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Component }) });
+        for (const el of ct.fragments ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Fragment }) });
+        for (const el of ct.entities ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Entity }) });
+      }
+      for (const el of d.components)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Component }) });
+      for (const el of d.fragments)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Fragment }) });
+      for (const el of d.entities)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: aConcept.A_Entity }) });
+    };
+    const workingDef = def;
+    matchAll(workingDef);
+    for (let retry = 0; retry < structure.maxRetries; retry++) {
+      const unmatchedEls = allElements(workingDef).filter(
+        (el) => el.embedding?.length && mapIndex.get(el.prompt)?.matchedClass === null
+      );
+      if (unmatchedEls.length === 0) break;
+      const k = structure.candidateCount;
+      const selectElements = unmatchedEls.map((el) => {
+        mapIndex.get(el.prompt);
+        const candidateResults = frameIndex.search(
+          new chunkHAORARSB_cjs.A_FrameVector(el.embedding),
+          { topK: k }
+        );
+        return {
+          prompt: el.prompt,
+          role: el.role,
+          candidates: candidateResults.map((r) => ({
+            name: r.record.name,
+            description: r.record.description
+          }))
+        };
+      });
+      const selectReq = new chunkBBYOL3LM_cjs.A_FrameChannelRequest(
+        "POST",
+        "/api/v1/structure/select",
+        {
+          originalPrompt: structure.prompt,
+          elements: selectElements,
+          model: structure.modelName
+        }
+      );
+      const selectScope = new aConcept.A_Scope({
+        name: `A_FrameComponentMapper.mapStructure:select${retry}`,
+        fragments: [selectReq]
+      }).inherit(aConcept.A_Context.scope(channel));
+      await channel.call(chunkBBYOL3LM_cjs.A_FrameFeatures.Request, selectScope);
+      selectScope.destroy();
+      if (!selectReq.response) break;
+      let anyUpdate = false;
+      for (const resolution of selectReq.response.resolutions) {
+        const existing = mapIndex.get(resolution.elementPrompt);
+        if (!existing) continue;
+        if (resolution.type === "select" && resolution.selectedClass) {
+          mapIndex.set({ ...existing, matchedClass: resolution.selectedClass, matchScore: 1 });
+          anyUpdate = true;
+        } else if (resolution.type === "suggest" && resolution.suggestion) {
+          const { prompt: newPrompt, role: newRole, embedding: newEmbedding } = resolution.suggestion;
+          if (newEmbedding?.length) {
+            const el = unmatchedEls.find((e) => e.prompt === resolution.elementPrompt);
+            const inherit = el ? inferInherit(el, workingDef) : void 0;
+            const results = frameIndex.search(
+              new chunkHAORARSB_cjs.A_FrameVector(newEmbedding),
+              { topK: 1, inherit }
+            );
+            const top = results[0];
+            if (top && top.score >= structure.minScore) {
+              mapIndex.set({ ...existing, matchedClass: top.record.name, matchScore: top.score });
+              anyUpdate = true;
+            } else {
+              mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });
+              updateElementEmbedding(workingDef, resolution.elementPrompt, newPrompt, newEmbedding, newRole);
+              anyUpdate = true;
+            }
+          } else {
+            mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });
+            anyUpdate = true;
+          }
+        }
+      }
+      if (!anyUpdate) break;
+    }
+    for (const el of allElements(workingDef)) {
+      const entry = mapIndex.get(el.prompt);
+      if (entry && entry.matchedClass === null && el.embedding?.length) {
+        mapIndex.set({
+          ...entry,
+          matchError: {
+            title: chunkBBYOL3LM_cjs.A_FrameDynamicStructureError.ComponentNotFound,
+            description: `Unable to match "${el.prompt}" to any registered implementation after ${structure.maxRetries} retries.`
+          }
+        });
+      }
+    }
+    structure.hydrateFromMap(mapIndex.toResult(workingDef));
+  }
+};
+chunkQFHZIG7Y_cjs.__decorateClass([
+  aConcept.A_Feature.Extend({
+    name: chunkBBYOL3LM_cjs.A_FrameDynamicStructureFeatures.Map,
+    scope: [chunkBBYOL3LM_cjs.A_FrameDynamicStructure]
+  }),
+  chunkQFHZIG7Y_cjs.__decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  chunkQFHZIG7Y_cjs.__decorateParam(1, aConcept.A_Inject(chunkBBYOL3LM_cjs.A_FrameComponentMapIndex)),
+  chunkQFHZIG7Y_cjs.__decorateParam(2, aConcept.A_Inject(chunkC6BBKHQG_cjs.A_FrameIndex)),
+  chunkQFHZIG7Y_cjs.__decorateParam(3, aConcept.A_Inject(chunkBBYOL3LM_cjs.A_FrameChannel))
+], A_FrameComponentMapper.prototype, "mapStructure", 1);
+
+exports.A_FrameComponentMapper = A_FrameComponentMapper;
+//# sourceMappingURL=chunk-UDUJDEAO.cjs.map
+//# sourceMappingURL=chunk-UDUJDEAO.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameComponentMapper.component.ts"],"names":["A_Component","A_FrameVector","A_Container","A_Fragment","A_Entity","A_FrameChannelRequest","A_Scope","A_Context","A_FrameFeatures","A_FrameDynamicStructureError","__decorateClass","A_Feature","A_FrameDynamicStructureFeatures","A_FrameDynamicStructure","__decorateParam","A_Caller","A_FrameComponentMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":"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","file":"chunk-UDUJDEAO.cjs","sourcesContent":["import { A_Caller, A_Component, A_Container, A_Context, A_Entity, A_Feature, A_Fragment, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameChannel } from \"../A-FrameChannel/A-FrameChannel.component\";\nimport { A_FrameFeatures } from \"../A-FrameChannel/A-FrameChannel.constants\";\nimport { A_FrameChannelRequest } from \"../A-FrameChannel/A-FrameChannelRequest.context\";\nimport { A_FrameIndex } from \"../A-FrameIndex/A-FrameIndex.context\";\nimport { A_FrameInheritanceFilter } from \"../A-FrameIndex/A-FrameIndex.types\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameDynamicStructure } from \"./A-FrameDynamicStructure.entity\";\nimport { A_FrameDynamicStructureFeatures } from \"./A-FrameDynamicStructure.constants\";\nimport { A_FrameDynamicStructureError } from \"./A-FrameDynamicStructure.error\";\nimport {\n    A_FrameComponentMapEntry,\n    A_FrameDynamicStructureDefinition,\n    A_FrameDynamicStructureDefinitionEntity,\n    A_FrameStructureSelectRequest,\n    A_FrameStructureSelectResolution,\n    A_FrameStructureSelectResponse,\n} from \"./A-FrameDynamicStructure.types\";\nimport { A_FrameComponentMapIndex } from \"./A-FrameComponentMapIndex.context\";\n\n\n/**\n * Stateless component that implements the `Map` feature for\n * `A_FrameDynamicStructure`.\n *\n * Receives all necessary context via `@A_Inject` — it stores no state of its\n * own.  Injects the calling structure (via `A_Caller`), the local definition\n * index (`A_FrameIndex`), the map-result accumulator (`A_FrameComponentMapIndex`),\n * and the HTTP channel (`A_FrameChannel`) needed for refinement retry calls.\n *\n * Algorithm:\n *  1. Read `structure.definition` (raw, with server embeddings).\n *  2. For every element run cosine-similarity search against `A_FrameIndex`.\n *  3. For remaining unmatched elements (up to `structure.maxRetries`): ask the\n *     server to refine their descriptions, then re-match the new definition.\n *  4. Mark still-unmatched elements with a `matchError`.\n *  5. Call `structure.hydrateFromMap(mapIndex.toResult(workingDef))`.\n */\nexport class A_FrameComponentMapper extends A_Component {\n\n    @A_Feature.Extend({\n        name: A_FrameDynamicStructureFeatures.Map,\n        scope: [A_FrameDynamicStructure],\n    })\n    async mapStructure(\n        @A_Inject(A_Caller) structure: A_FrameDynamicStructure,\n        @A_Inject(A_FrameComponentMapIndex) mapIndex: A_FrameComponentMapIndex,\n        @A_Inject(A_FrameIndex) frameIndex: A_FrameIndex,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n    ): Promise<void> {\n\n        const def = structure.definition;\n        if (!def) return;\n\n        // ── helpers ──────────────────────────────────────────────────────────\n\n        const tryMatch = (\n            el: A_FrameDynamicStructureDefinitionEntity,\n            minScore: number,\n            inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[],\n        ): Pick<A_FrameComponentMapEntry, 'matchedClass' | 'matchScore'> => {\n            if (!el.embedding?.length) {\n                return { matchedClass: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1, inherit });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                return { matchedClass: top.record.name, matchScore: top.score };\n            }\n            return { matchedClass: null, matchScore: top?.score ?? 0 };\n        };\n\n        const allElements = (d: A_FrameDynamicStructureDefinition): A_FrameDynamicStructureDefinitionEntity[] => [\n            ...d.containers,\n            ...d.containers.flatMap(c => [\n                ...(c.components ?? []),\n                ...(c.fragments  ?? []),\n                ...(c.entities   ?? []),\n            ]),\n            ...d.components,\n            ...d.fragments,\n            ...d.entities,\n        ];\n\n        const stripEmbeddings = (d: A_FrameDynamicStructureDefinition): A_FrameDynamicStructureDefinition => {\n            const strip = (el: A_FrameDynamicStructureDefinitionEntity): A_FrameDynamicStructureDefinitionEntity => {\n                const { embedding, ...rest } = el as any;\n                return rest as A_FrameDynamicStructureDefinitionEntity;\n            };\n            return {\n                containers: d.containers.map(c => ({\n                    ...strip(c),\n                    components: (c.components ?? []).map(strip),\n                    fragments:  (c.fragments  ?? []).map(strip),\n                    entities:   (c.entities   ?? []).map(strip),\n                })),\n                components: d.components.map(strip),\n                fragments:  d.fragments.map(strip),\n                entities:   d.entities.map(strip),\n            };\n        };\n\n        /**\n         * Infer the appropriate inheritance filter for an element by checking which\n         * slot it occupies inside the definition (container / component / fragment / entity).\n         */\n        const inferInherit = (\n            el: A_FrameDynamicStructureDefinitionEntity,\n            d: A_FrameDynamicStructureDefinition,\n        ): A_FrameInheritanceFilter | undefined => {\n            if (d.containers.some(c => c.prompt === el.prompt)) return { class: A_Container };\n            if (d.components.some(c => c.prompt === el.prompt)) return { class: A_Component };\n            if (d.fragments.some(c => c.prompt === el.prompt))  return { class: A_Fragment };\n            if (d.entities.some(c => c.prompt === el.prompt))   return { class: A_Entity };\n            for (const ct of d.containers) {\n                if ((ct.components ?? []).some(c => c.prompt === el.prompt)) return { class: A_Component };\n                if ((ct.fragments  ?? []).some(c => c.prompt === el.prompt)) return { class: A_Fragment };\n                if ((ct.entities   ?? []).some(c => c.prompt === el.prompt)) return { class: A_Entity };\n            }\n            return undefined;\n        };\n\n        /**\n         * Mutate workingDef in-place: update the element identified by `oldPrompt`\n         * with a new prompt, role, and embedding from a server suggestion.\n         * This lets the next iteration's `allElements()` find the updated embedding.\n         */\n        const updateElementEmbedding = (\n            d: A_FrameDynamicStructureDefinition,\n            oldPrompt: string,\n            newPrompt: string,\n            newEmbedding: number[],\n            newRole?: string,\n        ): void => {\n            const update = (el: A_FrameDynamicStructureDefinitionEntity & { role?: string }): void => {\n                if (el.prompt === oldPrompt) {\n                    el.prompt = newPrompt;\n                    el.embedding = newEmbedding;\n                    if (newRole !== undefined) el.role = newRole;\n                }\n            };\n            d.containers.forEach(update);\n            d.containers.forEach(ct => {\n                (ct.components ?? []).forEach(update);\n                (ct.fragments  ?? []).forEach(update);\n                (ct.entities   ?? []).forEach(update);\n            });\n            d.components.forEach(update);\n            d.fragments.forEach(update);\n            d.entities.forEach(update);\n        };\n\n        /**\n         * Match all elements in the definition, restricting each group's candidate\n         * pool to the appropriate base class via inheritance filters:\n         *   containers → A_Container\n         *   components → A_Component\n         *   fragments  → A_Fragment\n         *   entities   → A_Entity\n         */\n        const matchAll = (d: A_FrameDynamicStructureDefinition): void => {\n            mapIndex.clear();\n            const score = structure.minScore;\n\n            // Top-level containers\n            for (const ct of d.containers) {\n                mapIndex.set({\n                    prompt: ct.prompt,\n                    role:   ct.role,\n                    class:  ct.class,\n                    ...tryMatch(ct, score, { class: A_Container }),\n                });\n                // Nested: components, fragments, entities within each container\n                for (const el of (ct.components ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });\n                for (const el of (ct.fragments ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });\n                for (const el of (ct.entities ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Entity }) });\n            }\n\n            // Top-level cross-cutting elements\n            for (const el of d.components)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });\n            for (const el of d.fragments)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });\n            for (const el of d.entities)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Entity }) });\n        };\n\n        // ── initial matching pass ─────────────────────────────────────────────\n\n        const workingDef = def;\n        matchAll(workingDef);\n\n        // ── select / suggest retry loop ───────────────────────────────────────\n        //\n        // For each retry: collect unmatched elements, pull `candidateCount` top\n        // candidates per element from the local index (no minScore filter so we\n        // always have *something* to show the AI), then call /api/v1/structure/select.\n        //\n        // The server returns one resolution per element:\n        //   select  → directly set matchedClass (no re-embed needed)\n        //   suggest → the response includes a fresh embedding; re-run tryMatch\n        //   none    → skip the element (will become a matchError below)\n\n        for (let retry = 0; retry < structure.maxRetries; retry++) {\n            const unmatchedEls = allElements(workingDef).filter(\n                el => el.embedding?.length && mapIndex.get(el.prompt)?.matchedClass === null,\n            );\n            if (unmatchedEls.length === 0) break;\n\n            // Build select payload — top-K candidates per element, no minScore.\n            const k = structure.candidateCount;\n            const selectElements = unmatchedEls.map(el => {\n                // Determine appropriate inheritance filter for this element's role.\n                // We look up the existing map entry to know which slot it lives in.\n                const entry = mapIndex.get(el.prompt);\n                // Use unconstrained search to get candidates (already tried constrained above).\n                const candidateResults = frameIndex.search(\n                    new A_FrameVector(el.embedding!),\n                    { topK: k },\n                );\n                return {\n                    prompt:     el.prompt,\n                    role:       el.role,\n                    candidates: candidateResults.map(r => ({\n                        name:        r.record.name,\n                        description: r.record.description,\n                    })),\n                };\n            });\n\n            // Call /api/v1/structure/select\n            const selectReq = new A_FrameChannelRequest<A_FrameStructureSelectResponse>(\n                'POST',\n                '/api/v1/structure/select',\n                {\n                    originalPrompt: structure.prompt,\n                    elements:       selectElements,\n                    model:          structure.modelName,\n                } satisfies A_FrameStructureSelectRequest,\n            );\n\n            const selectScope = new A_Scope({\n                name: `A_FrameComponentMapper.mapStructure:select${retry}`,\n                fragments: [selectReq],\n            }).inherit(A_Context.scope(channel));\n\n            await channel.call(A_FrameFeatures.Request, selectScope);\n            selectScope.destroy();\n\n            if (!selectReq.response) break;\n\n            // Apply resolutions\n            let anyUpdate = false;\n            for (const resolution of selectReq.response.resolutions) {\n                const existing = mapIndex.get(resolution.elementPrompt);\n                if (!existing) continue;\n\n                if (resolution.type === 'select' && resolution.selectedClass) {\n                    // Direct selection — no re-embed required.\n                    mapIndex.set({ ...existing, matchedClass: resolution.selectedClass, matchScore: 1 });\n                    anyUpdate = true;\n\n                } else if (resolution.type === 'suggest' && resolution.suggestion) {\n                    // Server suggested a re-description, optionally with a fresh embedding.\n                    const { prompt: newPrompt, role: newRole, embedding: newEmbedding } = resolution.suggestion;\n\n                    if (newEmbedding?.length) {\n                        // Re-search locally with the new embedding.\n                        const el = unmatchedEls.find(e => e.prompt === resolution.elementPrompt);\n                        const inherit = el ? inferInherit(el, workingDef) : undefined;\n                        const results = frameIndex.search(\n                            new A_FrameVector(newEmbedding),\n                            { topK: 1, inherit },\n                        );\n                        const top = results[0];\n                        if (top && top.score >= structure.minScore) {\n                            mapIndex.set({ ...existing, matchedClass: top.record.name, matchScore: top.score });\n                            anyUpdate = true;\n                        } else {\n                            // Still unmatched, but update the prompt so next retry uses the new description.\n                            mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });\n                            // Also update the working element so allElements() finds the new embedding.\n                            updateElementEmbedding(workingDef, resolution.elementPrompt, newPrompt, newEmbedding, newRole);\n                            anyUpdate = true;\n                        }\n                    } else {\n                        // No embedding returned — just update description for next round.\n                        mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });\n                        anyUpdate = true;\n                    }\n                }\n                // type === 'none': leave as-is, will become matchError below.\n            }\n\n            if (!anyUpdate) break;\n        }\n\n        // ── finalize: mark remaining unmatched with an error ──────────────────\n\n        for (const el of allElements(workingDef)) {\n            const entry = mapIndex.get(el.prompt);\n            if (entry && entry.matchedClass === null && el.embedding?.length) {\n                mapIndex.set({\n                    ...entry,\n                    matchError: {\n                        title: A_FrameDynamicStructureError.ComponentNotFound,\n                        description: `Unable to match \"${el.prompt}\" to any registered implementation after ${structure.maxRetries} retries.`,\n                    },\n                });\n            }\n        }\n\n        // ── hydrate the structure with the map result ─────────────────────────\n\n        structure.hydrateFromMap(mapIndex.toResult(workingDef));\n    }\n}\n"]}