@adaas/a-frame 0.0.23 → 0.1.2

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

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

package/dist/node/dynamic-structure.mjs

@@ -1,138 +1,19 @@
+export { A_FrameComponentMapper } from './chunk-674ZX6XJ.mjs';
+import './chunk-OMGYXCFM.mjs';
+export { A_FrameComponentMapIndex, A_FrameDynamicStructure, A_FrameDynamicStructureError, A_FrameDynamicStructureEvents, A_FrameDynamicStructureFeatures } from './chunk-7OLLATCC.mjs';
+import './chunk-GRNVK7DW.mjs';
+export { A_FrameDynamicPatch } from './chunk-M2ZSE6YJ.mjs';
+import './chunk-5OTXZ7BB.mjs';
+import './chunk-K4MZY4ME.mjs';
+import './chunk-AMMQ76RJ.mjs';
+import './chunk-OK7I5OQ3.mjs';
+import './chunk-UCAWV2IG.mjs';
+import './chunk-SKIEPTFS.mjs';
+import './chunk-RVXASBMQ.mjs';
+import './chunk-442DXGOD.mjs';
+import './chunk-WXCQCHAX.mjs';
+import './chunk-IAL2NK2V.mjs';
+import './chunk-2HUSP34L.mjs';
 import './chunk-OI76LHVT.mjs';
