@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-KTKVW3PH.mjs

@@ -0,0 +1,286 @@
+import { A_Error, A_Entity, A_Fragment, A_CommonHelper, A_Scope, A_Context } from '@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_FrameDynamicStructureError = class extends A_Error {
+};
+A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
+A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
+A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
+A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
+A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
+var A_FrameDynamicPatch = class extends A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  // component count change vs. previous patch
+  fromNew(options) {
+    this.version = options.version;
+    this.timestamp = options.timestamp;
+    this.reason = options.reason;
+    this.encoded = options.encoded;
+    this.delta = options.delta;
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      version: this.version,
+      timestamp: this.timestamp,
+      reason: this.reason,
+      encoded: this.encoded,
+      delta: this.delta
+    };
+  }
+};
+var A_FrameDynamicStructureOperation = class extends A_Fragment {
+  constructor(params = {}) {
+    super({ name: "a-frame-dynamic-structure-operation-context" });
+    this._meta = /* @__PURE__ */ new Map();
+    this._meta.set("params", params);
+  }
+  get params() {
+    return this._meta.get("params");
+  }
+  get(key) {
+    return this._meta.get(key);
+  }
+  set(key, value) {
+    this._meta.set(key, value);
+  }
+};
+
+// src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts
+var A_FrameDynamicStructure = class extends A_Entity {
+  constructor() {
+    super(...arguments);
+    this._version = 0;
+  }
+  static get concept() {
+    return "a-frame";
+  }
+  fromNew(options) {
+    this.aseid = this.generateASEID();
+    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 : A_CommonHelper.getComponentName(b));
+    this.excludeBases = (options.excludeBases || []).map((b) => typeof b === "string" ? b : A_CommonHelper.getComponentName(b));
+    this.enabledComponents = (options.enabledComponents || []).map((b) => typeof b === "string" ? b : 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;
+  }
+  /** The AI model name to use for generation / patching. */
+  get modelName() {
+    return this.model;
+  }
+  // ── Main pipeline ────────────────────────────────────────────────────────────
+  /**
+   * Run the full generation pipeline:
+   *   content generation → structure mapping → encode → patch
+   *
+   * @returns The resolved component list.
+   */
+  async generate() {
+    const operation = new A_FrameDynamicStructureOperation();
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-structure-generate",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicStructureError({
+        title: A_FrameDynamicStructureError.GenerationFailed,
+        description: `Failed to generate structure: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  async patch(prompt) {
+    const operation = new A_FrameDynamicStructureOperation({ prompt });
+    const executionScope = new A_Scope({
+      name: "a-frame-dynamic-structure-patch",
+      fragments: [operation]
+    }).inherit(A_Context.scope(this));
+    try {
+      await this.call(A_FrameDynamicStructureFeatures.Update, executionScope);
+      executionScope.destroy();
+    } catch (err) {
+      executionScope.destroy();
+      throw new A_FrameDynamicStructureError({
+        title: A_FrameDynamicStructureError.GenerationFailed,
+        description: `Failed to patch structure: ${err instanceof Error ? err.message : String(err)}`
+      });
+    }
+  }
+  /**
+   * Populate the component list from pre-resolved components produced by an
+   * SSE-driven generate pipeline (where a server and client cooperate to map
+   * AI guesses to actual registered components).
+   *
+   * Creates the first history entry, identical to `hydrateFromGeneration`.
+   */
+  hydrateFromResolved(components, meta) {
+    this._components = components.map((c, i) => ({
+      component: c.component,
+      score: c.score,
+      meta: { ...c.meta || {}, id: c.meta?.id ?? `c-${i}` }
+    }));
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: `Generated for: "${this.prompt}"`,
+      encoded: Buffer.from(JSON.stringify(this._components)).toString("base64"),
+      delta: this._components.length
+    }));
+  }
+  /**
+   * Populate the component list from a freshly-received generate response.
+   * Creates the first history entry.
+   */
+  hydrateFromGeneration(guesses, meta) {
+    this._components = guesses.map((g, i) => ({
+      component: g.prompt,
+      score: 1,
+      meta: { id: `c-${i}`, type: g.type, role: g.role, sourceText: g.sourceText }
+    }));
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: `Generated for: "${this.prompt}"`,
+      encoded: Buffer.from(JSON.stringify(this._components)).toString("base64"),
+      delta: this._components.length
+    }));
+  }
+  /**
+   * Apply an AI-computed patch diff to the current component list.
+   * Increments the version and records a new history entry.
+   */
+  hydrateFromPatch(patchResult, meta) {
+    const prevCount = this._components.length;
+    this._components = this._components.filter(
+      (c) => !patchResult.removals.includes(c.meta.id)
+    );
+    for (const mod of patchResult.modifications) {
+      const comp = this._components.find((c) => c.meta.id === mod.componentId);
+      if (comp) {
+        comp.component = mod.newPrompt;
+        comp.meta.role = mod.newRole;
+      }
+    }
+    const maxId = this._components.reduce((max, c) => {
+      const n = parseInt((c.meta.id ?? "c-0").replace("c-", ""), 10);
+      return isNaN(n) ? max : Math.max(max, n);
+    }, -1);
+    const additions = patchResult.additions.map((a, i) => ({
+      component: a.prompt,
+      score: 1,
+      meta: { id: `c-${maxId + 1 + i}`, type: a.type, role: a.role, sourceText: a.sourceText }
+    }));
+    this._components = [...this._components, ...additions];
+    this._version++;
+    this._history.push(new A_FrameDynamicPatch({
+      version: this._version,
+      timestamp: Date.now(),
+      reason: patchResult.patchSummary,
+      encoded: Buffer.from(JSON.stringify(this._components)).toString("base64"),
+      delta: this._components.length - prevCount
+    }));
+  }
+  /**
+   * 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));
+  }
+};
+
+export { A_FrameDynamicPatch, A_FrameDynamicStructure, A_FrameDynamicStructureError, A_FrameDynamicStructureEvents, A_FrameDynamicStructureFeatures, A_FrameDynamicStructureOperation };
+//# sourceMappingURL=chunk-KTKVW3PH.mjs.map
+//# sourceMappingURL=chunk-KTKVW3PH.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.constants.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.error.ts","../../src/lib/A-FrameDynamicPatch/A-FrameDynamicPatch.entity.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructureOperation.context.ts","../../src/lib/A-FrameDynamicStructure/A-FrameDynamicStructure.entity.ts"],"names":["A_Entity"],"mappings":"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","file":"chunk-KTKVW3PH.mjs","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_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}","import { A_Entity } from \"@adaas/a-concept\";\nimport { A_FrameDynamicPatch_Init, A_FrameDynamicPatch_Serialized } from \"./A-FrameDynamicPatch.types\";\n\n\nexport class A_FrameDynamicPatch extends A_Entity<A_FrameDynamicPatch_Init, A_FrameDynamicPatch_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    version!: number;\n    timestamp!: number;\n    reason!: string;\n    encoded!: string;      // base64-encoded snapshot of components at this version\n    delta!: number;        // component count change vs. previous patch\n\n\n\n    fromNew(options: A_FrameDynamicPatch_Init) {\n        this.version = options.version;\n        this.timestamp = options.timestamp;\n        this.reason = options.reason;\n        this.encoded = options.encoded;\n        this.delta = options.delta;\n    }\n\n\n    toJSON(): A_FrameDynamicPatch_Serialized {\n        return {\n            ...super.toJSON(),\n            version: this.version,\n            timestamp: this.timestamp,\n            reason: this.reason,\n            encoded: this.encoded,\n            delta: this.delta,\n        }\n    }\n}","import { A_Fragment } from \"@adaas/a-concept\"\n\n\nexport class A_FrameDynamicStructureOperation<\n    _InputParams = any,\n> extends A_Fragment {\n\n    protected _meta: Map<string, any> = new Map();\n\n    constructor(\n        params: _InputParams = {} as _InputParams\n    ) {\n        super({ name: 'a-frame-dynamic-structure-operation-context' });\n        this._meta.set('params', params);\n\n    }\n\n    get params(): _InputParams {\n        return this._meta.get('params');\n    }\n\n\n    get(key: string) {\n        return this._meta.get(key);\n    }\n\n\n    set(key: string, value: any) {\n        this._meta.set(key, value);\n    }\n\n}\n","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\";\nimport { A_FrameDynamicStructureOperation } from \"./A-FrameDynamicStructureOperation.context\";\n\n\n/** Guess item as returned by POST /api/v1/structure/generate */\nexport interface A_FrameStructureGuessItem {\n    sourceText: string;\n    type: string;\n    prompt: string;\n    role: string;\n}\n\n/** Patch diff as returned by POST /api/v1/structure/patch */\nexport interface A_FrameStructurePatchResult {\n    patchSummary: string;\n    additions: A_FrameStructureGuessItem[];\n    removals: string[];\n    modifications: Array<{ componentId: string; newRole: string; newPrompt: string }>;\n}\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.aseid = this.generateASEID();\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    /** The AI model name to use for generation / patching. */\n    get modelName(): string {\n        return this.model;\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 operation = new A_FrameDynamicStructureOperation();\n\n        const executionScope = new A_Scope({\n            name: 'a-frame-dynamic-structure-generate',\n            fragments: [operation],\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n            await this.call(A_FrameDynamicStructureFeatures.Generate, executionScope);\n            executionScope.destroy();\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        const operation = new A_FrameDynamicStructureOperation({ prompt });\n\n        const executionScope = new A_Scope({\n            name: 'a-frame-dynamic-structure-patch',\n            fragments: [operation],\n        })\n            .inherit(A_Context.scope(this));\n\n        try {\n            await this.call(A_FrameDynamicStructureFeatures.Update, executionScope);\n            executionScope.destroy();\n        } catch (err) {\n            executionScope.destroy();\n            throw new A_FrameDynamicStructureError({\n                title: A_FrameDynamicStructureError.GenerationFailed,\n                description: `Failed to patch structure: ${err instanceof Error ? err.message : String(err)}`,\n            });\n        }\n    }\n\n    /**\n     * Populate the component list from pre-resolved components produced by an\n     * SSE-driven generate pipeline (where a server and client cooperate to map\n     * AI guesses to actual registered components).\n     *\n     * Creates the first history entry, identical to `hydrateFromGeneration`.\n     */\n    hydrateFromResolved(\n        components: A_FrameDynamicStructureResolvedComponent[],\n        meta: { model: string; serverVersion: string },\n    ): void {\n        this._components = components.map((c, i) => ({\n            component: c.component,\n            score: c.score,\n            meta: { ...(c.meta || {}), id: (c.meta as any)?.id ?? `c-${i}` },\n        }));\n\n        this._history.push(new A_FrameDynamicPatch({\n            version:   this._version,\n            timestamp: Date.now(),\n            reason:    `Generated for: \"${this.prompt}\"`,\n            encoded:   Buffer.from(JSON.stringify(this._components)).toString('base64'),\n            delta:     this._components.length,\n        }));\n    }\n\n    /**\n     * Populate the component list from a freshly-received generate response.\n     * Creates the first history entry.\n     */\n    hydrateFromGeneration(\n        guesses: A_FrameStructureGuessItem[],\n        meta: { model: string; serverVersion: string },\n    ): void {\n        this._components = guesses.map((g, i) => ({\n            component: g.prompt,\n            score: 1.0,\n            meta: { id: `c-${i}`, type: g.type, role: g.role, sourceText: g.sourceText },\n        }));\n\n        this._history.push(new A_FrameDynamicPatch({\n            version:   this._version,\n            timestamp: Date.now(),\n            reason:    `Generated for: \"${this.prompt}\"`,\n            encoded:   Buffer.from(JSON.stringify(this._components)).toString('base64'),\n            delta:     this._components.length,\n        }));\n    }\n\n    /**\n     * Apply an AI-computed patch diff to the current component list.\n     * Increments the version and records a new history entry.\n     */\n    hydrateFromPatch(\n        patchResult: A_FrameStructurePatchResult,\n        meta: { model: string; serverVersion: string },\n    ): void {\n        const prevCount = this._components.length;\n\n        // Removals\n        this._components = this._components.filter(\n            c => !patchResult.removals.includes((c.meta as any).id)\n        );\n\n        // Modifications\n        for (const mod of patchResult.modifications) {\n            const comp = this._components.find(c => (c.meta as any).id === mod.componentId);\n            if (comp) {\n                comp.component = mod.newPrompt;\n                (comp.meta as any).role = mod.newRole;\n            }\n        }\n\n        // Additions — generate new IDs from current max index\n        const maxId = this._components.reduce((max, c) => {\n            const n = parseInt(((c.meta as any).id ?? 'c-0').replace('c-', ''), 10);\n            return isNaN(n) ? max : Math.max(max, n);\n        }, -1);\n\n        const additions = patchResult.additions.map((a, i) => ({\n            component: a.prompt,\n            score: 1.0,\n            meta: { id: `c-${maxId + 1 + i}`, type: a.type, role: a.role, sourceText: a.sourceText },\n        }));\n\n        this._components = [...this._components, ...additions];\n        this._version++;\n\n        this._history.push(new A_FrameDynamicPatch({\n            version:   this._version,\n            timestamp: Date.now(),\n            reason:    patchResult.patchSummary,\n            encoded:   Buffer.from(JSON.stringify(this._components)).toString('base64'),\n            delta:     this._components.length - prevCount,\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}"]}

