@adaas/a-frame 0.0.23 → 0.1.2

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

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

package/dist/browser/dynamic-feature.mjs

@@ -1,2 +1,4 @@
-import'./chunk-DMGQW3AO.mjs';import {A_Entity}from'@adaas/a-concept';var e=class extends A_Entity{static get concept(){return "a-frame"}};export{e as A_FrameDynamicFeature};//# sourceMappingURL=dynamic-feature.mjs.map
+import {a as a$1}from'./chunk-ZEONOTRL.mjs';import {q,m,p,r,f,a as a$2,o}from'./chunk-XR7FVA5M.mjs';export{q as A_FrameDynamicFeature,o as A_FrameDynamicFeatureError,m as A_FrameDynamicFeatureFeatures,n as A_FrameDynamicFeatureOperation,p as A_FrameMethodMapIndex}from'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';import'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import {a as a$3}from'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import {a,b}from'./chunk-DMGQW3AO.mjs';import {A_Feature,A_Inject,A_Caller,A_Component,A_Scope,A_Context}from'@adaas/a-concept';var d=class extends A_Component{async mapFeature(o$1,n,u,F){let f$1=o$1.definition;if(!f$1)return;let w=(t,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchedMethod:null,matchScore:0};let r=u.search(new a$3(t.embedding),{topK:1})[0];if(r&&r.score>=e){let a=r.record.dependency.name,s=r.record.name;return {matchedClass:a,matchedMethod:s,matchScore:r.score}}return {matchedClass:null,matchedMethod:null,matchScore:r?.score??0}},l=(t,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchScore:0};let r=u.search(new a$3(t.embedding),{topK:1})[0];return r&&r.score>=e?{matchedClass:r.record.name,matchScore:r.score}:{matchedClass:null,matchScore:r?.score??0}},x=t=>{let e=c=>{let{embedding:r,...a}=c;return a};return {...t,steps:t.steps.map(e),components:t.components.map(e),fragments:t.fragments.map(e),entities:t.entities.map(e)}},y=t=>{n.clear();for(let e of t.steps)n.setStep({prompt:e.prompt,inputs:e.inputs,outputs:e.outputs,...w(e,o$1.minScore)});for(let e of t.components)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});for(let e of t.fragments)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});for(let e of t.entities)n.setElement({prompt:e.prompt,...l(e,o$1.minScore)});},m=f$1;y(m);for(let t=0;t<o$1.maxRetries;t++){let e=m.steps.filter(s=>s.embedding?.length&&n.getStep(s.prompt)?.matchedMethod===null);if(e.length===0)break;let c=["The following workflow steps could not be matched to any registered method.","Please re-describe each step with more specific, method-oriented language:",e.map(s=>`- "${s.prompt}"`).join(`
+`)].join(`
+`),r=new f("POST","/api/v1/feature/patch",{originalPrompt:o$1.prompt,definition:x(m),patchInstruction:c,model:o$1.modelName,context:o$1.contextHint}),a=new A_Scope({name:`A_FrameMethodMapper.mapFeature:retry${t}`,fragments:[r]}).inherit(A_Context.scope(F));if(await F.call(a$2.Request,a),a.destroy(),!r.response)break;m=r.response.definition,y(m);}for(let t of m.steps){let e=n.getStep(t.prompt);e&&e.matchedMethod===null&&t.embedding?.length&&n.setStep({...e,matchError:{title:o.MethodNotFound,description:`Unable to match "${t.prompt}" to any registered method after ${o$1.maxRetries} retries.`}});}o$1.hydrateFromMap(n.toResult(m));}};a([A_Feature.Extend({name:m.Map,scope:[q]}),b(0,A_Inject(A_Caller)),b(1,A_Inject(p)),b(2,A_Inject(a$1)),b(3,A_Inject(r))],d.prototype,"mapFeature",1);export{d as A_FrameMethodMapper};//# sourceMappingURL=dynamic-feature.mjs.map
 //# sourceMappingURL=dynamic-feature.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameDynamicFeature.entity.ts"],"names":["A_FrameDynamicFeature","A_Entity"],"mappings":"qEAKO,IAAMA,CAAAA,CAAN,cAAoCC,QAAuE,CAE9G,WAAW,OAAA,EAAkB,CACzB,OAAO,SACX,CAGJ","file":"dynamic-feature.mjs","sourcesContent":["import { A_Entity } from \"@adaas/a-concept\";\nimport { A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized } from \"./A-FrameDynamicFeature.types\";\n\n\n\nexport class A_FrameDynamicFeature extends A_Entity<A_FrameDynamicFeature_Init, A_FrameDynamicFeature_Serialized> {\n\n    static get concept(): string {\n        return 'a-frame';\n    }\n\n\n}"]}