-import { A_Error, A_Entity, A_CommonHelper } 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_FrameDynamicStructure = class extends A_Entity {
-  constructor() {
-    super(...arguments);
-    this._version = 0;
-  }
-  static get concept() {
-    return "a-frame";
-  }
-  fromNew(options) {
-    this.createdAt = Date.now();
-    this._components = [];
-    this._history = [];
-    this._version = 0;
-    this.listeners = /* @__PURE__ */ new Map();
-    this.prompt = options.prompt;
-    this.model = options.model;
-    this.context = options.context ?? "generic";
-    this.metaHint = options.metaHint ?? "";
-    this.includeBases = (options.includeBases || []).map((b) => typeof b === "string" ? b : 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;
-  }
-  // ── Main pipeline ────────────────────────────────────────────────────────────
-  /**
-   * Run the full generation pipeline:
-   *   content generation → structure mapping → encode → patch
-   *
-   * @returns The resolved component list.
-   */
-  async generate() {
-  }
-  async patch(prompt) {
-    this._version++;
-  }
-  /**
-   * Restore the component list to a specific version from history.
-   * Creates a new patch entry so the revert itself is tracked.
-   */
-  revertTo(version) {
-    return this;
-  }
-  // ── Serialisation ─────────────────────────────────────────────────────────────
-  // /**
-  //  * Encode the complete DynamicStructure state to an opaque base64 string.
-  //  * Suitable for storage, transport, or embedding in another system.
-  //  */
-  // serialize(): string {
-  //     const payload: SerializedDynamicStructure = {
-  //         id: this.id,
-  //         version: this._version,
-  //         prompt: this.prompt,
-  //         components: [...this._components],
-  //         history: this._history.map(({ version, timestamp, reason }) => ({
-  //             version,
-  //             timestamp,
-  //             reason,
-  //         })),
-  //     };
-  //     return encode(payload);
-  // }
-  // /**
-  //  * Decode a serialised string back to its raw payload.
-  //  * Note: this is a static factory that returns the data only —
-  //  * it does not reconstruct a live DynamicStructure instance.
-  //  *
-  //  * To reconstruct a live instance, create a new DynamicStructure and
-  //  * call .patch() with the decoded components.
-  //  */
-  // static deserialize(encoded: string): SerializedDynamicStructure {
-  //     return decode<SerializedDynamicStructure>(encoded);
-  // }
-  toJSON() {
-    return {
-      ...super.toJSON(),
-      name: this.prompt,
-      description: `DynamicStructure with ${this._components.length} components and ${this._history.length} patches`,
-      metadata: {
-        model: this.model,
-        context: this.context,
-        metaHint: this.metaHint,
-        includeBases: this.includeBases,
-        excludeBases: this.excludeBases,
-        enabledComponents: this.enabledComponents,
-        createdAt: this.createdAt
-      },
-      history: this._history.map((item) => item.toJSON())
-    };
-  }
-  // ── Internals ──────────────────────────────────────────────────────────────
-  subscribe(feature, listener) {
-    if (!this.listeners.has(feature)) {
-      this.listeners.set(feature, /* @__PURE__ */ new Set());
-    }
-    this.listeners.get(feature).add(listener);
-  }
-  unsubscribe(feature, listener) {
-    this.listeners.get(feature)?.delete(listener);
-  }
-  emit(stage, context) {
-    this.listeners.get(stage)?.forEach((listener) => listener(context));
-  }
-};
-var A_FrameDynamicStructureError = class extends A_Error {
-};
-A_FrameDynamicStructureError.InvalidPatch = "InvalidPatch";
-A_FrameDynamicStructureError.VersionMismatch = "VersionMismatch";
-A_FrameDynamicStructureError.ComponentNotFound = "ComponentNotFound";
-A_FrameDynamicStructureError.InvalidOperation = "InvalidOperation";
-A_FrameDynamicStructureError.GenerationFailed = "GenerationFailed";
-
-export { A_FrameDynamicStructure, A_FrameDynamicStructureError, A_FrameDynamicStructureEvents, A_FrameDynamicStructureFeatures };
 //# sourceMappingURL=dynamic-structure.mjs.map
 //# sourceMappingURL=dynamic-structure.mjs.map

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

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

package/dist/node/env.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkB7ZDJXD3_cjs = require('./chunk-B7ZDJXD3.cjs');
-require('./chunk-3LOMGNWA.cjs');
+var chunkBSBY37MG_cjs = require('./chunk-BSBY37MG.cjs');
+require('./chunk-HELNAM5Y.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 
 
 
 Object.defineProperty(exports, "A_FrameEnv", {
   enumerable: true,
-  get: function () { return chunkB7ZDJXD3_cjs.A_FrameEnv; }
+  get: function () { return chunkBSBY37MG_cjs.A_FrameEnv; }
 });
 //# sourceMappingURL=env.cjs.map
 //# sourceMappingURL=env.cjs.map

package/dist/node/env.d.mts

@@ -5,6 +5,18 @@ interface IA_FrameEnv {
     A_FRAME_SERVER_URL: string;
     A_FRAME_SERVER_API_KEY: string;
     A_FRAME_STORAGE_DIR: string;
+    /**
+     * Glob pattern(s) used to discover additional `.aframe` storage directories
+     * at startup.  Multiple patterns can be provided as a comma-separated list.
+     * Definitions and namespaces found in these locations are merged with the
+     * primary storage (read-only merge — writes always go to A_FRAME_STORAGE_DIR).
+     *
+     * Default: `node_modules/**\/.aframe` — discovers embedded storage shipped
+     * inside npm packages.
+     *
+     * Set A_FRAME_STORAGE_PATTERN='' to disable scanning entirely.
+     */
+    A_FRAME_STORAGE_PATTERN: string;
     A_FRAME_VERSION: string;
 }
 
@@ -16,7 +28,21 @@ declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
     get A_FRAME_SERVER_URL(): string;
     get A_FRAME_SERVER_API_KEY(): string;
     get A_FRAME_STORAGE_DIR(): string;
+    /**
+     * Comma-separated glob pattern(s) used to discover additional storage
+     * directories at startup (read-only merge source).
+     *
+     * Each pattern is resolved relative to `process.cwd()`.
+     * Default scans for any `.aframe` folder inside node_modules packages.
+     */
+    get A_FRAME_STORAGE_PATTERN(): string;
     get A_FRAME_VERSION(): string;
+    /**
+     * 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(): number;
 }
 
 export { A_FrameEnv };

package/dist/node/env.d.ts

@@ -5,6 +5,18 @@ interface IA_FrameEnv {
     A_FRAME_SERVER_URL: string;
     A_FRAME_SERVER_API_KEY: string;
     A_FRAME_STORAGE_DIR: string;
+    /**
+     * Glob pattern(s) used to discover additional `.aframe` storage directories
+     * at startup.  Multiple patterns can be provided as a comma-separated list.
+     * Definitions and namespaces found in these locations are merged with the
+     * primary storage (read-only merge — writes always go to A_FRAME_STORAGE_DIR).
+     *
+     * Default: `node_modules/**\/.aframe` — discovers embedded storage shipped
+     * inside npm packages.
+     *
+     * Set A_FRAME_STORAGE_PATTERN='' to disable scanning entirely.
+     */
+    A_FRAME_STORAGE_PATTERN: string;
     A_FRAME_VERSION: string;
 }
 
@@ -16,7 +28,21 @@ declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
     get A_FRAME_SERVER_URL(): string;
     get A_FRAME_SERVER_API_KEY(): string;
     get A_FRAME_STORAGE_DIR(): string;
+    /**
+     * Comma-separated glob pattern(s) used to discover additional storage
+     * directories at startup (read-only merge source).
+     *
+     * Each pattern is resolved relative to `process.cwd()`.
+     * Default scans for any `.aframe` folder inside node_modules packages.
+     */
+    get A_FRAME_STORAGE_PATTERN(): string;
     get A_FRAME_VERSION(): string;
+    /**
+     * 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(): number;
 }
 
 export { A_FrameEnv };

package/dist/node/env.mjs

@@ -1,5 +1,5 @@
-export { A_FrameEnv } from './chunk-JQBYDEMW.mjs';
-import './chunk-TO4BPKCY.mjs';
+export { A_FrameEnv } from './chunk-5OTXZ7BB.mjs';
+import './chunk-SKIEPTFS.mjs';
 import './chunk-OI76LHVT.mjs';
 //# sourceMappingURL=env.mjs.map
 //# sourceMappingURL=env.mjs.map

package/dist/node/frame-index.cjs

@@ -1,16 +1,19 @@
 'use strict';
 
-var chunkRRLTGGM7_cjs = require('./chunk-RRLTGGM7.cjs');
-require('./chunk-KLG6HKFU.cjs');
+require('./chunk-652OEICJ.cjs');
+var chunkC6BBKHQG_cjs = require('./chunk-C6BBKHQG.cjs');
+require('./chunk-7SEZMRLI.cjs');
 require('./chunk-ZM2RLVVH.cjs');
-require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-A7CJIUYY.cjs');
+require('./chunk-HAORARSB.cjs');
+require('./chunk-64QCZG53.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 
 
 
 Object.defineProperty(exports, "A_FrameIndex", {
   enumerable: true,
-  get: function () { return chunkRRLTGGM7_cjs.A_FrameIndex; }
+  get: function () { return chunkC6BBKHQG_cjs.A_FrameIndex; }
 });
 //# sourceMappingURL=frame-index.cjs.map
 //# sourceMappingURL=frame-index.cjs.map

package/dist/node/frame-index.d.mts

@@ -1,7 +1,8 @@
 import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Fragment, A_Scope, ASEID } from '@adaas/a-concept';
 import { A_FrameVector } from './vector.mjs';
-import { A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
-import { A as A_FrameDefinition, o as A_FrameTargetType } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import { c as A_FrameTargetType } from './A-FrameDefinition.types-BT02yAhQ.mjs';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-yA0GsBoe.mjs';
 
 type A_FrameIndexTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
 type A_FrameMetaDefinition<T extends Record<string, any> = {}> = {
@@ -26,6 +27,34 @@ type A_FrameIndexMetaMethodMeta = {
     description?: string;
     methodName: string;
 };
+/**
+ * Describes a single inheritance constraint applied when listing or searching
+ * definitions.
+ *
+ * - `class`  — the target constructor to test against
+ * - `strict` — controls how deep the prototype chain is walked:
+ *     - `false` (default) — matches any descendant at **any depth**
+ *       (`targetClass.isPrototypeOf(originClass)`)
+ *     - `true`  — matches only **direct children** (one prototype hop):
+ *       (`Object.getPrototypeOf(originClass) === targetClass`)
+ *
+ * @example
+ * // All definitions whose origin class extends A_Container (any depth)
+ * { class: A_Container }
+ *
+ * // Only definitions whose origin class directly extends A_Container
+ * { class: A_Container, strict: true }
+ *
+ * // All definitions whose origin class extends HttpServer at any depth
+ * { class: HttpServer, strict: false }
+ *
+ * // Combine multiple filters (OR semantics — a definition passes if ANY filter matches)
+ * [{ class: A_Fragment }, { class: A_Entity, strict: true }]
+ */
+type A_FrameInheritanceFilter = {
+    class: Function;
+    strict?: boolean;
+};
 type A_FrameSearchOptions = {
     /** Maximum number of results; default 10 */
     topK?: number;
@@ -33,6 +62,24 @@ type A_FrameSearchOptions = {
     namespace?: string;
     /** Minimum cosine similarity score (0–1); default 0 */
     minScore?: number;
+    /**
+     * Restrict the candidate pool to definitions whose origin class satisfies
+     * one or more inheritance rules.  Multiple entries use OR semantics —
+     * a definition passes if it matches ANY of the provided filters.
+     */
+    inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[];
+};
+/**
+ * Options accepted by `A_FrameIndex.listDefinitions()`.
+ */
+type A_FrameListOptions = {
+    /** Restrict to a single namespace */
+    namespace?: string | A_FrameNamespace;
+    /**
+     * Restrict to definitions whose origin class satisfies one or more
+     * inheritance rules.  Multiple entries use OR semantics.
+     */
+    inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[];
 };
 type A_FrameDefinition_SearchResult = {
     record: A_FrameDefinition;
@@ -43,12 +90,11 @@ declare class A_FrameIndex extends A_Fragment {
     private static _instance;
     static get instance(): A_FrameIndex;
     static get indexSize(): number;
+    static get scope(): A_Scope;
     static inherit(scope: A_Scope): void;
     static addDefinition(def: A_FrameDefinition): void;
     static getDefinition(nameOrHash: string): A_FrameDefinition | undefined;
-    static listDefinitions(filter: {
-        namespace?: string | A_FrameNamespace;
-    }): A_FrameDefinition[];
+    static listDefinitions(filter: A_FrameListOptions): A_FrameDefinition[];
     static removeDefinition(def: A_FrameDefinition): void;
     static addNamespace(namespace: A_FrameNamespace): void;
     static getDefaultNamespace(): A_FrameNamespace;
@@ -69,9 +115,7 @@ declare class A_FrameIndex extends A_Fragment {
     inherit(scope: A_Scope): void;
     addDefinition(def: A_FrameDefinition): void;
     getDefinition(name: string): A_FrameDefinition | undefined;
-    listDefinitions(filter?: {
-        namespace?: string | A_FrameNamespace;
-    }): A_FrameDefinition[];
+    listDefinitions(filter?: A_FrameListOptions): A_FrameDefinition[];
     removeDefinition(def: A_FrameDefinition): void;
     addNamespace(namespace: A_FrameNamespace): void;
     getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
@@ -82,6 +126,23 @@ declare class A_FrameIndex extends A_Fragment {
      * Search by a pre-computed embedding vector (cosine similarity).
      */
     search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    /**
+     * Test whether a definition's resolved constructor satisfies at least one
+     * of the provided inheritance filters (OR semantics).
+     *
+     * The constructor is resolved from the internal scope by the definition's
+     * name using `scope.resolveConstructor(name)` — the same mechanism the
+     * framework uses everywhere for class lookup.
+     *
+     * - `strict: false` (default) — any depth, using A_Context's O(1) indexed
+     *   inheritance map: `A_Context.isIndexedInheritedFrom(ctor, targetClass)`
+     * - `strict: true`            — direct child only:
+     *   `Object.getPrototypeOf(ctor) === targetClass`
+     *
+     * Definitions whose name cannot be resolved from the scope (e.g. restored
+     * from storage without a live container) never match.
+     */
+    private matchesInheritanceFilters;
     cosineSimilarity(a: A_FrameVector, b?: A_FrameVector): number;
     euclideanDistance(a: A_FrameVector, b: A_FrameVector): number;
     nearest(query: A_FrameVector, vectors: readonly A_FrameVector[], limit?: number): A_FrameVector[];
@@ -92,4 +153,4 @@ declare class A_FrameIndex extends A_Fragment {
     private assertSameLength;
 }
 
-export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameMetaDefinition, type A_FrameSearchOptions };
+export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameInheritanceFilter, type A_FrameListOptions, type A_FrameMetaDefinition, type A_FrameSearchOptions };

package/dist/node/frame-index.d.ts

@@ -1,7 +1,8 @@
 import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Fragment, A_Scope, ASEID } from '@adaas/a-concept';
 import { A_FrameVector } from './vector.js';
-import { A as A_FrameNamespace } from './A-FrameNamespace.entity-D3fZBGDx.js';
-import { A as A_FrameDefinition, o as A_FrameTargetType } from './A-FrameDefinition.entity-CAUOdEvU.js';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-HDXcLGcS.js';
+import { c as A_FrameTargetType } from './A-FrameDefinition.types-BA_pLGpo.js';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-C0kzaGJ0.js';
 
 type A_FrameIndexTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
 type A_FrameMetaDefinition<T extends Record<string, any> = {}> = {
@@ -26,6 +27,34 @@ type A_FrameIndexMetaMethodMeta = {
     description?: string;
     methodName: string;
 };
+/**
+ * Describes a single inheritance constraint applied when listing or searching
+ * definitions.
+ *
+ * - `class`  — the target constructor to test against
+ * - `strict` — controls how deep the prototype chain is walked:
+ *     - `false` (default) — matches any descendant at **any depth**
+ *       (`targetClass.isPrototypeOf(originClass)`)
+ *     - `true`  — matches only **direct children** (one prototype hop):
+ *       (`Object.getPrototypeOf(originClass) === targetClass`)
+ *
+ * @example
+ * // All definitions whose origin class extends A_Container (any depth)
+ * { class: A_Container }
+ *
+ * // Only definitions whose origin class directly extends A_Container
+ * { class: A_Container, strict: true }
+ *
+ * // All definitions whose origin class extends HttpServer at any depth
+ * { class: HttpServer, strict: false }
+ *
+ * // Combine multiple filters (OR semantics — a definition passes if ANY filter matches)
+ * [{ class: A_Fragment }, { class: A_Entity, strict: true }]
+ */
+type A_FrameInheritanceFilter = {
+    class: Function;
+    strict?: boolean;
+};
 type A_FrameSearchOptions = {
     /** Maximum number of results; default 10 */
     topK?: number;
@@ -33,6 +62,24 @@ type A_FrameSearchOptions = {
     namespace?: string;
     /** Minimum cosine similarity score (0–1); default 0 */
     minScore?: number;
+    /**
+     * Restrict the candidate pool to definitions whose origin class satisfies
+     * one or more inheritance rules.  Multiple entries use OR semantics —
+     * a definition passes if it matches ANY of the provided filters.
+     */
+    inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[];
+};
+/**
+ * Options accepted by `A_FrameIndex.listDefinitions()`.
+ */
+type A_FrameListOptions = {
+    /** Restrict to a single namespace */
+    namespace?: string | A_FrameNamespace;
+    /**
+     * Restrict to definitions whose origin class satisfies one or more
+     * inheritance rules.  Multiple entries use OR semantics.
+     */
+    inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[];
 };
 type A_FrameDefinition_SearchResult = {
     record: A_FrameDefinition;
@@ -43,12 +90,11 @@ declare class A_FrameIndex extends A_Fragment {
     private static _instance;
     static get instance(): A_FrameIndex;
     static get indexSize(): number;
+    static get scope(): A_Scope;
     static inherit(scope: A_Scope): void;
     static addDefinition(def: A_FrameDefinition): void;
     static getDefinition(nameOrHash: string): A_FrameDefinition | undefined;
-    static listDefinitions(filter: {
-        namespace?: string | A_FrameNamespace;
-    }): A_FrameDefinition[];
+    static listDefinitions(filter: A_FrameListOptions): A_FrameDefinition[];
     static removeDefinition(def: A_FrameDefinition): void;
     static addNamespace(namespace: A_FrameNamespace): void;
     static getDefaultNamespace(): A_FrameNamespace;
@@ -69,9 +115,7 @@ declare class A_FrameIndex extends A_Fragment {
     inherit(scope: A_Scope): void;
     addDefinition(def: A_FrameDefinition): void;
     getDefinition(name: string): A_FrameDefinition | undefined;
-    listDefinitions(filter?: {
-        namespace?: string | A_FrameNamespace;
-    }): A_FrameDefinition[];
+    listDefinitions(filter?: A_FrameListOptions): A_FrameDefinition[];
     removeDefinition(def: A_FrameDefinition): void;
     addNamespace(namespace: A_FrameNamespace): void;
     getNamespace(nameOrASEID: string | ASEID): A_FrameNamespace | undefined;
@@ -82,6 +126,23 @@ declare class A_FrameIndex extends A_Fragment {
      * Search by a pre-computed embedding vector (cosine similarity).
      */
     search(vector: A_FrameVector, options?: A_FrameSearchOptions): A_FrameDefinition_SearchResult[];
+    /**
+     * Test whether a definition's resolved constructor satisfies at least one
+     * of the provided inheritance filters (OR semantics).
+     *
+     * The constructor is resolved from the internal scope by the definition's
+     * name using `scope.resolveConstructor(name)` — the same mechanism the
+     * framework uses everywhere for class lookup.
+     *
+     * - `strict: false` (default) — any depth, using A_Context's O(1) indexed
+     *   inheritance map: `A_Context.isIndexedInheritedFrom(ctor, targetClass)`
+     * - `strict: true`            — direct child only:
+     *   `Object.getPrototypeOf(ctor) === targetClass`
+     *
+     * Definitions whose name cannot be resolved from the scope (e.g. restored
+     * from storage without a live container) never match.
+     */
+    private matchesInheritanceFilters;
     cosineSimilarity(a: A_FrameVector, b?: A_FrameVector): number;
     euclideanDistance(a: A_FrameVector, b: A_FrameVector): number;
     nearest(query: A_FrameVector, vectors: readonly A_FrameVector[], limit?: number): A_FrameVector[];
@@ -92,4 +153,4 @@ declare class A_FrameIndex extends A_Fragment {
     private assertSameLength;
 }
 
-export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameMetaDefinition, type A_FrameSearchOptions };
+export { type A_FrameDefinition_SearchResult, A_FrameIndex, type A_FrameIndexMetaMethodMeta, type A_FrameIndexMetaType, type A_FrameIndexTarget, type A_FrameInheritanceFilter, type A_FrameListOptions, type A_FrameMetaDefinition, type A_FrameSearchOptions };