package/dist/node/chunk-KZPSF32W.mjs

@@ -0,0 +1,33 @@
+import { version } from './chunk-WEPNBKOA.mjs';
+import { A_Fragment } from '@adaas/a-concept';
+
+var A_FrameEnv = class extends A_Fragment {
+  get A_FRAME_FILE_EXTENSION() {
+    return ".aframe";
+  }
+  get A_FRAME_NAMESPACES_BIN() {
+    return `__namespaces${this.A_FRAME_FILE_EXTENSION}`;
+  }
+  get A_FRAME_SYNC() {
+    return process.env.A_FRAME_SYNC === "false" ? false : true;
+  }
+  get A_FRAME_TOKEN() {
+    return process.env.A_FRAME_TOKEN || "";
+  }
+  get A_FRAME_SERVER_URL() {
+    return process.env.A_FRAME_SERVER_URL || "http://localhost:3663";
+  }
+  get A_FRAME_SERVER_API_KEY() {
+    return process.env.A_FRAME_SERVER_API_KEY || "";
+  }
+  get A_FRAME_STORAGE_DIR() {
+    return process.env.A_FRAME_STORAGE_DIR || ".aframe";
+  }
+  get A_FRAME_VERSION() {
+    return version || "0.0.1";
+  }
+};
+
+export { A_FrameEnv };
+//# sourceMappingURL=chunk-KZPSF32W.mjs.map
+//# sourceMappingURL=chunk-KZPSF32W.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameEnv/A-FrameEnv.fragment.env-node.ts"],"names":[],"mappings":";;;AAKO,IAAM,UAAA,GAAN,cAAyB,UAAA,CAAkC;AAAA,EAE9D,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,SAAA;AAAA,EACX;AAAA,EAEA,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,CAAA,YAAA,EAAe,KAAK,sBAAsB,CAAA,CAAA;AAAA,EACrD;AAAA,EAEA,IAAI,YAAA,GAAe;AACf,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,YAAA,KAAiB,OAAA,GAAU,KAAA,GAAQ,IAAA;AAAA,EAC1D;AAAA,EAEA,IAAI,aAAA,GAAgB;AAChB,IAAA,OAAO,OAAA,CAAQ,IAAI,aAAA,IAAiB,EAAA;AAAA,EACxC;AAAA,EAEA,IAAI,kBAAA,GAAqB;AACrB,IAAA,OAAO,OAAA,CAAQ,IAAI,kBAAA,IAAsB,uBAAA;AAAA,EAC7C;AAAA,EAEA,IAAI,sBAAA,GAAyB;AACzB,IAAA,OAAO,OAAA,CAAQ,IAAI,sBAAA,IAA0B,EAAA;AAAA,EACjD;AAAA,EAEA,IAAI,mBAAA,GAAsB;AACtB,IAAA,OAAO,OAAA,CAAQ,IAAI,mBAAA,IAAuB,YAAA;AAAA,EAC9C;AAAA,EAEA,IAAI,eAAA,GAAkB;AAClB,IAAA,OAAW,OAAA,IAAW,OAAA;AAAA,EAC1B;AACJ","file":"chunk-KZPSF32W.mjs","sourcesContent":["import { A_Fragment } from \"@adaas/a-concept\";\nimport * as pkg from '../../../package.json';\nimport { IA_FrameEnv } from \"./A-FrameEnv.types\";\n\n\nexport class A_FrameEnv extends A_Fragment implements IA_FrameEnv {\n\n    get A_FRAME_FILE_EXTENSION() {\n        return '.aframe';\n    }\n\n    get A_FRAME_NAMESPACES_BIN() {\n        return `__namespaces${this.A_FRAME_FILE_EXTENSION}`;\n    }\n\n    get A_FRAME_SYNC() {\n        return process.env.A_FRAME_SYNC === 'false' ? false : true;\n    }\n\n    get A_FRAME_TOKEN() {\n        return process.env.A_FRAME_TOKEN || '';\n    }\n\n    get A_FRAME_SERVER_URL() {\n        return process.env.A_FRAME_SERVER_URL || 'http://localhost:3663';\n    }\n\n    get A_FRAME_SERVER_API_KEY() {\n        return process.env.A_FRAME_SERVER_API_KEY || '';\n    }\n\n    get A_FRAME_STORAGE_DIR() {\n        return process.env.A_FRAME_STORAGE_DIR || '.aframe';\n    }\n\n    get A_FRAME_VERSION() {\n        return pkg.version || '0.0.1';\n    }\n}"]}