+{"version":3,"sources":["../../src/lib/A-FrameDynamicFeature/A-FrameMethodMapper.component.ts"],"names":["A_FrameMethodMapper","A_Component","feature","mapIndex","frameIndex","channel","def","tryMatchStep","step","minScore","top","A_FrameVector","matchedClass","matchedMethod","tryMatchElement","el","stripEmbeddings","d","strip","embedding","rest","matchAll","workingDef","retry","unmatchedSteps","refinementInstruction","patchReq","A_FrameChannelRequest","patchScope","A_Scope","A_Context","A_FrameFeatures","entry","A_FrameDynamicFeatureError","__decorateClass","A_Feature","A_FrameDynamicFeatureFeatures","A_FrameDynamicFeature","__decorateParam","A_Inject","A_Caller","A_FrameMethodMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":"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","file":"dynamic-feature.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"]}

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

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

package/dist/browser/dynamic-structure.mjs

@@ -1,2 +1,2 @@
-import'./chunk-DMGQW3AO.mjs';import {A_Error,A_Entity,A_CommonHelper}from'@adaas/a-concept';var p={Load:"_A_FRAME_DYNAMIC_STRUCTURE_LOAD",Update:"_A_FRAME_DYNAMIC_STRUCTURE_UPDATE",Generate:"_A_FRAME_DYNAMIC_STRUCTURE_GENERATE"},_={Updated:"_A_FRAME_DYNAMIC_STRUCTURE_UPDATED"};var i=class extends A_Entity{constructor(){super(...arguments);this._version=0;}static get concept(){return "a-frame"}fromNew(e){this.createdAt=Date.now(),this._components=[],this._history=[],this._version=0,this.listeners=new Map,this.prompt=e.prompt,this.model=e.model,this.context=e.context??"generic",this.metaHint=e.metaHint??"",this.includeBases=(e.includeBases||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t)),this.excludeBases=(e.excludeBases||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t)),this.enabledComponents=(e.enabledComponents||[]).map(t=>typeof t=="string"?t:A_CommonHelper.getComponentName(t));}get components(){return this._components}get history(){return this._history}get version(){return this._version}async generate(){}async patch(e){this._version++;}revertTo(e){return this}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(e=>e.toJSON())}}subscribe(e,t){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(t);}unsubscribe(e,t){this.listeners.get(e)?.delete(t);}emit(e,t){this.listeners.get(e)?.forEach(a=>a(t));}};var n=class extends A_Error{};n.InvalidPatch="InvalidPatch",n.VersionMismatch="VersionMismatch",n.ComponentNotFound="ComponentNotFound",n.InvalidOperation="InvalidOperation",n.GenerationFailed="GenerationFailed";export{i as A_FrameDynamicStructure,n as A_FrameDynamicStructureError,_ as A_FrameDynamicStructureEvents,p as A_FrameDynamicStructureFeatures};//# sourceMappingURL=dynamic-structure.mjs.map
+import {a as a$1}from'./chunk-ZEONOTRL.mjs';import {l,h,k,r,f,a as a$3,j}from'./chunk-XR7FVA5M.mjs';export{k as A_FrameComponentMapIndex,l as A_FrameDynamicStructure,j as A_FrameDynamicStructureError,i as A_FrameDynamicStructureEvents,h as A_FrameDynamicStructureFeatures}from'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';export{a as A_FrameDynamicPatch}from'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import {a as a$2}from'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import {a,b}from'./chunk-DMGQW3AO.mjs';import {A_Feature,A_Inject,A_Caller,A_Component,A_Scope,A_Context,A_Container,A_Fragment,A_Entity}from'@adaas/a-concept';var C=class extends A_Component{async mapStructure(a,n,D,b){let R=a.definition;if(!R)return;let p=(t,r,e)=>{if(!t.embedding?.length)return {matchedClass:null,matchScore:0};let i=D.search(new a$2(t.embedding),{topK:1,inherit:e})[0];return i&&i.score>=r?{matchedClass:i.record.name,matchScore:i.score}:{matchedClass:null,matchScore:i?.score??0}},w=t=>[...t.containers,...t.containers.flatMap(r=>[...r.components??[],...r.fragments??[],...r.entities??[]]),...t.components,...t.fragments,...t.entities],T=(t,r)=>{if(r.containers.some(e=>e.prompt===t.prompt))return {class:A_Container};if(r.components.some(e=>e.prompt===t.prompt))return {class:A_Component};if(r.fragments.some(e=>e.prompt===t.prompt))return {class:A_Fragment};if(r.entities.some(e=>e.prompt===t.prompt))return {class:A_Entity};for(let e of r.containers){if((e.components??[]).some(o=>o.prompt===t.prompt))return {class:A_Component};if((e.fragments??[]).some(o=>o.prompt===t.prompt))return {class:A_Fragment};if((e.entities??[]).some(o=>o.prompt===t.prompt))return {class:A_Entity}}},V=(t,r,e,o,i)=>{let c=m=>{m.prompt===r&&(m.prompt=e,m.embedding=o,i!==void 0&&(m.role=i));};t.containers.forEach(c),t.containers.forEach(m=>{(m.components??[]).forEach(c),(m.fragments??[]).forEach(c),(m.entities??[]).forEach(c);}),t.components.forEach(c),t.fragments.forEach(c),t.entities.forEach(c);},z=t=>{n.clear();let r=a.minScore;for(let e of t.containers){n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Container})});for(let o of e.components??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Component})});for(let o of e.fragments??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Fragment})});for(let o of e.entities??[])n.set({prompt:o.prompt,role:o.role,class:o.class,...p(o,r,{class:A_Entity})});}for(let e of t.components)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Component})});for(let e of t.fragments)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Fragment})});for(let e of t.entities)n.set({prompt:e.prompt,role:e.role,class:e.class,...p(e,r,{class:A_Entity})});},l=R;z(l);for(let t=0;t<a.maxRetries;t++){let r=w(l).filter(s=>s.embedding?.length&&n.get(s.prompt)?.matchedClass===null);if(r.length===0)break;let e=a.candidateCount,o=r.map(s=>{n.get(s.prompt);let g=D.search(new a$2(s.embedding),{topK:e});return {prompt:s.prompt,role:s.role,candidates:g.map(u=>({name:u.record.name,description:u.record.description}))}}),i=new f("POST","/api/v1/structure/select",{originalPrompt:a.prompt,elements:o,model:a.modelName}),c=new A_Scope({name:`A_FrameComponentMapper.mapStructure:select${t}`,fragments:[i]}).inherit(A_Context.scope(b));if(await b.call(a$3.Request,c),c.destroy(),!i.response)break;let m=false;for(let s of i.response.resolutions){let f=n.get(s.elementPrompt);if(f){if(s.type==="select"&&s.selectedClass)n.set({...f,matchedClass:s.selectedClass,matchScore:1}),m=true;else if(s.type==="suggest"&&s.suggestion){let{prompt:g,role:u,embedding:E}=s.suggestion;if(E?.length){let P=r.find(G=>G.prompt===s.elementPrompt),B=P?T(P,l):void 0,_=D.search(new a$2(E),{topK:1,inherit:B})[0];_&&_.score>=a.minScore?(n.set({...f,matchedClass:_.record.name,matchScore:_.score}),m=true):(n.set({...f,prompt:g,role:u}),V(l,s.elementPrompt,g,E,u),m=true);}else n.set({...f,prompt:g,role:u}),m=true;}}}if(!m)break}for(let t of w(l)){let r=n.get(t.prompt);r&&r.matchedClass===null&&t.embedding?.length&&n.set({...r,matchError:{title:j.ComponentNotFound,description:`Unable to match "${t.prompt}" to any registered implementation after ${a.maxRetries} retries.`}});}a.hydrateFromMap(n.toResult(l));}};a([A_Feature.Extend({name:h.Map,scope:[l]}),b(0,A_Inject(A_Caller)),b(1,A_Inject(k)),b(2,A_Inject(a$1)),b(3,A_Inject(r))],C.prototype,"mapStructure",1);export{C as A_FrameComponentMapper};//# sourceMappingURL=dynamic-structure.mjs.map
 //# sourceMappingURL=dynamic-structure.mjs.map

