@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-RVZTZD32.mjs

@@ -0,0 +1,187 @@
+import { A_FrameIndex } from './chunk-OMGYXCFM.mjs';
+import { A_FrameDynamicStructure, A_FrameDynamicStructureFeatures, A_FrameComponentMapIndex, A_FrameChannel, A_FrameChannelRequest, A_FrameFeatures, A_FrameDynamicStructureError } from './chunk-KFW4GE7H.mjs';
+import { A_FrameVector } from './chunk-IAL2NK2V.mjs';
+import { __decorateClass, __decorateParam } from './chunk-OI76LHVT.mjs';
+import { A_Feature, A_Inject, A_Caller, A_Component, A_Scope, A_Context, A_Container, A_Fragment, A_Entity } from '@adaas/a-concept';
+
+var A_FrameComponentMapper = class extends 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 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: A_Container };
+      if (d.components.some((c) => c.prompt === el.prompt)) return { class: A_Component };
+      if (d.fragments.some((c) => c.prompt === el.prompt)) return { class: A_Fragment };
+      if (d.entities.some((c) => c.prompt === el.prompt)) return { class: A_Entity };
+      for (const ct of d.containers) {
+        if ((ct.components ?? []).some((c) => c.prompt === el.prompt)) return { class: A_Component };
+        if ((ct.fragments ?? []).some((c) => c.prompt === el.prompt)) return { class: A_Fragment };
+        if ((ct.entities ?? []).some((c) => c.prompt === el.prompt)) return { class: 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: A_Container })
+        });
+        for (const el of ct.components ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });
+        for (const el of ct.fragments ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });
+        for (const el of ct.entities ?? [])
+          mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Entity }) });
+      }
+      for (const el of d.components)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });
+      for (const el of d.fragments)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });
+      for (const el of d.entities)
+        mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: 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 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 A_FrameChannelRequest(
+        "POST",
+        "/api/v1/structure/select",
+        {
+          originalPrompt: structure.prompt,
+          elements: selectElements,
+          model: structure.modelName
+        }
+      );
+      const selectScope = new A_Scope({
+        name: `A_FrameComponentMapper.mapStructure:select${retry}`,
+        fragments: [selectReq]
+      }).inherit(A_Context.scope(channel));
+      await channel.call(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 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: A_FrameDynamicStructureError.ComponentNotFound,
+            description: `Unable to match "${el.prompt}" to any registered implementation after ${structure.maxRetries} retries.`
+          }
+        });
+      }
+    }
+    structure.hydrateFromMap(mapIndex.toResult(workingDef));
+  }
+};
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicStructureFeatures.Map,
+    scope: [A_FrameDynamicStructure]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameComponentMapIndex)),
+  __decorateParam(2, A_Inject(A_FrameIndex)),
+  __decorateParam(3, A_Inject(A_FrameChannel))
+], A_FrameComponentMapper.prototype, "mapStructure", 1);
+
+export { A_FrameComponentMapper };
+//# sourceMappingURL=chunk-RVZTZD32.mjs.map
+//# sourceMappingURL=chunk-RVZTZD32.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameComponentMapper.component.ts"],"names":[],"mappings":"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","file":"chunk-RVZTZD32.mjs","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"]}

package/dist/node/chunk-RWLKISZQ.mjs

