@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/dynamic-feature.cjs

@@ -1,14 +1,48 @@
 'use strict';
 
+var chunkN4THTV6P_cjs = require('./chunk-N4THTV6P.cjs');
+require('./chunk-C6BBKHQG.cjs');
+var chunkBBYOL3LM_cjs = require('./chunk-BBYOL3LM.cjs');
+require('./chunk-WTBRJXFG.cjs');
+require('./chunk-KKL2DF2D.cjs');
+require('./chunk-BSBY37MG.cjs');
+require('./chunk-KK64VLZN.cjs');
+require('./chunk-7SEZMRLI.cjs');
+require('./chunk-3ZDHQOIU.cjs');
+require('./chunk-C37B34MH.cjs');
+require('./chunk-HELNAM5Y.cjs');
+require('./chunk-IYEDO7OQ.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-A7CJIUYY.cjs');
+require('./chunk-HAORARSB.cjs');
+require('./chunk-64QCZG53.cjs');
 require('./chunk-QFHZIG7Y.cjs');
-var aConcept = require('@adaas/a-concept');
 
-var A_FrameDynamicFeature = class extends aConcept.A_Entity {
-  static get concept() {
-    return "a-frame";
-  }
-};
 
-exports.A_FrameDynamicFeature = A_FrameDynamicFeature;
+
+Object.defineProperty(exports, "A_FrameMethodMapper", {
+  enumerable: true,
+  get: function () { return chunkN4THTV6P_cjs.A_FrameMethodMapper; }
+});
+Object.defineProperty(exports, "A_FrameDynamicFeature", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicFeature; }
+});
+Object.defineProperty(exports, "A_FrameDynamicFeatureError", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicFeatureError; }
+});
+Object.defineProperty(exports, "A_FrameDynamicFeatureFeatures", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicFeatureFeatures; }
+});
+Object.defineProperty(exports, "A_FrameDynamicFeatureOperation", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicFeatureOperation; }
+});
+Object.defineProperty(exports, "A_FrameMethodMapIndex", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameMethodMapIndex; }
+});
 //# sourceMappingURL=dynamic-feature.cjs.map
 //# sourceMappingURL=dynamic-feature.cjs.map

package/dist/node/dynamic-feature.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameDynamicFeature.entity.ts"],"names":["A_Entity"],"mappings":";;;;;AAKO,IAAM,qBAAA,GAAN,cAAoCA,iBAAA,CAAuE;AAAA,EAE9G,WAAW,OAAA,GAAkB;AACzB,IAAA,OAAO,SAAA;AAAA,EACX;AAGJ","file":"dynamic-feature.cjs","sourcesContent":["import { A_Entity } from \"@adaas/a-concept\";\nimport { A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized } from \"./A-FrameDynamicFeature.types\";\n\n\n\nexport class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n\n}"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"dynamic-feature.cjs"}

package/dist/node/dynamic-feature.d.mts

@@ -1,10 +1,70 @@
-import { A_TYPES__Entity_Serialized, A_Entity } from '@adaas/a-concept';
+import { A as A_FrameDynamicFeatureStepMapEntry, a as A_FrameDynamicFeatureElementMapEntry, b as A_FrameDynamicFeatureDefinition, c as A_FrameDynamicFeatureMapResult, d as A_FrameDynamicFeature, e as A_FrameChannel } from './A-FrameChannel.component-DMA-3sUB.mjs';
+export { f as A_FrameDynamicFeatureFeatureNames, g as A_FrameDynamicFeatureFeatures, h as A_FrameDynamicFeatureOperation, i as A_FrameDynamicFeatureOptions, j as A_FrameDynamicFeatureParam, k as A_FrameDynamicFeatureStep, l as A_FrameDynamicFeature_Init, m as A_FrameDynamicFeature_Serialized, n as A_FrameFeatureGenerateResponse, o as A_FrameFeaturePatchResponse } from './A-FrameChannel.component-DMA-3sUB.mjs';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.mjs';
+import './A-FrameChannel.types-BsE6bNky.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
+import './env.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameDynamicContentOperation.context-CoViNb19.mjs';
+import './A-FrameSegment.entity-D1xjjWvG.mjs';
+import './A-FrameCompletion.entity-Dzy9sIa8.mjs';
+import './A-FrameSchema.entity-DjYIhsoj.mjs';
 