package/dist/browser/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":["A_FrameDynamicStructureFeatures","A_FrameDynamicStructureEvents","A_FrameDynamicStructure","A_Entity","options","b","A_CommonHelper","prompt","version","item","feature","listener","stage","context","A_FrameDynamicStructureError","A_Error"],"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":["../../src/lib/A-FrameDynamicStructure/A-FrameComponentMapper.component.ts"],"names":["A_FrameComponentMapper","A_Component","structure","mapIndex","frameIndex","channel","def","tryMatch","el","minScore","inherit","top","A_FrameVector","allElements","d","c","inferInherit","A_Container","A_Fragment","A_Entity","ct","updateElementEmbedding","oldPrompt","newPrompt","newEmbedding","newRole","update","matchAll","score","workingDef","retry","unmatchedEls","k","selectElements","candidateResults","r","selectReq","A_FrameChannelRequest","selectScope","A_Scope","A_Context","A_FrameFeatures","anyUpdate","resolution","existing","e","entry","A_FrameDynamicStructureError","__decorateClass","A_Feature","A_FrameDynamicStructureFeatures","A_FrameDynamicStructure","__decorateParam","A_Inject","A_Caller","A_FrameComponentMapIndex","A_FrameIndex","A_FrameChannel"],"mappings":"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","file":"dynamic-structure.mjs","sourcesContent":["import { A_Caller, A_Component, A_Container, A_Context, A_Entity, A_Feature, A_Fragment, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_FrameChannel } from \"../A-FrameChannel/A-FrameChannel.component\";\nimport { A_FrameFeatures } from \"../A-FrameChannel/A-FrameChannel.constants\";\nimport { A_FrameChannelRequest } from \"../A-FrameChannel/A-FrameChannelRequest.context\";\nimport { A_FrameIndex } from \"../A-FrameIndex/A-FrameIndex.context\";\nimport { A_FrameInheritanceFilter } from \"../A-FrameIndex/A-FrameIndex.types\";\nimport { A_FrameVector } from \"../A-FrameVector/A-FrameVector.entity\";\nimport { A_FrameDynamicStructure } from \"./A-FrameDynamicStructure.entity\";\nimport { A_FrameDynamicStructureFeatures } from \"./A-FrameDynamicStructure.constants\";\nimport { A_FrameDynamicStructureError } from \"./A-FrameDynamicStructure.error\";\nimport {\n    A_FrameComponentMapEntry,\n    A_FrameDynamicStructureDefinition,\n    A_FrameDynamicStructureDefinitionEntity,\n    A_FrameStructureSelectRequest,\n    A_FrameStructureSelectResolution,\n    A_FrameStructureSelectResponse,\n} from \"./A-FrameDynamicStructure.types\";\nimport { A_FrameComponentMapIndex } from \"./A-FrameComponentMapIndex.context\";\n\n\n/**\n * Stateless component that implements the `Map` feature for\n * `A_FrameDynamicStructure`.\n *\n * Receives all necessary context via `@A_Inject` — it stores no state of its\n * own.  Injects the calling structure (via `A_Caller`), the local definition\n * index (`A_FrameIndex`), the map-result accumulator (`A_FrameComponentMapIndex`),\n * and the HTTP channel (`A_FrameChannel`) needed for refinement retry calls.\n *\n * Algorithm:\n *  1. Read `structure.definition` (raw, with server embeddings).\n *  2. For every element run cosine-similarity search against `A_FrameIndex`.\n *  3. For remaining unmatched elements (up to `structure.maxRetries`): ask the\n *     server to refine their descriptions, then re-match the new definition.\n *  4. Mark still-unmatched elements with a `matchError`.\n *  5. Call `structure.hydrateFromMap(mapIndex.toResult(workingDef))`.\n */\nexport class A_FrameComponentMapper extends A_Component {\n\n    @A_Feature.Extend({\n        name: A_FrameDynamicStructureFeatures.Map,\n        scope: [A_FrameDynamicStructure],\n    })\n    async mapStructure(\n        @A_Inject(A_Caller) structure: A_FrameDynamicStructure,\n        @A_Inject(A_FrameComponentMapIndex) mapIndex: A_FrameComponentMapIndex,\n        @A_Inject(A_FrameIndex) frameIndex: A_FrameIndex,\n        @A_Inject(A_FrameChannel) channel: A_FrameChannel,\n    ): Promise<void> {\n\n        const def = structure.definition;\n        if (!def) return;\n\n        // ── helpers ──────────────────────────────────────────────────────────\n\n        const tryMatch = (\n            el: A_FrameDynamicStructureDefinitionEntity,\n            minScore: number,\n            inherit?: A_FrameInheritanceFilter | A_FrameInheritanceFilter[],\n        ): Pick<A_FrameComponentMapEntry, 'matchedClass' | 'matchScore'> => {\n            if (!el.embedding?.length) {\n                return { matchedClass: null, matchScore: 0 };\n            }\n            const results = frameIndex.search(new A_FrameVector(el.embedding), { topK: 1, inherit });\n            const top = results[0];\n            if (top && top.score >= minScore) {\n                return { matchedClass: top.record.name, matchScore: top.score };\n            }\n            return { matchedClass: null, matchScore: top?.score ?? 0 };\n        };\n\n        const allElements = (d: A_FrameDynamicStructureDefinition): A_FrameDynamicStructureDefinitionEntity[] => [\n            ...d.containers,\n            ...d.containers.flatMap(c => [\n                ...(c.components ?? []),\n                ...(c.fragments  ?? []),\n                ...(c.entities   ?? []),\n            ]),\n            ...d.components,\n            ...d.fragments,\n            ...d.entities,\n        ];\n\n        const stripEmbeddings = (d: A_FrameDynamicStructureDefinition): A_FrameDynamicStructureDefinition => {\n            const strip = (el: A_FrameDynamicStructureDefinitionEntity): A_FrameDynamicStructureDefinitionEntity => {\n                const { embedding, ...rest } = el as any;\n                return rest as A_FrameDynamicStructureDefinitionEntity;\n            };\n            return {\n                containers: d.containers.map(c => ({\n                    ...strip(c),\n                    components: (c.components ?? []).map(strip),\n                    fragments:  (c.fragments  ?? []).map(strip),\n                    entities:   (c.entities   ?? []).map(strip),\n                })),\n                components: d.components.map(strip),\n                fragments:  d.fragments.map(strip),\n                entities:   d.entities.map(strip),\n            };\n        };\n\n        /**\n         * Infer the appropriate inheritance filter for an element by checking which\n         * slot it occupies inside the definition (container / component / fragment / entity).\n         */\n        const inferInherit = (\n            el: A_FrameDynamicStructureDefinitionEntity,\n            d: A_FrameDynamicStructureDefinition,\n        ): A_FrameInheritanceFilter | undefined => {\n            if (d.containers.some(c => c.prompt === el.prompt)) return { class: A_Container };\n            if (d.components.some(c => c.prompt === el.prompt)) return { class: A_Component };\n            if (d.fragments.some(c => c.prompt === el.prompt))  return { class: A_Fragment };\n            if (d.entities.some(c => c.prompt === el.prompt))   return { class: A_Entity };\n            for (const ct of d.containers) {\n                if ((ct.components ?? []).some(c => c.prompt === el.prompt)) return { class: A_Component };\n                if ((ct.fragments  ?? []).some(c => c.prompt === el.prompt)) return { class: A_Fragment };\n                if ((ct.entities   ?? []).some(c => c.prompt === el.prompt)) return { class: A_Entity };\n            }\n            return undefined;\n        };\n\n        /**\n         * Mutate workingDef in-place: update the element identified by `oldPrompt`\n         * with a new prompt, role, and embedding from a server suggestion.\n         * This lets the next iteration's `allElements()` find the updated embedding.\n         */\n        const updateElementEmbedding = (\n            d: A_FrameDynamicStructureDefinition,\n            oldPrompt: string,\n            newPrompt: string,\n            newEmbedding: number[],\n            newRole?: string,\n        ): void => {\n            const update = (el: A_FrameDynamicStructureDefinitionEntity & { role?: string }): void => {\n                if (el.prompt === oldPrompt) {\n                    el.prompt = newPrompt;\n                    el.embedding = newEmbedding;\n                    if (newRole !== undefined) el.role = newRole;\n                }\n            };\n            d.containers.forEach(update);\n            d.containers.forEach(ct => {\n                (ct.components ?? []).forEach(update);\n                (ct.fragments  ?? []).forEach(update);\n                (ct.entities   ?? []).forEach(update);\n            });\n            d.components.forEach(update);\n            d.fragments.forEach(update);\n            d.entities.forEach(update);\n        };\n\n        /**\n         * Match all elements in the definition, restricting each group's candidate\n         * pool to the appropriate base class via inheritance filters:\n         *   containers → A_Container\n         *   components → A_Component\n         *   fragments  → A_Fragment\n         *   entities   → A_Entity\n         */\n        const matchAll = (d: A_FrameDynamicStructureDefinition): void => {\n            mapIndex.clear();\n            const score = structure.minScore;\n\n            // Top-level containers\n            for (const ct of d.containers) {\n                mapIndex.set({\n                    prompt: ct.prompt,\n                    role:   ct.role,\n                    class:  ct.class,\n                    ...tryMatch(ct, score, { class: A_Container }),\n                });\n                // Nested: components, fragments, entities within each container\n                for (const el of (ct.components ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });\n                for (const el of (ct.fragments ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });\n                for (const el of (ct.entities ?? []))\n                    mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Entity }) });\n            }\n\n            // Top-level cross-cutting elements\n            for (const el of d.components)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Component }) });\n            for (const el of d.fragments)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Fragment }) });\n            for (const el of d.entities)\n                mapIndex.set({ prompt: el.prompt, role: el.role, class: el.class, ...tryMatch(el, score, { class: A_Entity }) });\n        };\n\n        // ── initial matching pass ─────────────────────────────────────────────\n\n        const workingDef = def;\n        matchAll(workingDef);\n\n        // ── select / suggest retry loop ───────────────────────────────────────\n        //\n        // For each retry: collect unmatched elements, pull `candidateCount` top\n        // candidates per element from the local index (no minScore filter so we\n        // always have *something* to show the AI), then call /api/v1/structure/select.\n        //\n        // The server returns one resolution per element:\n        //   select  → directly set matchedClass (no re-embed needed)\n        //   suggest → the response includes a fresh embedding; re-run tryMatch\n        //   none    → skip the element (will become a matchError below)\n\n        for (let retry = 0; retry < structure.maxRetries; retry++) {\n            const unmatchedEls = allElements(workingDef).filter(\n                el => el.embedding?.length && mapIndex.get(el.prompt)?.matchedClass === null,\n            );\n            if (unmatchedEls.length === 0) break;\n\n            // Build select payload — top-K candidates per element, no minScore.\n            const k = structure.candidateCount;\n            const selectElements = unmatchedEls.map(el => {\n                // Determine appropriate inheritance filter for this element's role.\n                // We look up the existing map entry to know which slot it lives in.\n                const entry = mapIndex.get(el.prompt);\n                // Use unconstrained search to get candidates (already tried constrained above).\n                const candidateResults = frameIndex.search(\n                    new A_FrameVector(el.embedding!),\n                    { topK: k },\n                );\n                return {\n                    prompt:     el.prompt,\n                    role:       el.role,\n                    candidates: candidateResults.map(r => ({\n                        name:        r.record.name,\n                        description: r.record.description,\n                    })),\n                };\n            });\n\n            // Call /api/v1/structure/select\n            const selectReq = new A_FrameChannelRequest<A_FrameStructureSelectResponse>(\n                'POST',\n                '/api/v1/structure/select',\n                {\n                    originalPrompt: structure.prompt,\n                    elements:       selectElements,\n                    model:          structure.modelName,\n                } satisfies A_FrameStructureSelectRequest,\n            );\n\n            const selectScope = new A_Scope({\n                name: `A_FrameComponentMapper.mapStructure:select${retry}`,\n                fragments: [selectReq],\n            }).inherit(A_Context.scope(channel));\n\n            await channel.call(A_FrameFeatures.Request, selectScope);\n            selectScope.destroy();\n\n            if (!selectReq.response) break;\n\n            // Apply resolutions\n            let anyUpdate = false;\n            for (const resolution of selectReq.response.resolutions) {\n                const existing = mapIndex.get(resolution.elementPrompt);\n                if (!existing) continue;\n\n                if (resolution.type === 'select' && resolution.selectedClass) {\n                    // Direct selection — no re-embed required.\n                    mapIndex.set({ ...existing, matchedClass: resolution.selectedClass, matchScore: 1 });\n                    anyUpdate = true;\n\n                } else if (resolution.type === 'suggest' && resolution.suggestion) {\n                    // Server suggested a re-description, optionally with a fresh embedding.\n                    const { prompt: newPrompt, role: newRole, embedding: newEmbedding } = resolution.suggestion;\n\n                    if (newEmbedding?.length) {\n                        // Re-search locally with the new embedding.\n                        const el = unmatchedEls.find(e => e.prompt === resolution.elementPrompt);\n                        const inherit = el ? inferInherit(el, workingDef) : undefined;\n                        const results = frameIndex.search(\n                            new A_FrameVector(newEmbedding),\n                            { topK: 1, inherit },\n                        );\n                        const top = results[0];\n                        if (top && top.score >= structure.minScore) {\n                            mapIndex.set({ ...existing, matchedClass: top.record.name, matchScore: top.score });\n                            anyUpdate = true;\n                        } else {\n                            // Still unmatched, but update the prompt so next retry uses the new description.\n                            mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });\n                            // Also update the working element so allElements() finds the new embedding.\n                            updateElementEmbedding(workingDef, resolution.elementPrompt, newPrompt, newEmbedding, newRole);\n                            anyUpdate = true;\n                        }\n                    } else {\n                        // No embedding returned — just update description for next round.\n                        mapIndex.set({ ...existing, prompt: newPrompt, role: newRole });\n                        anyUpdate = true;\n                    }\n                }\n                // type === 'none': leave as-is, will become matchError below.\n            }\n\n            if (!anyUpdate) break;\n        }\n\n        // ── finalize: mark remaining unmatched with an error ──────────────────\n\n        for (const el of allElements(workingDef)) {\n            const entry = mapIndex.get(el.prompt);\n            if (entry && entry.matchedClass === null && el.embedding?.length) {\n                mapIndex.set({\n                    ...entry,\n                    matchError: {\n                        title: A_FrameDynamicStructureError.ComponentNotFound,\n                        description: `Unable to match \"${el.prompt}\" to any registered implementation after ${structure.maxRetries} retries.`,\n                    },\n                });\n            }\n        }\n\n        // ── hydrate the structure with the map result ─────────────────────────\n\n        structure.hydrateFromMap(mapIndex.toResult(workingDef));\n    }\n}\n"]}

