@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/chunk-MSOD5UQH.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var chunkHAMDDCPS_cjs = require('./chunk-HAMDDCPS.cjs');
+var aConcept = require('@adaas/a-concept');
+
+var A_FrameEnv = class extends aConcept.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 chunkHAMDDCPS_cjs.version || "0.0.1";
+  }
+  /**
+   * Maximum time (ms) the HTTP client waits for a single response.
+   * AI inference can be slow; default is 120 seconds.
+   * Override with A_FRAME_REQUEST_TIMEOUT env var.
+   */
+  get A_FRAME_REQUEST_TIMEOUT() {
+    const raw = process.env.A_FRAME_REQUEST_TIMEOUT;
+    const parsed = raw ? parseInt(raw, 10) : NaN;
+    return isNaN(parsed) ? 12e4 : parsed;
+  }
+};
+
+exports.A_FrameEnv = A_FrameEnv;
+//# sourceMappingURL=chunk-MSOD5UQH.cjs.map
+//# sourceMappingURL=chunk-MSOD5UQH.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameEnv/A-FrameEnv.fragment.env-node.ts"],"names":["A_Fragment","version"],"mappings":";;;;;AAKO,IAAM,UAAA,GAAN,cAAyBA,mBAAA,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,OAAWC,yBAAA,IAAW,OAAA;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,uBAAA,GAAkC;AAClC,IAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,CAAI,uBAAA;AACxB,IAAA,MAAM,MAAA,GAAS,GAAA,GAAM,QAAA,CAAS,GAAA,EAAK,EAAE,CAAA,GAAI,GAAA;AACzC,IAAA,OAAO,KAAA,CAAM,MAAM,CAAA,GAAI,IAAA,GAAU,MAAA;AAAA,EACrC;AACJ","file":"chunk-MSOD5UQH.cjs","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\n    /**\n     * Maximum time (ms) the HTTP client waits for a single response.\n     * AI inference can be slow; default is 120 seconds.\n     * Override with A_FRAME_REQUEST_TIMEOUT env var.\n     */\n    get A_FRAME_REQUEST_TIMEOUT(): number {\n        const raw = process.env.A_FRAME_REQUEST_TIMEOUT;\n        const parsed = raw ? parseInt(raw, 10) : NaN;\n        return isNaN(parsed) ? 120_000 : parsed;\n    }\n}"]}

package/dist/node/chunk-MVAWR76Q.cjs

@@ -0,0 +1,276 @@
+'use strict';
+
+var chunkZM2RLVVH_cjs = require('./chunk-ZM2RLVVH.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
+var chunk64QCZG53_cjs = require('./chunk-64QCZG53.cjs');
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-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 aConcept.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 aConcept.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: aConcept.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 = chunkZM2RLVVH_cjs.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 ?? chunk64QCZG53_cjs.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 chunkHAORARSB_cjs.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 chunkHAORARSB_cjs.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");
+  }
+};
+
+exports.A_FrameDefinition = A_FrameDefinition;
+exports.A_FrameDefinitionFeatures = A_FrameDefinitionFeatures;
+//# sourceMappingURL=chunk-MVAWR76Q.cjs.map
+//# sourceMappingURL=chunk-MVAWR76Q.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDefinition/A-FrameDefinition.constants.ts","../../src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts"],"names":["A_Entity","A_Dependency","A_FormatterHelper","A_FrameHashHelper","A_FRAME_MODELS","A_FrameVector"],"mappings":"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","file":"chunk-MVAWR76Q.cjs","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"]}