-type A_FrameDynamicFeature_Init = {};
-type A_FrameDynamicFeature_Serialized = {} & A_TYPES__Entity_Serialized;
+declare class A_FrameDynamicFeatureError extends A_Error {
+    static readonly GenerationFailed = "GenerationFailed";
+    static readonly PatchFailed = "PatchFailed";
+    static readonly MappingFailed = "MappingFailed";
+    static readonly MethodNotFound = "MethodNotFound";
+    static readonly InvalidOperation = "InvalidOperation";
+}
+
+/**
+ * Context fragment that accumulates the method/component-mapping results
+ * produced by `A_FrameMethodMapper.mapFeature()`.
+ *
+ * Uses `prompt` as the unique key — same approach as `A_FrameComponentMapIndex`.
+ * Call `toResult(definition)` after the mapper finishes to build the fully
+ * structured `A_FrameDynamicFeatureMapResult`.
+ */
+declare class A_FrameMethodMapIndex extends A_Fragment {
+    private _stepEntries;
+    private _elementEntries;
+    constructor();
+    setStep(entry: A_FrameDynamicFeatureStepMapEntry): void;
+    getStep(prompt: string): A_FrameDynamicFeatureStepMapEntry | undefined;
+    setElement(entry: A_FrameDynamicFeatureElementMapEntry): void;
+    getElement(prompt: string): A_FrameDynamicFeatureElementMapEntry | undefined;
+    clear(): void;
+    get stepCount(): number;
+    get elementCount(): number;
+    get matchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    get unmatchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameDynamicFeatureMapResult` from the
+     * accumulated entries and the provided definition.
+     */
+    toResult(definition: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureMapResult;
+}
 
-declare class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {
-    static get concept(): string;
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicFeature`.
+ *
+ * Algorithm:
+ *  1. Read `feature.definition` (includes server-computed embeddings on steps
+ *     and supporting elements).
+ *  2. Run cosine-similarity search against `A_FrameIndex` for every step and
+ *     every supporting element.
+ *  3. For steps that remain unmatched, issue a server patch to refine their
+ *     descriptions (up to `feature.maxRetries` times), then re-match.
+ *  4. Mark any still-unmatched steps with a `matchError`.
+ *  5. Hydrate the feature with `mapIndex.toResult(def)`.
+ */
+declare class A_FrameMethodMapper extends A_Component {
+    mapFeature(feature: A_FrameDynamicFeature, mapIndex: A_FrameMethodMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
 }
 
-export { A_FrameDynamicFeature, type A_FrameDynamicFeature_Init, type A_FrameDynamicFeature_Serialized };
+export { A_FrameDynamicFeature, A_FrameDynamicFeatureDefinition, A_FrameDynamicFeatureElementMapEntry, A_FrameDynamicFeatureError, A_FrameDynamicFeatureMapResult, A_FrameDynamicFeatureStepMapEntry, A_FrameMethodMapIndex, A_FrameMethodMapper };

package/dist/node/dynamic-feature.d.ts

@@ -1,10 +1,70 @@
-import { A_TYPES__Entity_Serialized, A_Entity } from '@adaas/a-concept';
+import { A as A_FrameDynamicFeatureStepMapEntry, a as A_FrameDynamicFeatureElementMapEntry, b as A_FrameDynamicFeatureDefinition, c as A_FrameDynamicFeatureMapResult, d as A_FrameDynamicFeature, e as A_FrameChannel } from './A-FrameChannel.component-C0O3TaRD.js';
+export { f as A_FrameDynamicFeatureFeatureNames, g as A_FrameDynamicFeatureFeatures, h as A_FrameDynamicFeatureOperation, i as A_FrameDynamicFeatureOptions, j as A_FrameDynamicFeatureParam, k as A_FrameDynamicFeatureStep, l as A_FrameDynamicFeature_Init, m as A_FrameDynamicFeature_Serialized, n as A_FrameFeatureGenerateResponse, o as A_FrameFeaturePatchResponse } from './A-FrameChannel.component-C0O3TaRD.js';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.js';
+import './A-FrameChannel.types-DD2B11rf.js';
+import './A-FrameDefinition.types-BA_pLGpo.js';
+import './A-FrameNamespace.entity-HDXcLGcS.js';
+import './vector.js';
+import './env.js';
+import './A-FrameDefinition.entity-C0kzaGJ0.js';
+import './A-FrameDynamicContentOperation.context-C_aH1gEn.js';
+import './A-FrameSegment.entity-C0izuOmC.js';
+import './A-FrameCompletion.entity-Brx11JMp.js';
+import './A-FrameSchema.entity-DjYIhsoj.js';
 
-type A_FrameDynamicFeature_Init = {};
-type A_FrameDynamicFeature_Serialized = {} & A_TYPES__Entity_Serialized;
+declare class A_FrameDynamicFeatureError extends A_Error {
+    static readonly GenerationFailed = "GenerationFailed";
+    static readonly PatchFailed = "PatchFailed";
+    static readonly MappingFailed = "MappingFailed";
+    static readonly MethodNotFound = "MethodNotFound";
+    static readonly InvalidOperation = "InvalidOperation";
+}
+
+/**
+ * Context fragment that accumulates the method/component-mapping results
+ * produced by `A_FrameMethodMapper.mapFeature()`.
+ *
+ * Uses `prompt` as the unique key — same approach as `A_FrameComponentMapIndex`.
+ * Call `toResult(definition)` after the mapper finishes to build the fully
+ * structured `A_FrameDynamicFeatureMapResult`.
+ */
+declare class A_FrameMethodMapIndex extends A_Fragment {
+    private _stepEntries;
+    private _elementEntries;
+    constructor();
+    setStep(entry: A_FrameDynamicFeatureStepMapEntry): void;
+    getStep(prompt: string): A_FrameDynamicFeatureStepMapEntry | undefined;
+    setElement(entry: A_FrameDynamicFeatureElementMapEntry): void;
+    getElement(prompt: string): A_FrameDynamicFeatureElementMapEntry | undefined;
+    clear(): void;
+    get stepCount(): number;
+    get elementCount(): number;
+    get matchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    get unmatchedSteps(): A_FrameDynamicFeatureStepMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameDynamicFeatureMapResult` from the
+     * accumulated entries and the provided definition.
+     */
+    toResult(definition: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureMapResult;
+}
 
-declare class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {
-    static get concept(): string;
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicFeature`.
+ *
+ * Algorithm:
+ *  1. Read `feature.definition` (includes server-computed embeddings on steps
+ *     and supporting elements).
+ *  2. Run cosine-similarity search against `A_FrameIndex` for every step and
+ *     every supporting element.
+ *  3. For steps that remain unmatched, issue a server patch to refine their
+ *     descriptions (up to `feature.maxRetries` times), then re-match.
+ *  4. Mark any still-unmatched steps with a `matchError`.
+ *  5. Hydrate the feature with `mapIndex.toResult(def)`.
+ */
+declare class A_FrameMethodMapper extends A_Component {
+    mapFeature(feature: A_FrameDynamicFeature, mapIndex: A_FrameMethodMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
 }
 
-export { A_FrameDynamicFeature, type A_FrameDynamicFeature_Init, type A_FrameDynamicFeature_Serialized };
+export { A_FrameDynamicFeature, A_FrameDynamicFeatureDefinition, A_FrameDynamicFeatureElementMapEntry, A_FrameDynamicFeatureError, A_FrameDynamicFeatureMapResult, A_FrameDynamicFeatureStepMapEntry, A_FrameMethodMapIndex, A_FrameMethodMapper };

package/dist/node/dynamic-feature.mjs

@@ -1,12 +1,19 @@
+export { A_FrameMethodMapper } from './chunk-LWKFCMA7.mjs';
+import './chunk-OMGYXCFM.mjs';
+export { A_FrameDynamicFeature, A_FrameDynamicFeatureError, A_FrameDynamicFeatureFeatures, A_FrameDynamicFeatureOperation, A_FrameMethodMapIndex } from './chunk-7OLLATCC.mjs';
+import './chunk-GRNVK7DW.mjs';
+import './chunk-M2ZSE6YJ.mjs';
+import './chunk-5OTXZ7BB.mjs';
+import './chunk-K4MZY4ME.mjs';
+import './chunk-AMMQ76RJ.mjs';
+import './chunk-OK7I5OQ3.mjs';
+import './chunk-UCAWV2IG.mjs';
+import './chunk-SKIEPTFS.mjs';
+import './chunk-RVXASBMQ.mjs';
+import './chunk-442DXGOD.mjs';
+import './chunk-WXCQCHAX.mjs';
+import './chunk-IAL2NK2V.mjs';
+import './chunk-2HUSP34L.mjs';
 import './chunk-OI76LHVT.mjs';
-import { A_Entity } from '@adaas/a-concept';
-
-var A_FrameDynamicFeature = class extends A_Entity {
-  static get concept() {
-    return "a-frame";
-  }
-};
-
-export { A_FrameDynamicFeature };
 //# sourceMappingURL=dynamic-feature.mjs.map
 //# sourceMappingURL=dynamic-feature.mjs.map

package/dist/node/dynamic-feature.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameDynamicFeature.entity.ts"],"names":[],"mappings":";;;AAKO,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAuE;AAAA,EAE9G,WAAW,OAAA,GAAkB;AACzB,IAAA,OAAO,SAAA;AAAA,EACX;AAGJ","file":"dynamic-feature.mjs","sourcesContent":["import { A_Entity } from \"@adaas/a-concept\";\nimport { A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized } from \"./A-FrameDynamicFeature.types\";\n\n\n\nexport class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n\n}"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"dynamic-feature.mjs"}

package/dist/node/dynamic-structure.cjs

@@ -1,143 +1,52 @@
 'use strict';
 
+var chunkUDUJDEAO_cjs = require('./chunk-UDUJDEAO.cjs');
+require('./chunk-C6BBKHQG.cjs');
+var chunkBBYOL3LM_cjs = require('./chunk-BBYOL3LM.cjs');
+require('./chunk-WTBRJXFG.cjs');
+var chunkKKL2DF2D_cjs = require('./chunk-KKL2DF2D.cjs');
+require('./chunk-BSBY37MG.cjs');
+require('./chunk-KK64VLZN.cjs');
+require('./chunk-7SEZMRLI.cjs');
+require('./chunk-3ZDHQOIU.cjs');
+require('./chunk-C37B34MH.cjs');
+require('./chunk-HELNAM5Y.cjs');
+require('./chunk-IYEDO7OQ.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-A7CJIUYY.cjs');
+require('./chunk-HAORARSB.cjs');
+require('./chunk-64QCZG53.cjs');
 require('./chunk-QFHZIG7Y.cjs');
-var aConcept = require('@adaas/a-concept');
 
-// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts
-var A_FrameDynamicStructureFeatures = {
-  Load: "_A_FRAME_DYNAMIC_STRUCTURE_LOAD",
-  Update: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATE",
-  Generate: "_A_FRAME_DYNAMIC_STRUCTURE_GENERATE"
-};
-var A_FrameDynamicStructureEvents = {
-  Updated: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"
-};
-var A_FrameDynamicStructure = class extends aConcept.A_Entity {
-  constructor() {
-    super(...arguments);
-    this._version = 0;
-  }
-  static get concept() {
-    return "a-frame";
-  }
-  fromNew(options) {
-    this.createdAt = Date.now();
-    this._components = [];
-    this._history = [];
-    this._version = 0;
-    this.listeners = /* @__PURE__ */ new Map();
-    this.prompt = options.prompt;
-    this.model = options.model;
-    this.context = options.context ?? "generic";
-    this.metaHint = options.metaHint ?? "";
-    this.includeBases = (options.includeBases || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
-    this.excludeBases = (options.excludeBases || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
-    this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === "string" ? b : aConcept.A_CommonHelper.getComponentName(b));
-  }
-  // ── Public read-only accessors ───────────────────────────────────────────────
-  /** The current resolved component list (output of the last generate or patch). */
-  get components() {
-    return this._components;
-  }
-  /** Immutable patch history. */
-  get history() {
-    return this._history;
-  }
-  /** Current schema version (increments with each patch). */
-  get version() {
-    return this._version;
-  }
-  // ── Main pipeline ────────────────────────────────────────────────────────────
-  /**
-   * Run the full generation pipeline:
-   *   content generation → structure mapping → encode → patch
-   *
-   * @returns The resolved component list.
-   */
-  async generate() {
-  }
-  async patch(prompt) {
-    this._version++;
-  }
-  /**
-   * Restore the component list to a specific version from history.
-   * Creates a new patch entry so the revert itself is tracked.
-   */
-  revertTo(version) {
-    return this;
-  }
-  // ── Serialisation ─────────────────────────────────────────────────────────────
-  // /**
-  //  * Encode the complete DynamicStructure state to an opaque base64 string.
-  //  * Suitable for storage, transport, or embedding in another system.
-  //  */
-  // serialize(): string {
-  //     const payload: SerializedDynamicStructure = {
-  //         id: this.id,
-  //         version: this._version,
-  //         prompt: this.prompt,
-  //         components: [...this._components],
-  //         history: this._history.map(({ version, timestamp, reason }) => ({
-  //             version,
-  //             timestamp,
-  //             reason,
-  //         })),
-  //     };
-  //     return encode(payload);
-  // }
-  // /**
-  //  * Decode a serialised string back to its raw payload.
-  //  * Note: this is a static factory that returns the data only —
-  //  * it does not reconstruct a live DynamicStructure instance.
-  //  *
-  //  * To reconstruct a live instance, create a new DynamicStructure and
-  //  * call .patch() with the decoded components.
-  //  */
-  // static deserialize(encoded: string): SerializedDynamicStructure {
-  //     return decode<SerializedDynamicStructure>(encoded);
-  // }
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      name: this.prompt,
-      description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,
-      metadata: {
-        model: this.model,
-        context: this.context,
-        metaHint: this.metaHint,
-        includeBases: this.includeBases,
-        excludeBases: this.excludeBases,
-        enabledComponents: this.enabledComponents,
-        createdAt: this.createdAt
-      },
-      history: this._history.map((item) => item.toJSON())
-    };
-  }
-  // ── Internals ──────────────────────────────────────────────────────────────
-  subscribe(feature, listener) {
-    if (!this.listeners.has(feature)) {
-      this.listeners.set(feature, /* @__PURE__ */ new Set());
-    }
-    this.listeners.get(feature).add(listener);
-  }
-  unsubscribe(feature, listener) {
-    this.listeners.get(feature)?.delete(listener);
-  }
-  emit(stage, context) {
-    this.listeners.get(stage)?.forEach((listener) => listener(context));
-  }
-};
-var A_FrameDynamicStructureError = class extends aConcept.A_Error {
-};
-A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
-A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
-A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
-A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
-A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
 
-exports.A_FrameDynamicStructure = A_FrameDynamicStructure;
-exports.A_FrameDynamicStructureError = A_FrameDynamicStructureError;
-exports.A_FrameDynamicStructureEvents = A_FrameDynamicStructureEvents;
-exports.A_FrameDynamicStructureFeatures = A_FrameDynamicStructureFeatures;
+
+Object.defineProperty(exports, "A_FrameComponentMapper", {
+  enumerable: true,
+  get: function () { return chunkUDUJDEAO_cjs.A_FrameComponentMapper; }
+});
+Object.defineProperty(exports, "A_FrameComponentMapIndex", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameComponentMapIndex; }
+});
+Object.defineProperty(exports, "A_FrameDynamicStructure", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicStructure; }
+});
+Object.defineProperty(exports, "A_FrameDynamicStructureError", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicStructureError; }
+});
+Object.defineProperty(exports, "A_FrameDynamicStructureEvents", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicStructureEvents; }
+});
+Object.defineProperty(exports, "A_FrameDynamicStructureFeatures", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameDynamicStructureFeatures; }
+});
+Object.defineProperty(exports, "A_FrameDynamicPatch", {
+  enumerable: true,
+  get: function () { return chunkKKL2DF2D_cjs.A_FrameDynamicPatch; }
+});
 //# sourceMappingURL=dynamic-structure.cjs.map
 //# sourceMappingURL=dynamic-structure.cjs.map