package/dist/browser/env.d.mts

@@ -1,2 +1,16 @@
-export { A as A_FrameEnv } from './index.browser-CZlhzfSP.mjs';
-import '@adaas/a-concept';
+import { A_Fragment } from '@adaas/a-concept';
+import { I as IA_FrameEnv } from './A-FrameEnv.types-DnK-CYVk.mjs';
+
+/**
+ * This class tailored from browser environment and it is used to get the env variables from the global scope and make them available for the A_FrameTask to use them in the task execution.
+ */
+declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
+    get A_FRAME_TOKEN(): any;
+    get A_FRAME_SERVER_URL(): any;
+    get A_FRAME_VERSION(): string;
+    get A_FRAME_SERVER_API_KEY(): any;
+    get A_FRAME_STORAGE_DIR(): any;
+    get A_FRAME_STORAGE_PATTERN(): string;
+}
+
+export { A_FrameEnv };

package/dist/browser/env.mjs

@@ -1,2 +1,2 @@
-export{b as A_FrameEnv}from'./chunk-OFKV5GNB.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=env.mjs.map
+export{a as A_FrameEnv}from'./chunk-RWQSCROK.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=env.mjs.map
 //# sourceMappingURL=env.mjs.map

package/dist/browser/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/browser/frame-index.mjs