package/dist/node/chunk-MXUO7OR5.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+
+// src/lib/A-FrameCredentials/A-FrameCredentials.constants.ts
+var A_FrameCredentialsFeatures = {
+  Load: "_A_FRAME_CREDENTIALS_LOAD",
+  Save: "_A_FRAME_CREDENTIALS_SAVE",
+  Destroy: "_A_FRAME_CREDENTIALS_DESTROY"
+};
+var A_FrameCredentials = class extends aConcept.A_Entity {
+  static get concept() {
+    return "a-frame";
+  }
+  // ─── Getters ──────────────────────────────────────────────────────────────
+  get credentialId() {
+    return this._credentialId;
+  }
+  get name() {
+    return this._name;
+  }
+  get description() {
+    return this._description;
+  }
+  /**
+   * The raw encryption key as returned by the server.
+   * Use this for encrypting / decrypting data exchanged with the a-frame-mcp server.
+   */
+  get encryptionKey() {
+    return this._encryptionKey;
+  }
+  get algorithm() {
+    return this._algorithm;
+  }
+  get keyEncoding() {
+    return this._keyEncoding;
+  }
+  get usageNote() {
+    return this._usageNote;
+  }
+  get serverVersion() {
+    return this._serverVersion;
+  }
+  get isAuthenticated() {
+    return !!this._credentialId;
+  }
+  // ─── Features ─────────────────────────────────────────────────────────────
+  load(scope) {
+    return this.call(A_FrameCredentialsFeatures.Load, scope);
+  }
+  save(scope) {
+    return this.call(A_FrameCredentialsFeatures.Save, scope);
+  }
+  destroy(scope) {
+    return this.call(A_FrameCredentialsFeatures.Destroy, scope);
+  }
+  // ─── A_Entity lifecycle ───────────────────────────────────────────────────
+  fromNew(init) {
+    this.aseid = this.generateASEID({
+      id: init.id,
+      scope: "a-frame"
+    });
+    this._credentialId = init.id;
+    this._name = init.name;
+    this._description = init.description;
+    this._encryptionKey = init.encryption_key;
+    this._algorithm = init.algorithm;
+    this._keyEncoding = init.key_encoding;
+    this._usageNote = init.usage_note;
+    this._serverVersion = init.server_version;
+  }
+  fromJSON(serialized) {
+    this._credentialId = serialized.credentialId;
+    this._name = serialized.name;
+    this._description = serialized.description;
+    this._algorithm = serialized.algorithm;
+    this._keyEncoding = serialized.key_encoding;
+    this._serverVersion = serialized.serverVersion;
+    this._encryptionKey = "";
+  }
+  toJSON() {
+    return {
+      ...super.toJSON(),
+      credentialId: this._credentialId,
+      name: this._name,
+      description: this._description,
+      algorithm: this._algorithm,
+      key_encoding: this._keyEncoding,
+      serverVersion: this._serverVersion
+    };
+  }
+};
+
+exports.A_FrameCredentials = A_FrameCredentials;
+exports.A_FrameCredentialsFeatures = A_FrameCredentialsFeatures;
+//# sourceMappingURL=chunk-MXUO7OR5.cjs.map
+//# sourceMappingURL=chunk-MXUO7OR5.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameCredentials/A-FrameCredentials.constants.ts","../../src/lib/A-FrameCredentials/A-FrameCredentials.entity.ts"],"names":["A_Entity"],"mappings":"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","file":"chunk-MXUO7OR5.cjs","sourcesContent":["export const A_FrameCredentialsFeatures = {\n    Load: '_A_FRAME_CREDENTIALS_LOAD',\n    Save: '_A_FRAME_CREDENTIALS_SAVE',\n    Destroy: '_A_FRAME_CREDENTIALS_DESTROY',\n} as const;\n","import { A_Entity, A_Scope } from \"@adaas/a-concept\";\nimport {\n    A_FrameCredentials_Init,\n    A_FrameCredentials_Serialized,\n} from \"./A-FrameCredentials.types\";\nimport { A_FrameCredentialsFeatures } from \"./A-FrameCredentials.constants\";\n\n\nexport class A_FrameCredentials extends A_Entity<A_FrameCredentials_Init, A_FrameCredentials_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n    protected _credentialId!: string;\n    protected _name!: string;\n    protected _description?: string | null;\n    protected _encryptionKey!: string;\n    protected _algorithm!: string;\n    protected _keyEncoding!: string;\n    protected _usageNote?: string | null;\n    protected _serverVersion!: string;\n\n    // ─── Getters ──────────────────────────────────────────────────────────────\n\n    get credentialId(): string {\n        return this._credentialId;\n    }\n\n    get name(): string {\n        return this._name;\n    }\n\n    get description(): string | null | undefined {\n        return this._description;\n    }\n\n    /**\n     * The raw encryption key as returned by the server.\n     * Use this for encrypting / decrypting data exchanged with the a-frame-mcp server.\n     */\n    get encryptionKey(): string {\n        return this._encryptionKey;\n    }\n\n    get algorithm(): string {\n        return this._algorithm;\n    }\n\n    get keyEncoding(): string {\n        return this._keyEncoding;\n    }\n\n    get usageNote(): string | null | undefined {\n        return this._usageNote;\n    }\n\n    get serverVersion(): string {\n        return this._serverVersion;\n    }\n\n    get isAuthenticated(): boolean {\n        return !!this._credentialId;\n    }\n\n    // ─── Features ─────────────────────────────────────────────────────────────\n\n    load(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameCredentialsFeatures.Load, scope);\n    }\n\n    save(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameCredentialsFeatures.Save, scope);\n    }\n\n    destroy(scope?: A_Scope): Promise<void> | void {\n        return this.call(A_FrameCredentialsFeatures.Destroy, scope);\n    }\n\n    // ─── A_Entity lifecycle ───────────────────────────────────────────────────\n\n    fromNew(init: A_FrameCredentials_Init): void {\n        this.aseid = this.generateASEID({\n            id: init.id,\n            scope: 'a-frame',\n        });\n\n        this._credentialId = init.id;\n        this._name = init.name;\n        this._description = init.description;\n        this._encryptionKey = init.encryption_key;\n        this._algorithm = init.algorithm;\n        this._keyEncoding = init.key_encoding;\n        this._usageNote = init.usage_note;\n        this._serverVersion = init.server_version;\n    }\n\n    fromJSON(serialized: A_FrameCredentials_Serialized): void {\n        this._credentialId = serialized.credentialId;\n        this._name = serialized.name;\n        this._description = serialized.description;\n        this._algorithm = serialized.algorithm;\n        this._keyEncoding = serialized.key_encoding;\n        this._serverVersion = serialized.serverVersion;\n        // encryption_key is not serialized — must be fetched from server\n        this._encryptionKey = '';\n    }\n\n    toJSON(): A_FrameCredentials_Serialized {\n        return {\n            ...super.toJSON(),\n            credentialId: this._credentialId,\n            name: this._name,\n            description: this._description,\n            algorithm: this._algorithm,\n            key_encoding: this._keyEncoding,\n            serverVersion: this._serverVersion,\n        };\n    }\n}\n"]}