package/dist/node/chunk-LWKFCMA7.mjs

@@ -0,0 +1,129 @@
+import { A_FrameIndex } from './chunk-OMGYXCFM.mjs';
+import { A_FrameDynamicFeature, A_FrameDynamicFeatureFeatures, A_FrameMethodMapIndex, A_FrameChannel, A_FrameChannelRequest, A_FrameFeatures, A_FrameDynamicFeatureError } from './chunk-7OLLATCC.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 } from '@adaas/a-concept';
+
+var A_FrameMethodMapper = class extends A_Component {
+  async mapFeature(feature, mapIndex, frameIndex, channel) {
+    const def = feature.definition;
+    if (!def) return;
+    const tryMatchStep = (step, minScore) => {
+      if (!step.embedding?.length) {
+        return { matchedClass: null, matchedMethod: null, matchScore: 0 };
+      }
+      const results = frameIndex.search(new A_FrameVector(step.embedding), { topK: 1 });
+      const top = results[0];
+      if (top && top.score >= minScore) {
+        const matchedClass = top.record.dependency.name;
+        const matchedMethod = top.record.name;
+        return { matchedClass, matchedMethod, matchScore: top.score };
+      }
+      return { matchedClass: null, matchedMethod: null, matchScore: top?.score ?? 0 };
+    };
+    const tryMatchElement = (el, minScore) => {
+      if (!el.embedding?.length) {
+        return { matchedClass: null, matchScore: 0 };
+      }
+      const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1 });
+      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 stripEmbeddings = (d) => {
+      const strip = (el) => {
+        const { embedding, ...rest } = el;
+        return rest;
+      };
+      return {
+        ...d,
+        steps: d.steps.map(strip),
+        components: d.components.map(strip),
+        fragments: d.fragments.map(strip),
+        entities: d.entities.map(strip)
+      };
+    };
+    const matchAll = (d) => {
+      mapIndex.clear();
+      for (const step of d.steps) {
+        mapIndex.setStep({
+          prompt: step.prompt,
+          inputs: step.inputs,
+          outputs: step.outputs,
+          ...tryMatchStep(step, feature.minScore)
+        });
+      }
+      for (const el of d.components) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+      for (const el of d.fragments) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+      for (const el of d.entities) {
+        mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });
+      }
+    };
+    let workingDef = def;
+    matchAll(workingDef);
+    for (let retry = 0; retry < feature.maxRetries; retry++) {
+      const unmatchedSteps = workingDef.steps.filter(
+        (step) => step.embedding?.length && mapIndex.getStep(step.prompt)?.matchedMethod === null
+      );
+      if (unmatchedSteps.length === 0) break;
+      const refinementInstruction = [
+        `The following workflow steps could not be matched to any registered method.`,
+        `Please re-describe each step with more specific, method-oriented language:`,
+        unmatchedSteps.map((s) => `- "${s.prompt}"`).join("\n")
+      ].join("\n");
+      const patchReq = new A_FrameChannelRequest(
+        "POST",
+        "/api/v1/feature/patch",
+        {
+          originalPrompt: feature.prompt,
+          definition: stripEmbeddings(workingDef),
+          patchInstruction: refinementInstruction,
+          model: feature.modelName,
+          context: feature.contextHint
+        }
+      );
+      const patchScope = new A_Scope({
+        name: `A_FrameMethodMapper.mapFeature:retry${retry}`,
+        fragments: [patchReq]
+      }).inherit(A_Context.scope(channel));
+      await channel.call(A_FrameFeatures.Request, patchScope);
+      patchScope.destroy();
+      if (!patchReq.response) break;
+      workingDef = patchReq.response.definition;
+      matchAll(workingDef);
+    }
+    for (const step of workingDef.steps) {
+      const entry = mapIndex.getStep(step.prompt);
+      if (entry && entry.matchedMethod === null && step.embedding?.length) {
+        mapIndex.setStep({
+          ...entry,
+          matchError: {
+            title: A_FrameDynamicFeatureError.MethodNotFound,
+            description: `Unable to match "${step.prompt}" to any registered method after ${feature.maxRetries} retries.`
+          }
+        });
+      }
+    }
+    feature.hydrateFromMap(mapIndex.toResult(workingDef));
+  }
+};
+__decorateClass([
+  A_Feature.Extend({
+    name: A_FrameDynamicFeatureFeatures.Map,
+    scope: [A_FrameDynamicFeature]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_FrameMethodMapIndex)),
+  __decorateParam(2, A_Inject(A_FrameIndex)),
+  __decorateParam(3, A_Inject(A_FrameChannel))
+], A_FrameMethodMapper.prototype, "mapFeature", 1);
+
+export { A_FrameMethodMapper };
+//# sourceMappingURL=chunk-LWKFCMA7.mjs.map
+//# sourceMappingURL=chunk-LWKFCMA7.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":[],"mappings":"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","file":"chunk-LWKFCMA7.mjs","sourcesContent":["import { A_Caller, A_Component, A_Context, A_Feature, 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_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameDynamicFeature } from \"./A-FrameDynamicFeature.entity\";\nimport { A_FrameDynamicFeatureFeatures } from \"./A-FrameDynamicFeature.constants\";\nimport { A_FrameDynamicFeatureError } from \"./A-FrameDynamicFeature.error\";\nimport {\n    A_FrameDynamicFeatureDefinition,\n    A_FrameDynamicFeatureElementMapEntry,\n    A_FrameDynamicFeatureStep,\n    A_FrameDynamicFeatureStepMapEntry,\n    A_FrameFeaturePatchResponse,\n} from \"./A-FrameDynamicFeature.types\";\nimport { A_FrameMethodMapIndex } from \"./A-FrameMethodMapIndex.context\";\n\n\n/**\n * Stateless component that implements the `Map` feature for\n * `A_FrameDynamicFeature`.\n *\n * Algorithm:\n *  1. Read `feature.definition` (includes server-computed embeddings on steps\n *     and supporting elements).\n *  2. Run cosine-similarity search against `A_FrameIndex` for every step and\n *     every supporting element.\n *  3. For steps that remain unmatched, issue a server patch to refine their\n *     descriptions (up to `feature.maxRetries` times), then re-match.\n *  4. Mark any still-unmatched steps with a `matchError`.\n *  5. Hydrate the feature with `mapIndex.toResult(def)`.\n */\nexport class A_FrameMethodMapper extends A_Component {\n\n    @A_Feature.Extend({\n        name: A_FrameDynamicFeatureFeatures.Map,\n        scope: [A_FrameDynamicFeature],\n    })\n    async mapFeature(\n        @A_Inject(A_Caller) feature: A_FrameDynamicFeature,\n        @A_Inject(A_FrameMethodMapIndex) mapIndex: A_FrameMethodMapIndex,\n        @A_Inject(A_FrameIndex) frameIndex: A_FrameIndex,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n    ): Promise<void> {\n\n        const def = feature.definition;\n        if (!def) return;\n\n        // ── helpers ──────────────────────────────────────────────────────────\n\n        const tryMatchStep = (\n            step: A_FrameDynamicFeatureStep,\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureStepMapEntry, 'matchedClass' | 'matchedMethod' | 'matchScore'> => {\n            if (!step.embedding?.length) {\n                return { matchedClass: null, matchedMethod: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(step.embedding), { topK: 1 });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                // Method definitions store name = \"methodName\" and dependency.name = \"ClassName\".\n                // Class definitions store both name and dependency.name as the class name.\n                const matchedClass = top.record.dependency.name;\n                const matchedMethod = top.record.name;\n                return { matchedClass, matchedMethod, matchScore: top.score };\n            }\n            return { matchedClass: null, matchedMethod: null, matchScore: top?.score ?? 0 };\n        };\n\n        const tryMatchElement = (\n            el: { prompt: string; class?: string; embedding?: number[] },\n            minScore: number,\n        ): Pick<A_FrameDynamicFeatureElementMapEntry, '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 });\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 stripEmbeddings = (d: A_FrameDynamicFeatureDefinition): A_FrameDynamicFeatureDefinition => {\n            const strip = (el: any): any => { const { embedding, ...rest } = el; return rest; };\n            return {\n                ...d,\n                steps:      d.steps.map(strip),\n                components: d.components.map(strip),\n                fragments:  d.fragments.map(strip),\n                entities:   d.entities.map(strip),\n            };\n        };\n\n        const matchAll = (d: A_FrameDynamicFeatureDefinition): void => {\n            mapIndex.clear();\n            for (const step of d.steps) {\n                mapIndex.setStep({\n                    prompt:  step.prompt,\n                    inputs:  step.inputs,\n                    outputs: step.outputs,\n                    ...tryMatchStep(step, feature.minScore),\n                });\n            }\n            for (const el of d.components) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.fragments) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n            for (const el of d.entities) {\n                mapIndex.setElement({ prompt: el.prompt, ...tryMatchElement(el, feature.minScore) });\n            }\n        };\n\n        // ── initial matching pass ─────────────────────────────────────────────\n\n        let workingDef = def;\n        matchAll(workingDef);\n\n        // ── retry loop: refine unmatched steps via server patch ───────────────\n\n        for (let retry = 0; retry < feature.maxRetries; retry++) {\n            const unmatchedSteps = workingDef.steps.filter(\n                step => step.embedding?.length && mapIndex.getStep(step.prompt)?.matchedMethod === null,\n            );\n            if (unmatchedSteps.length === 0) break;\n\n            const refinementInstruction = [\n                `The following workflow steps could not be matched to any registered method.`,\n                `Please re-describe each step with more specific, method-oriented language:`,\n                unmatchedSteps.map(s => `- \"${s.prompt}\"`).join('\\n'),\n            ].join('\\n');\n\n            const patchReq = new A_FrameChannelRequest<A_FrameFeaturePatchResponse>(\n                'POST',\n                '/api/v1/feature/patch',\n                {\n                    originalPrompt:    feature.prompt,\n                    definition:        stripEmbeddings(workingDef),\n                    patchInstruction:  refinementInstruction,\n                    model:             feature.modelName,\n                    context:           feature.contextHint,\n                },\n            );\n\n            const patchScope = new A_Scope({\n                name: `A_FrameMethodMapper.mapFeature:retry${retry}`,\n                fragments: [patchReq],\n            }).inherit(A_Context.scope(channel));\n\n            await channel.call(A_FrameFeatures.Request, patchScope);\n            patchScope.destroy();\n\n            if (!patchReq.response) break;\n\n            workingDef = patchReq.response.definition;\n            matchAll(workingDef);\n        }\n\n        // ── finalize: mark remaining unmatched steps with an error ────────────\n\n        for (const step of workingDef.steps) {\n            const entry = mapIndex.getStep(step.prompt);\n            if (entry && entry.matchedMethod === null && step.embedding?.length) {\n                mapIndex.setStep({\n                    ...entry,\n                    matchError: {\n                        title: A_FrameDynamicFeatureError.MethodNotFound,\n                        description: `Unable to match \"${step.prompt}\" to any registered method after ${feature.maxRetries} retries.`,\n                    },\n                });\n            }\n        }\n\n        // ── hydrate the feature with the map result ───────────────────────────\n\n        feature.hydrateFromMap(mapIndex.toResult(workingDef));\n    }\n}\n"]}