@@ -1,2 +1,2 @@
-export{a as A_FrameIndex}from'./chunk-G66IL2DR.mjs';import'./chunk-AYN7KUQT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=frame-index.mjs.map
+import'./chunk-NTOIVRX3.mjs';export{a as A_FrameIndex}from'./chunk-ZEONOTRL.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=frame-index.mjs.map
 //# sourceMappingURL=frame-index.mjs.map

package/dist/browser/models.d.mts

@@ -0,0 +1,64 @@
+/**
+ * Adaas named model identifiers — client-side mirror of the server catalog.
+ *
+ * These are the stable logical identifiers for each model role. Pass them
+ * wherever an entity or channel method accepts a `model` option to target a
+ * specific named model on the server.
+ *
+ * The server resolves these IDs to physical backend models (e.g. Ollama,
+ * OpenAI) and applies any required task prefixes automatically. Swapping to a
+ * dedicated fine-tuned model in the future requires no changes on the client.
+ *
+ * @see adaas-a-frame-mcp/README.models.md
+ */
+declare const A_FRAME_MODELS: {
+    /**
+     * Antares — component definition embedding model.
+     *
+     * Indexes component sources and namespace definitions with the
+     * `search_document:` prefix.  The reference system everything navigates
+     * against.  Use when storing content that will be retrieved later.
+     */
+    readonly ANTARES: "adaas-antares-v1";
+    /**
+     * Vega — search query embedding model.
+     *
+     * Produces `search_query:` prefixed vectors for retrieval against the
+     * Antares index.  Use when embedding a user query or search term.
+     */
+    readonly VEGA: "adaas-vega-v1";
+    /**
+     * Rigel — code completion model.
+     *
+     * Generates TypeScript/JavaScript code with syntax precision.
+     * Default model for `A_FrameCompletion` — use for code generation,
+     * scaffolding, and structured source output.
+     */
+    readonly RIGEL: "adaas-rigel-v1";
+    /**
+     * Pulsar — software architecture completion model.
+     *
+     * Decomposes requirements into structured component designs.
+     * Use for architecture analysis, DSG structure generation, and
+     * patch planning.
+     */
+    readonly PULSAR: "adaas-pulsar-v1";
+    /**
+     * Lyra — bridge/classifier model.
+     *
+     * Translates content semantics into structured text.
+     * Default model for `A_FrameDynamicContent` — use for content
+     * generation and patching.
+     */
+    readonly LYRA: "adaas-lyra-v1";
+    /**
+     * Nova — param extraction model.
+     *
+     * Illuminates structured JSON parameters hidden inside unstructured text.
+     * Outputs constrained JSON by default.
+     */
+    readonly NOVA: "adaas-nova-v1";
+};
+type A_FrameModelId = typeof A_FRAME_MODELS[keyof typeof A_FRAME_MODELS];
+
+export { A_FRAME_MODELS, type A_FrameModelId };