package/dist/node/dynamic-structure.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.error.ts"],"names":["A_Entity","A_CommonHelper","A_Error"],"mappings":"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","file":"dynamic-structure.cjs","sourcesContent":["\n\n\nexport const A_FrameDynamicStructureFeatures = {\n    Load: '_A_FRAME_DYNAMIC_STRUCTURE_LOAD',\n    Update: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATE',\n    Generate: '_A_FRAME_DYNAMIC_STRUCTURE_GENERATE',\n} as const;\n\n\nexport const A_FrameDynamicStructureEvents = {\n    Updated: '_A_FRAME_DYNAMIC_STRUCTURE_UPDATED',\n} as const;","import { A_CommonHelper, A_Context, A_Entity, A_Scope, A_TYPES__A_DependencyInjectable } from \"@adaas/a-concept\";\nimport { A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized, A_FrameDynamicStructureEventNames, A_FrameDynamicStructureListener, A_FrameDynamicStructureResolvedComponent } from \"./A-FrameDynamicStructure.types\";\nimport { A_FrameDynamicStructureFeatures } from \"./A-FrameDynamicStructure.constants\";\nimport { A_FrameDynamicPatch } from \"../A-FrameDynamicPatch/A-FrameDynamicPatch.entity\";\nimport { A_FrameDynamicStructureError } from \"./A-FrameDynamicStructure.error\";\n\n\n\nexport class A_FrameDynamicStructure extends A_Entity<A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized> {\n    \n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    // ── Identity ────────────────────────────────────────────────────────────────\n    prompt!: string;\n    createdAt!: number;\n\n    // ── Config ──────────────────────────────────────────────────────────────────\n    private model!: string;\n    private context!: string;\n    private metaHint!: string;\n    private includeBases!: string[];\n    private excludeBases!: string[];\n    private enabledComponents!: string[];\n    // ── State ───────────────────────────────────────────────────────────────────\n    private _components!: A_FrameDynamicStructureResolvedComponent[]\n    private _history!: A_FrameDynamicPatch[]\n    private _version = 0;\n\n    private listeners!: Map<string, Set<A_FrameDynamicStructureListener>>;\n\n    fromNew(options: A_FrameDynamicStructure_Init) {\n        this.createdAt = Date.now();\n\n        this._components = [];\n        this._history = [];\n        this._version = 0;\n\n        this.listeners = new Map();\n\n        this.prompt = options.prompt;\n        this.model = options.model;\n        this.context = options.context ?? 'generic';\n        this.metaHint = options.metaHint ?? '';\n        this.includeBases = (options.includeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.excludeBases = (options.excludeBases || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n        this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === 'string' ? b : A_CommonHelper.getComponentName(b));\n    }\n\n    // ── Public read-only accessors ───────────────────────────────────────────────\n\n    /** The current resolved component list (output of the last generate or patch). */\n    get components(): ReadonlyArray<A_FrameDynamicStructureResolvedComponent> {\n        return this._components;\n    }\n\n    /** Immutable patch history. */\n    get history(): ReadonlyArray<A_FrameDynamicPatch> {\n        return this._history;\n    }\n\n    /** Current schema version (increments with each patch). */\n    get version(): number {\n        return this._version;\n    }\n\n\n    // ── Main pipeline ────────────────────────────────────────────────────────────\n\n    /**\n     * Run the full generation pipeline:\n     *   content generation → structure mapping → encode → patch\n     *\n     * @returns The resolved component list.\n     */\n    async generate(): Promise<void> {\n        // const context = new A_FrameDynamicStructureOperation();\n\n        // const executionScope = new A_Scope({\n        //     name: 'a-frame-dynamic-structure-generate',\n        //     fragments: [context],\n        // })\n        //     .inherit(A_Context.scope(this));\n\n        // try {\n\n        //     await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);\n\n        //     executionScope.destroy();\n\n        //     return context;\n\n        // } catch (err) {\n        //     executionScope.destroy();\n        //     throw new A_FrameDynamicStructureError({\n        //         title: A_FrameDynamicStructureError.GenerationFailed,\n        //         description: `Failed to generate structure: ${err instanceof Error ? err.message : String(err)}`,\n        //     });\n        // }\n    }\n\n\n    async patch(prompt: string): Promise<void> {\n        this._version++;\n\n    }\n\n    /**\n     * Restore the component list to a specific version from history.\n     * Creates a new patch entry so the revert itself is tracked.\n     */\n    revertTo(version: number): this {\n        // this._currentVersion = version;\n\n        return this;\n    }\n\n    // ── Serialisation ─────────────────────────────────────────────────────────────\n\n    // /**\n    //  * Encode the complete DynamicStructure state to an opaque base64 string.\n    //  * Suitable for storage, transport, or embedding in another system.\n    //  */\n    // serialize(): string {\n    //     const payload: SerializedDynamicStructure = {\n    //         id: this.id,\n    //         version: this._version,\n    //         prompt: this.prompt,\n    //         components: [...this._components],\n    //         history: this._history.map(({ version, timestamp, reason }) => ({\n    //             version,\n    //             timestamp,\n    //             reason,\n    //         })),\n    //     };\n    //     return encode(payload);\n    // }\n\n    // /**\n    //  * Decode a serialised string back to its raw payload.\n    //  * Note: this is a static factory that returns the data only —\n    //  * it does not reconstruct a live DynamicStructure instance.\n    //  *\n    //  * To reconstruct a live instance, create a new DynamicStructure and\n    //  * call .patch() with the decoded components.\n    //  */\n    // static deserialize(encoded: string): SerializedDynamicStructure {\n    //     return decode<SerializedDynamicStructure>(encoded);\n    // }\n\n    toJSON(): A_FrameDynamicStructure_Serialized {\n        return {\n            ...super.toJSON(),\n            name: this.prompt,\n            description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,\n            metadata: {\n                model: this.model,\n                context: this.context,\n                metaHint: this.metaHint,\n                includeBases: this.includeBases,\n                excludeBases: this.excludeBases,\n                enabledComponents: this.enabledComponents,\n                createdAt: this.createdAt,\n            },\n            history: this._history.map(item => item.toJSON()),\n        }\n    }\n\n    // ── Internals ──────────────────────────────────────────────────────────────\n    subscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        if (!this.listeners.has(feature)) {\n            this.listeners.set(feature, new Set());\n        }\n        this.listeners.get(feature)!.add(listener);\n    }\n\n    unsubscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void {\n        this.listeners.get(feature)?.delete(listener);\n    }\n\n\n    emit(stage: A_FrameDynamicStructureEventNames, context: any): void {\n        this.listeners.get(stage)?.forEach(listener => listener(context));\n    }\n\n}","import { A_Error } from \"@adaas/a-concept\";\n\n\nexport class A_FrameDynamicStructureError extends A_Error {\n\n    static readonly InvalidPatch = 'InvalidPatch';\n    static readonly VersionMismatch = 'VersionMismatch';\n    static readonly ComponentNotFound = 'ComponentNotFound';\n    static readonly InvalidOperation = 'InvalidOperation';\n\n    static readonly GenerationFailed = 'GenerationFailed';\n   \n}"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"dynamic-structure.cjs"}

package/dist/node/dynamic-structure.d.mts

@@ -1,5 +1,17 @@
-export { A as A_FrameDynamicStructure, a as A_FrameDynamicStructureDefinition, b as A_FrameDynamicStructureDefinitionEntity, c as A_FrameDynamicStructureEventNames, d as A_FrameDynamicStructureEvents, e as A_FrameDynamicStructureFeatureNames, f as A_FrameDynamicStructureFeatures, g as A_FrameDynamicStructureListener, h as A_FrameDynamicStructureResolvedComponent, i as A_FrameDynamicStructure_Init, j as A_FrameDynamicStructure_Serialized, B as BaseClassName, D as DynamicStructureDefaultBasesNames } from './A-FrameDynamicStructure.entity-DaBgSRCR.mjs';
-import { A_Error } from '@adaas/a-concept';
+import { p as A_FrameComponentMapEntry, q as A_FrameDynamicStructureDefinition, r as A_FrameComponentMapResult, s as A_FrameDynamicStructure, e as A_FrameChannel } from './A-FrameChannel.component-DMA-3sUB.mjs';
+export { t as A_FrameComponentMapOptions, u as A_FrameDynamicStructureDefinitionEntity, v as A_FrameDynamicStructureEvents, w as A_FrameDynamicStructureFeatureNames, x as A_FrameDynamicStructureFeatures, y as A_FrameDynamicStructureOptions, z as A_FrameDynamicStructure_Init, B as A_FrameDynamicStructure_Serialized, C as A_FrameStructureGenerateResponse, D as A_FrameStructurePatchResponse, E as A_FrameStructureSelectCandidate, F as A_FrameStructureSelectElement, G as A_FrameStructureSelectRequest, H as A_FrameStructureSelectResolution, I as A_FrameStructureSelectResolutionType, J as A_FrameStructureSelectResponse, K as BaseClassName, L as DynamicStructureDefaultBasesNames } from './A-FrameChannel.component-DMA-3sUB.mjs';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.mjs';
+export { m as A_FrameDynamicPatch, n as A_FrameDynamicPatch_Init, o as A_FrameDynamicPatch_Serialized } from './A-FrameDynamicContentOperation.context-CoViNb19.mjs';
+import './A-FrameChannel.types-BsE6bNky.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
+import './env.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameSegment.entity-D1xjjWvG.mjs';
+import './A-FrameCompletion.entity-Dzy9sIa8.mjs';
+import './A-FrameSchema.entity-DjYIhsoj.mjs';
 
 declare class A_FrameDynamicStructureError extends A_Error {
     static readonly InvalidPatch = "InvalidPatch";
@@ -9,4 +21,66 @@ declare class A_FrameDynamicStructureError extends A_Error {
     static readonly GenerationFailed = "GenerationFailed";
 }
 
-export { A_FrameDynamicStructureError };
+/**
+ * Context fragment that accumulates component-mapping results produced by
+ * `A_FrameComponentMapper.mapStructure()`.
+ *
+ * Uses a flat `prompt → A_FrameComponentMapEntry` map so lookups are O(1).
+ * Call `toResult(definition)` after the mapper has finished to build the
+ * structured `A_FrameComponentMapResult` that mirrors the definition layout.
+ */
+declare class A_FrameComponentMapIndex extends A_Fragment {
+    private _entries;
+    constructor();
+    /**
+     * Store (or overwrite) a map entry for the element identified by `entry.prompt`.
+     */
+    set(entry: A_FrameComponentMapEntry): void;
+    /**
+     * Retrieve the map entry for the given prompt, or `undefined` if not yet stored.
+     */
+    get(prompt: string): A_FrameComponentMapEntry | undefined;
+    /** Remove all stored entries. */
+    clear(): void;
+    /** Total number of stored entries. */
+    get size(): number;
+    /** All stored entries in insertion order. */
+    list(): A_FrameComponentMapEntry[];
+    /** Entries that have been successfully matched to a registered class. */
+    get matched(): A_FrameComponentMapEntry[];
+    /** Entries where no matching registered class was found. */
+    get unmatched(): A_FrameComponentMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameComponentMapResult` from the
+     * accumulated entries and the provided definition.
+     *
+     * For each element in the definition the method looks up its entry by
+     * prompt.  If no entry exists (element had no server embedding), a default
+     * unmatched entry is generated so the result shape always matches the
+     * definition shape.
+     */
+    toResult(definition: A_FrameDynamicStructureDefinition): A_FrameComponentMapResult;
+}
+
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicStructure`.
+ *
+ * Receives all necessary context via `@A_Inject` — it stores no state of its
+ * own.  Injects the calling structure (via `A_Caller`), the local definition
+ * index (`A_FrameIndex`), the map-result accumulator (`A_FrameComponentMapIndex`),
+ * and the HTTP channel (`A_FrameChannel`) needed for refinement retry calls.
+ *
+ * Algorithm:
+ *  1. Read `structure.definition` (raw, with server embeddings).
+ *  2. For every element run cosine-similarity search against `A_FrameIndex`.
+ *  3. For remaining unmatched elements (up to `structure.maxRetries`): ask the
+ *     server to refine their descriptions, then re-match the new definition.
+ *  4. Mark still-unmatched elements with a `matchError`.
+ *  5. Call `structure.hydrateFromMap(mapIndex.toResult(workingDef))`.
+ */
+declare class A_FrameComponentMapper extends A_Component {
+    mapStructure(structure: A_FrameDynamicStructure, mapIndex: A_FrameComponentMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
+}
+
+export { A_FrameComponentMapEntry, A_FrameComponentMapIndex, A_FrameComponentMapResult, A_FrameComponentMapper, A_FrameDynamicStructure, A_FrameDynamicStructureDefinition, A_FrameDynamicStructureError };

package/dist/node/dynamic-structure.d.ts

@@ -1,5 +1,17 @@
-export { A as A_FrameDynamicStructure, a as A_FrameDynamicStructureDefinition, b as A_FrameDynamicStructureDefinitionEntity, c as A_FrameDynamicStructureEventNames, d as A_FrameDynamicStructureEvents, e as A_FrameDynamicStructureFeatureNames, f as A_FrameDynamicStructureFeatures, g as A_FrameDynamicStructureListener, h as A_FrameDynamicStructureResolvedComponent, i as A_FrameDynamicStructure_Init, j as A_FrameDynamicStructure_Serialized, B as BaseClassName, D as DynamicStructureDefaultBasesNames } from './A-FrameDynamicStructure.entity-DaBgSRCR.js';
-import { A_Error } from '@adaas/a-concept';
+import { p as A_FrameComponentMapEntry, q as A_FrameDynamicStructureDefinition, r as A_FrameComponentMapResult, s as A_FrameDynamicStructure, e as A_FrameChannel } from './A-FrameChannel.component-C0O3TaRD.js';
+export { t as A_FrameComponentMapOptions, u as A_FrameDynamicStructureDefinitionEntity, v as A_FrameDynamicStructureEvents, w as A_FrameDynamicStructureFeatureNames, x as A_FrameDynamicStructureFeatures, y as A_FrameDynamicStructureOptions, z as A_FrameDynamicStructure_Init, B as A_FrameDynamicStructure_Serialized, C as A_FrameStructureGenerateResponse, D as A_FrameStructurePatchResponse, E as A_FrameStructureSelectCandidate, F as A_FrameStructureSelectElement, G as A_FrameStructureSelectRequest, H as A_FrameStructureSelectResolution, I as A_FrameStructureSelectResolutionType, J as A_FrameStructureSelectResponse, K as BaseClassName, L as DynamicStructureDefaultBasesNames } from './A-FrameChannel.component-C0O3TaRD.js';
+import { A_Error, A_Fragment, A_Component } from '@adaas/a-concept';
+import { A_FrameIndex } from './frame-index.js';
+export { m as A_FrameDynamicPatch, n as A_FrameDynamicPatch_Init, o as A_FrameDynamicPatch_Serialized } from './A-FrameDynamicContentOperation.context-C_aH1gEn.js';
+import './A-FrameChannel.types-DD2B11rf.js';
+import './A-FrameDefinition.types-BA_pLGpo.js';
+import './A-FrameNamespace.entity-HDXcLGcS.js';
+import './vector.js';
+import './env.js';
+import './A-FrameDefinition.entity-C0kzaGJ0.js';
+import './A-FrameSegment.entity-C0izuOmC.js';
+import './A-FrameCompletion.entity-Brx11JMp.js';
+import './A-FrameSchema.entity-DjYIhsoj.js';
 
 declare class A_FrameDynamicStructureError extends A_Error {
     static readonly InvalidPatch = "InvalidPatch";
@@ -9,4 +21,66 @@ declare class A_FrameDynamicStructureError extends A_Error {
     static readonly GenerationFailed = "GenerationFailed";
 }
 
-export { A_FrameDynamicStructureError };
+/**
+ * Context fragment that accumulates component-mapping results produced by
+ * `A_FrameComponentMapper.mapStructure()`.
+ *
+ * Uses a flat `prompt → A_FrameComponentMapEntry` map so lookups are O(1).
+ * Call `toResult(definition)` after the mapper has finished to build the
+ * structured `A_FrameComponentMapResult` that mirrors the definition layout.
+ */
+declare class A_FrameComponentMapIndex extends A_Fragment {
+    private _entries;
+    constructor();
+    /**
+     * Store (or overwrite) a map entry for the element identified by `entry.prompt`.
+     */
+    set(entry: A_FrameComponentMapEntry): void;
+    /**
+     * Retrieve the map entry for the given prompt, or `undefined` if not yet stored.
+     */
+    get(prompt: string): A_FrameComponentMapEntry | undefined;
+    /** Remove all stored entries. */
+    clear(): void;
+    /** Total number of stored entries. */
+    get size(): number;
+    /** All stored entries in insertion order. */
+    list(): A_FrameComponentMapEntry[];
+    /** Entries that have been successfully matched to a registered class. */
+    get matched(): A_FrameComponentMapEntry[];
+    /** Entries where no matching registered class was found. */
+    get unmatched(): A_FrameComponentMapEntry[];
+    /**
+     * Construct a fully structured `A_FrameComponentMapResult` from the
+     * accumulated entries and the provided definition.
+     *
+     * For each element in the definition the method looks up its entry by
+     * prompt.  If no entry exists (element had no server embedding), a default
+     * unmatched entry is generated so the result shape always matches the
+     * definition shape.
+     */
+    toResult(definition: A_FrameDynamicStructureDefinition): A_FrameComponentMapResult;
+}
+
+/**
+ * Stateless component that implements the `Map` feature for
+ * `A_FrameDynamicStructure`.
+ *
+ * Receives all necessary context via `@A_Inject` — it stores no state of its
+ * own.  Injects the calling structure (via `A_Caller`), the local definition
+ * index (`A_FrameIndex`), the map-result accumulator (`A_FrameComponentMapIndex`),
+ * and the HTTP channel (`A_FrameChannel`) needed for refinement retry calls.
+ *
+ * Algorithm:
+ *  1. Read `structure.definition` (raw, with server embeddings).
+ *  2. For every element run cosine-similarity search against `A_FrameIndex`.
+ *  3. For remaining unmatched elements (up to `structure.maxRetries`): ask the
+ *     server to refine their descriptions, then re-match the new definition.
+ *  4. Mark still-unmatched elements with a `matchError`.
+ *  5. Call `structure.hydrateFromMap(mapIndex.toResult(workingDef))`.
+ */
+declare class A_FrameComponentMapper extends A_Component {
+    mapStructure(structure: A_FrameDynamicStructure, mapIndex: A_FrameComponentMapIndex, frameIndex: A_FrameIndex, channel: A_FrameChannel): Promise<void>;
+}
+
+export { A_FrameComponentMapEntry, A_FrameComponentMapIndex, A_FrameComponentMapResult, A_FrameComponentMapper, A_FrameDynamicStructure, A_FrameDynamicStructureDefinition, A_FrameDynamicStructureError };