package/dist/node/chunk-N4THTV6P.cjs

@@ -0,0 +1,131 @@
+'use strict';
+
+var chunkC6BBKHQG_cjs = require('./chunk-C6BBKHQG.cjs');
+var chunkBBYOL3LM_cjs = require('./chunk-BBYOL3LM.cjs');
+var chunkHAORARSB_cjs = require('./chunk-HAORARSB.cjs');
+var chunkQFHZIG7Y_cjs = require('./chunk-QFHZIG7Y.cjs');
+var aConcept = require('@adaas/a-concept');
+
+var A_FrameMethodMapper = class extends aConcept.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 chunkHAORARSB_cjs.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 chunkHAORARSB_cjs.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 chunkBBYOL3LM_cjs.A_FrameChannelRequest(
+        "POST",
+        "/api/v1/feature/patch",
+        {
+          originalPrompt: feature.prompt,
+          definition: stripEmbeddings(workingDef),
+          patchInstruction: refinementInstruction,
+          model: feature.modelName,
+          context: feature.contextHint
+        }
+      );
+      const patchScope = new aConcept.A_Scope({
+        name: `A_FrameMethodMapper.mapFeature:retry${retry}`,
+        fragments: [patchReq]
+      }).inherit(aConcept.A_Context.scope(channel));
+      await channel.call(chunkBBYOL3LM_cjs.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: chunkBBYOL3LM_cjs.A_FrameDynamicFeatureError.MethodNotFound,
+            description: `Unable to match "${step.prompt}" to any registered method after ${feature.maxRetries} retries.`
+          }
+        });
+      }
+    }
+    feature.hydrateFromMap(mapIndex.toResult(workingDef));
+  }
+};
+chunkQFHZIG7Y_cjs.__decorateClass([
+  aConcept.A_Feature.Extend({
+    name: chunkBBYOL3LM_cjs.A_FrameDynamicFeatureFeatures.Map,
+    scope: [chunkBBYOL3LM_cjs.A_FrameDynamicFeature]
+  }),
+  chunkQFHZIG7Y_cjs.__decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  chunkQFHZIG7Y_cjs.__decorateParam(1, aConcept.A_Inject(chunkBBYOL3LM_cjs.A_FrameMethodMapIndex)),
+  chunkQFHZIG7Y_cjs.__decorateParam(2, aConcept.A_Inject(chunkC6BBKHQG_cjs.A_FrameIndex)),
+  chunkQFHZIG7Y_cjs.__decorateParam(3, aConcept.A_Inject(chunkBBYOL3LM_cjs.A_FrameChannel))
+], A_FrameMethodMapper.prototype, "mapFeature", 1);
+
+exports.A_FrameMethodMapper = A_FrameMethodMapper;
+//# sourceMappingURL=chunk-N4THTV6P.cjs.map
+//# sourceMappingURL=chunk-N4THTV6P.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":["A_Component","A_FrameVector","A_FrameChannelRequest","A_Scope","A_Context","A_FrameFeatures","A_FrameDynamicFeatureError","__decorateClass","A_Feature","A_FrameDynamicFeatureFeatures","A_FrameDynamicFeature","__decorateParam","A_Caller","A_FrameMethodMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":"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","file":"chunk-N4THTV6P.cjs","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"]}