package/dist/browser/models.mjs

@@ -0,0 +1,2 @@
+import'./chunk-WXCQCHAX.mjs';export{a as A_FRAME_MODELS}from'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=models.mjs.map
+//# sourceMappingURL=models.mjs.map

package/dist/browser/models.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"models.mjs"}

package/dist/browser/namespace.d.mts

@@ -1,4 +1,4 @@
-export { A as A_FrameNamespace, a as A_FrameNamespace_EmbeddingMeta, b as A_FrameNamespace_Init, c as A_FrameNamespace_Record, d as A_FrameNamespace_SearchResult, e as A_FrameNamespace_Serialized } from './A-FrameNamespace.entity-rCm1AavP.mjs';
+export { A as A_FrameNamespace, a as A_FrameNamespace_EmbeddingMeta, b as A_FrameNamespace_Init, c as A_FrameNamespace_Record, d as A_FrameNamespace_SearchResult, e as A_FrameNamespace_Serialized } from './A-FrameNamespace.entity-BDg1FUgo.mjs';
 import '@adaas/a-concept';
 import './vector.mjs';
 

package/dist/browser/namespace.mjs

@@ -1,2 +1,2 @@
-import'./chunk-K4MZY4ME.mjs';export{a as A_FRAME_DEFAULT_NAMESPACE_KEY,c as A_FrameNamespace,b as A_FrameNamespaceFeatures}from'./chunk-AYN7KUQT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=namespace.mjs.map
+import'./chunk-K4MZY4ME.mjs';export{a as A_FRAME_DEFAULT_NAMESPACE_KEY,c as A_FrameNamespace,b as A_FrameNamespaceFeatures}from'./chunk-CT67Y46H.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=namespace.mjs.map
 //# sourceMappingURL=namespace.mjs.map