@@ -0,0 +1,273 @@
+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, A_Dependency, A_FormatterHelper } from '@adaas/a-concept';
+
+// src/lib/A-FrameDefinition/A-FrameDefinition.constants.ts
+var A_FrameDefinitionFeatures = {
+  Load: "_A_FRAME_DEFINITION_LOAD",
+  Save: "_A_FRAME_DEFINITION_SAVE",
+  Embed: "_A_FRAME_DEFINITION_EMBED",
+  Destroy: "_A_FRAME_DEFINITION_DESTROY"
+};
+
+// src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts
+var A_FrameDefinition = class extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //---------------------------------------- Primary properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  /**
+   * Definition Identifier from ASEID unique name 
+   */
+  get id() {
+    return this.aseid.id;
+  }
+  /**
+   * The type of the definition target (component, entity, container, fragment, or method)
+   */
+  get type() {
+    return this._type;
+  }
+  /**
+   * The name of the defined feature (e.g. "MyComponent", "myMethod", etc.)
+   */
+  get name() {
+    return this._name;
+  }
+  /**
+   * Description that explains the purpose of the defined feature, its inputs/outputs, or any other relevant information.
+   */
+  get description() {
+    return this._description;
+  }
+  get dependency() {
+    return new A_Dependency(this._dependency);
+  }
+  /**
+   * The original source code string that implements the defined feature. This is the main content that gets embedded and indexed for search.
+   */
+  get source() {
+    return this._source;
+  }
+  /**
+   * The vector embedding representing the definition's source and metadata. This is populated after embedding and is used for similarity search in the index.
+   */
+  get vector() {
+    return this._vector;
+  }
+  /**
+   * Namespace to which this definition belongs. Used for scoping search and organizing definitions. If not specified, defaults to the global namespace.
+   */
+  get namespace() {
+    return this._namespace;
+  }
+  /**
+   * Additional metadata about the definition, stored as key-value pairs. This can include any relevant information that doesn't fit into the other properties but may be useful for search or organization.
+   */
+  get metadata() {
+    return this._metadata || {};
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //----------------------------------- Common State properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  /**
+   * A unique hash string computed from the definition's name, source, description, and metadata. This is used to identify identical definitions and avoid duplicates in the index.
+   */
+  get hash() {
+    return this._hash;
+  }
+  /**
+   * The timestamp (in milliseconds since epoch) when the definition was embedded. This is used for tracking the freshness of the embedding and can be useful for re-embedding stale definitions.
+   */
+  get date() {
+    return this._date;
+  }
+  /**
+   * The name of the embedding model used to produce the vector. This is important for understanding the characteristics of the embedding and for debugging purposes.
+   */
+  get model() {
+    return this._model;
+  }
+  /**
+   * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`
+   * if not explicitly overridden. Sent to the server in the embed request.
+   */
+  get requestedModel() {
+    return this._requestedModel;
+  }
+  /**
+   * ID of the server credential (API key) used during embedding. This is useful for auditing and debugging embedding operations, especially when multiple credentials are in use.
+   */
+  get credentialId() {
+    return this._credentialId;
+  }
+  /**
+   * Version of @adaas/a-frame that produced this record. This helps track compatibility and understand which version of the library was used to create the definition.
+   */
+  get aFrameVersion() {
+    return this._aFrameVersion;
+  }
+  /**
+   * Version of a-frame-server that produced the vector. This is useful for debugging embedding issues and ensuring compatibility between the library and the embed server.
+   */
+  get aFrameServerVersion() {
+    return this._aFrameServerVersion;
+  }
+  /**
+   * Structural metadata extracted server-side when the definition was embedded.
+   * Includes discovered methods, @A_Inject dependencies, and @A_Feature.Extend names.
+   */
+  get aFrameMeta() {
+    return this._aFrameMeta;
+  }
+  //-----------------------------------------------------------------------------------------------------
+  //--------------------------------------- Computed properties -----------------------------------------
+  //-----------------------------------------------------------------------------------------------------
+  get isEmbed() {
+    return this._vector !== void 0;
+  }
+  /**
+   * Saves the definition to storage. The actual implementation of saving is handled by the A_FrameDefinitionFeatures.Save feature, which can be implemented by the environment (e.g. browser, Node.js) to persist the definition in a database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  save(scope) {
+    return this.call(A_FrameDefinitionFeatures.Save, scope);
+  }
+  /**
+   * Deletes the definition from storage. The actual implementation of deletion is handled by the A_FrameDefinitionFeatures.Destroy feature, which can be implemented by the environment to remove the definition from the database, file system, or other storage mechanism.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  destroy(scope) {
+    return this.call(A_FrameDefinitionFeatures.Destroy, scope);
+  }
+  /**
+   * Loads the definition from storage. The actual implementation of loading is handled by the A_FrameDefinitionFeatures.Load feature, which can be implemented by the environment to retrieve the definition from the database, file system, or other storage mechanism and populate the entity's properties accordingly.
+   * 
+   * @param scope 
+   * @returns 
+   */
+  load(scope) {
+    return this.call(A_FrameDefinitionFeatures.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.source) this._source = updates.source;
+    if (updates.description !== void 0) this._description = updates.description;
+    if (updates.metadata !== void 0) this._metadata = updates.metadata;
+    if (updates.namespace !== void 0) this._namespace = updates.namespace;
+  }
+  /**
+   * Generates the embedding for the definition's source and metadata. 
+   * 
+   * @param scope 
+   * @returns 
+   */
+  embed(scope) {
+    return this.call(A_FrameDefinitionFeatures.Embed, scope);
+  }
+  fromNew(newEntity) {
+    this._type = newEntity.type;
+    this.aseid = this.generateASEID({
+      id: A_FormatterHelper.toKebabCase(newEntity.dependency + "-" + newEntity.name),
+      scope: "a-frame"
+    });
+    this._name = newEntity.name;
+    const hashSource = this._name + "//" + (newEntity.description || "") + "//" + (newEntity.metadata ? JSON.stringify(newEntity.metadata) : "") + "//" + newEntity.source + "//Namespace: " + newEntity.namespace.id;
+    this._hash = A_FrameHashHelper.fnv1a(hashSource);
+    this._source = newEntity.source;
+    this._description = newEntity.description;
+    this._namespace = newEntity.namespace;
+    this._metadata = newEntity.metadata;
+    this._dependency = newEntity.dependency;
+    this._requestedModel = newEntity.model ?? A_FRAME_MODELS.ANTARES;
+  }
+  fromJSON(serialized) {
+    this._name = serialized.name;
+    this._hash = serialized.hash;
+    this._source = serialized.source || "";
+    this._description = serialized.description;
+    this._metadata = serialized.metadata;
+    this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : void 0;
+    this._date = serialized.date;
+    this._model = serialized.model;
+    this._credentialId = serialized.credentialId;
+    this._aFrameVersion = serialized.aFrameVersion;
+    this._aFrameServerVersion = serialized.aFrameServerVersion;
+    this._aFrameMeta = serialized.aFrameMeta;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      hash: this._hash,
+      name: this._name,
+      source: this._source,
+      description: this._description,
+      metadata: this._metadata,
+      namespace: this._namespace.aseid.toString(),
+      embedding: this._vector?.values,
+      date: this._date ?? (/* @__PURE__ */ new Date()).toISOString(),
+      model: this._model,
+      credentialId: this._credentialId,
+      aFrameVersion: this._aFrameVersion,
+      aFrameServerVersion: this._aFrameServerVersion,
+      aFrameMeta: this._aFrameMeta
+    };
+  }
+  // ─── Embedding hydration ──────────────────────────────────────────────────
+  /** Populate the vector from a pre-existing storage record */
+  // hydrateFromRecord(record: A_FrameDefinition_Record): void {
+  //     if (record.hash !== this._hash) {
+  //         throw new Error(
+  //             `A_FrameDefinition.hydrateFromRecord: hash mismatch for "${this._name}" ` +
+  //             `(expected ${this._hash}, got ${record.hash})`
+  //         );
+  //     }
+  //     this._vector = new A_FrameVector(record.embedding);
+  //     this._embeddedAt = record.embeddedAt;
+  //     this._model = record.model;
+  //     this._credentialId = record.credentialId;
+  //     this._aFrameVersion = record.aFrameVersion;
+  //     this._aFrameServerVersion = record.aFrameServerVersion;
+  // }
+  /** Populate the vector from a freshly-fetched embedding */
+  hydrateFromEmbedding(embedding, meta) {
+    this._vector = new A_FrameVector(embedding);
+    this._date = (/* @__PURE__ */ new Date()).toISOString();
+    if (meta) {
+      this._model = meta.model;
+      this._credentialId = meta.credentialId ?? void 0;
+      this._aFrameVersion = meta.aFrameVersion;
+      this._aFrameServerVersion = meta.aFrameServerVersion;
+      if (meta.aFrameMeta)
+        this._aFrameMeta = meta.aFrameMeta;
+    }
+  }
+  // ─── Embedding input ──────────────────────────────────────────────────────
+  /**
+   * Build the text string sent to the embedding model.
+   * Concatenates name + description + source so the resulting
+   * vector captures both intent and implementation.
+   */
+  toString() {
+    const parts = [];
+    parts.push(`// ${this._name}`);
+    if (this._description) parts.push(`// ${this._description}`);
+    parts.push(this._source);
+    return parts.join("\n");
+  }
+};
+
+export { A_FrameDefinition, A_FrameDefinitionFeatures };
+//# sourceMappingURL=chunk-RWLKISZQ.mjs.map
+//# sourceMappingURL=chunk-RWLKISZQ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDefinition/A-FrameDefinition.constants.ts","../../src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts"],"names":[],"mappings":"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","file":"chunk-RWLKISZQ.mjs","sourcesContent":["\n\nexport const A_FrameDefinitionFeatures = {\n    Load: '_A_FRAME_DEFINITION_LOAD',\n    Save: '_A_FRAME_DEFINITION_SAVE',\n    Embed: '_A_FRAME_DEFINITION_EMBED',\n    Destroy: '_A_FRAME_DEFINITION_DESTROY',\n} as const;","import { A_Dependency, A_Entity, A_FormatterHelper, A_Scope } from \"@adaas/a-concept\";\nimport {\n    A_FrameDefinition_EmbeddingMeta,\n    A_FrameDefinition_Init,\n    A_FrameDefinition_Serialized,\n    DefinitionExtractedMeta,\n} from \"./A-FrameDefinition.types\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameNamespace } from \"../A-FrameNamespace\";\nimport { A_FrameHashHelper } from \"@adaas/a-frame/helpers/Hash.helper\";\nimport { A_FrameDefinitionFeatures } from \"./A-FrameDefinition.constants\";\nimport { A_FrameTargetType } from \"../A-Frame/A-Frame.types\";\nimport { A_FRAME_MODELS } from \"../A-FrameModels\";\n\nexport class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameDefinition_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _name!: string;\n    protected _type!: A_FrameTargetType;\n    protected _source!: string;\n    protected _dependency!: string;\n    protected _description?: string;\n    protected _namespace!: A_FrameNamespace;\n    protected _metadata?: Record<string, any>;\n    protected _vector?: A_FrameVector;\n\n\n    /**\n     * Common properties for all definition types (component, entity, container, fragment, method\n     */\n    protected _hash!: string;\n    protected _date?: string;\n    protected _model!: string;\n    protected _requestedModel!: string;\n    protected _credentialId!: string;\n    protected _aFrameVersion!: string;\n    protected _aFrameServerVersion!: string;\n    protected _aFrameMeta?: DefinitionExtractedMeta;\n\n    //-----------------------------------------------------------------------------------------------------\n    //---------------------------------------- Primary properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    /**\n     * Definition Identifier from ASEID unique name \n     */\n    get id(): string {\n        return this.aseid.id;\n    }\n    /**\n     * The type of the definition target (component, entity, container, fragment, or method)\n     */\n    get type(): A_FrameTargetType {\n        return this._type;\n    }\n    /**\n     * The name of the defined feature (e.g. \"MyComponent\", \"myMethod\", etc.)\n     */\n    get name(): string {\n        return this._name;\n    }\n    /**\n     * Description that explains the purpose of the defined feature, its inputs/outputs, or any other relevant information.\n     */\n    get description(): string | undefined {\n        return this._description;\n    }\n\n    get dependency(): A_Dependency {\n        return new A_Dependency(this._dependency);\n    }\n    /**\n     * The original source code string that implements the defined feature. This is the main content that gets embedded and indexed for search.\n     */\n    get source(): string {\n        return this._source;\n    }\n    /**\n     * The vector embedding representing the definition's source and metadata. This is populated after embedding and is used for similarity search in the index.\n     */\n    get vector(): A_FrameVector | undefined {\n        return this._vector;\n    }\n    /**\n     * Namespace to which this definition belongs. Used for scoping search and organizing definitions. If not specified, defaults to the global namespace.\n     */\n    get namespace(): A_FrameNamespace {\n        return this._namespace;\n    }\n    /**\n     * Additional metadata about the definition, stored as key-value pairs. This can include any relevant information that doesn't fit into the other properties but may be useful for search or organization.\n     */\n    get metadata(): Record<string, any> {\n        return this._metadata || {};\n    }\n    //-----------------------------------------------------------------------------------------------------\n    //----------------------------------- Common State properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    /**\n     * A unique hash string computed from the definition's name, source, description, and metadata. This is used to identify identical definitions and avoid duplicates in the index.\n     */\n    get hash(): string {\n        return this._hash;\n    }\n    /**\n     * The timestamp (in milliseconds since epoch) when the definition was embedded. This is used for tracking the freshness of the embedding and can be useful for re-embedding stale definitions.\n     */\n    get date(): string | undefined {\n        return this._date;\n    }\n    /**\n     * The name of the embedding model used to produce the vector. This is important for understanding the characteristics of the embedding and for debugging purposes.\n     */\n    get model(): string {\n        return this._model;\n    }\n    /**\n     * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`\n     * if not explicitly overridden. Sent to the server in the embed request.\n     */\n    get requestedModel(): string {\n        return this._requestedModel;\n    }\n    /**\n     * ID of the server credential (API key) used during embedding. This is useful for auditing and debugging embedding operations, especially when multiple credentials are in use.\n     */\n    get credentialId(): string | undefined {\n        return this._credentialId;\n    }\n    /**\n     * Version of @adaas/a-frame that produced this record. This helps track compatibility and understand which version of the library was used to create the definition.\n     */\n    get aFrameVersion(): string | undefined {\n        return this._aFrameVersion;\n    }\n    /**\n     * Version of a-frame-server that produced the vector. This is useful for debugging embedding issues and ensuring compatibility between the library and the embed server.\n     */\n    get aFrameServerVersion(): string | undefined {\n        return this._aFrameServerVersion;\n    }\n    /**\n     * Structural metadata extracted server-side when the definition was embedded.\n     * Includes discovered methods, @A_Inject dependencies, and @A_Feature.Extend names.\n     */\n    get aFrameMeta(): DefinitionExtractedMeta | undefined {\n        return this._aFrameMeta;\n    }\n    //-----------------------------------------------------------------------------------------------------\n    //--------------------------------------- Computed properties -----------------------------------------\n    //-----------------------------------------------------------------------------------------------------\n    get isEmbed(): boolean {\n        return this._vector !== undefined;\n    }\n    /**\n     * Saves the definition to storage. The actual implementation of saving is handled by the A_FrameDefinitionFeatures.Save feature, which can be implemented by the environment (e.g. browser, Node.js) to persist the definition in 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_FrameDefinitionFeatures.Save, scope);\n    }\n    /**\n     * Deletes the definition from storage. The actual implementation of deletion is handled by the A_FrameDefinitionFeatures.Destroy feature, which can be implemented by the environment to remove the definition 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_FrameDefinitionFeatures.Destroy, scope);\n    }\n    /**\n     * Loads the definition from storage. The actual implementation of loading is handled by the A_FrameDefinitionFeatures.Load feature, which can be implemented by the environment to retrieve the definition from the database, file system, or other storage mechanism and populate the entity's properties accordingly.\n     * \n     * @param scope \n     * @returns \n     */\n    load(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.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_FrameDefinition, 'source' | 'description' | 'metadata' | 'namespace'>>): void {\n        if (updates.source) this._source = updates.source;\n        if (updates.description !== undefined) this._description = updates.description;\n        if (updates.metadata !== undefined) this._metadata = updates.metadata;\n        if (updates.namespace !== undefined) this._namespace = updates.namespace;\n    }\n    /**\n     * Generates the embedding for the definition's source and metadata. \n     * \n     * @param scope \n     * @returns \n     */\n    embed(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameDefinitionFeatures.Embed, scope);\n    }\n\n\n    fromNew(newEntity: A_FrameDefinition_Init): void {\n        this._type = newEntity.type;\n\n        this.aseid = this.generateASEID({\n            id: A_FormatterHelper.toKebabCase(newEntity.dependency + '-' + newEntity.name),\n            scope: 'a-frame',\n        });\n\n        this._name = newEntity.name;\n\n        const hashSource = this._name + '//'\n            + (newEntity.description || '') + '//'\n            + (newEntity.metadata ? JSON.stringify(newEntity.metadata) : '') + '//'\n            + newEntity.source + '//'\n            + 'Namespace: ' + newEntity.namespace.id;\n\n        this._hash = A_FrameHashHelper.fnv1a(hashSource);\n\n        this._source = newEntity.source;\n        this._description = newEntity.description;\n        this._namespace = newEntity.namespace;\n        this._metadata = newEntity.metadata;\n        this._dependency = newEntity.dependency;\n        this._requestedModel = newEntity.model ?? A_FRAME_MODELS.ANTARES;\n    }\n\n    fromJSON(serialized: A_FrameDefinition_Serialized): void {\n        this._name = serialized.name;\n        this._hash = serialized.hash;\n        this._source = serialized.source || '';\n        this._description = serialized.description;\n        this._metadata = serialized.metadata;\n        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;\n        this._date = serialized.date;\n        this._model = serialized.model;\n        this._credentialId = serialized.credentialId;\n        this._aFrameVersion = serialized.aFrameVersion;\n        this._aFrameServerVersion = serialized.aFrameServerVersion;\n        this._aFrameMeta = serialized.aFrameMeta;\n    }\n\n    toJSON(): A_FrameDefinition_Serialized {\n        return {\n            ...super.toJSON(),\n            hash: this._hash,\n            name: this._name,\n            source: this._source,\n            description: this._description,\n            metadata: this._metadata,\n            namespace: this._namespace.aseid.toString(),\n            embedding: this._vector?.values,\n            date: this._date ?? new Date().toISOString(),\n            model: this._model,\n            credentialId: this._credentialId,\n            aFrameVersion: this._aFrameVersion,\n            aFrameServerVersion: this._aFrameServerVersion,\n            aFrameMeta: this._aFrameMeta,\n        };\n    }\n\n\n    // ─── Embedding hydration ──────────────────────────────────────────────────\n\n    /** Populate the vector from a pre-existing storage record */\n    // hydrateFromRecord(record: A_FrameDefinition_Record): void {\n    //     if (record.hash !== this._hash) {\n    //         throw new Error(\n    //             `A_FrameDefinition.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    //     this._model = record.model;\n    //     this._credentialId = record.credentialId;\n    //     this._aFrameVersion = record.aFrameVersion;\n    //     this._aFrameServerVersion = record.aFrameServerVersion;\n    // }\n\n    /** Populate the vector from a freshly-fetched embedding */\n    hydrateFromEmbedding(embedding: Float32Array, meta?: A_FrameDefinition_EmbeddingMeta): void {\n        this._vector = new A_FrameVector(embedding);\n        this._date = new Date().toISOString();\n        if (meta) {\n            this._model = meta.model;\n            this._credentialId = meta.credentialId ?? undefined;\n            this._aFrameVersion = meta.aFrameVersion;\n            this._aFrameServerVersion = meta.aFrameServerVersion;\n            if (meta.aFrameMeta)\n                this._aFrameMeta = meta.aFrameMeta;\n        }\n    }\n\n    // ─── Embedding input ──────────────────────────────────────────────────────\n\n    /**\n     * Build the text string sent to the embedding model.\n     * Concatenates name + description + source so the resulting\n     * vector captures both intent and implementation.\n     */\n    toString(): string {\n        const parts: string[] = [];\n        parts.push(`// ${this._name}`);\n        if (this._description) parts.push(`// ${this._description}`);\n        parts.push(this._source);\n        return parts.join('\\n');\n    }\n}\n"]}