package/dist/browser/schema.d.mts

@@ -0,0 +1,10 @@
+export { A as A_FrameSchema, a as A_FrameSchemaOptions, b as A_FrameSchema_ExtractionMeta, c as A_FrameSchema_Init, d as A_FrameSchema_Serialized } from './A-FrameSchema.entity-DjYIhsoj.mjs';
+export { A_FRAME_MODELS } from './models.mjs';
+import '@adaas/a-concept';
+
+declare const A_FrameSchemaFeatures: {
+    /** POST /api/v1/schema/extract — extract structured data from a prompt */
+    readonly Extract: "_A_FRAME_SCHEMA_EXTRACT";
+};
+
+export { A_FrameSchemaFeatures };

package/dist/browser/schema.mjs

@@ -0,0 +1,2 @@
+export{b as A_FrameSchema,a as A_FrameSchemaFeatures}from'./chunk-2RNFZSBL.mjs';export{a as A_FRAME_MODELS}from'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=schema.mjs.map
+//# sourceMappingURL=schema.mjs.map

package/dist/browser/schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"schema.mjs"}

package/dist/browser/segment.d.mts

@@ -0,0 +1,13 @@
+export { A as A_FrameSegment, a as A_FrameSegmentOptions, b as A_FrameSegment_EmbeddingMeta, c as A_FrameSegment_Init, d as A_FrameSegment_Record, e as A_FrameSegment_SearchResult, f as A_FrameSegment_Serialized } from './A-FrameSegment.entity-D1xjjWvG.mjs';
+import '@adaas/a-concept';
+import './vector.mjs';
+
+declare const A_FRAME_DEFAULT_SEGMENT_KEY = "default";
+declare const A_FrameSegmentFeatures: {
+    readonly Load: "_A_FRAME_SEGMENT_LOAD";
+    readonly Save: "_A_FRAME_SEGMENT_SAVE";
+    readonly Embed: "_A_FRAME_SEGMENT_EMBED";
+    readonly Destroy: "_A_FRAME_SEGMENT_DESTROY";
+};
+
+export { A_FRAME_DEFAULT_SEGMENT_KEY, A_FrameSegmentFeatures };