@adaas/a-frame 0.1.1 → 0.1.2

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-YQJFTBGV.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 };

package/dist/browser/segment.mjs

@@ -0,0 +1,2 @@
+export{a as A_FRAME_DEFAULT_SEGMENT_KEY,c as A_FrameSegment,b as A_FrameSegmentFeatures}from'./chunk-TQPC5MYM.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=segment.mjs.map
+//# sourceMappingURL=segment.mjs.map

package/dist/browser/segment.mjs.map

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

package/dist/browser/storage.d.mts

@@ -1,11 +1,13 @@
 import { A_Fragment, A_Error, A_Component, A_Scope } from '@adaas/a-concept';
-import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
-import { c as A_FrameDefinition_Serialized, A as A_FrameDefinition } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
-import { A as A_FrameEnv } from './index.browser-CZlhzfSP.mjs';
-import { a as A_FrameBrowserStorageBlobs, A as A_FrameContext } from './A-FrameBrowserStorageBlobs.context-OEQr85oq.mjs';
+import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import { b as A_FrameDefinition_Serialized } from './A-FrameDefinition.types-BT02yAhQ.mjs';
+import { A_FrameEnv } from './env.mjs';
+import { a as A_FrameBrowserStorageBlobs, A as A_FrameContext } from './A-FrameBrowserStorageBlobs.context-DjeEH8cn.mjs';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-yA0GsBoe.mjs';
 import './vector.mjs';
-import './A-FrameChannel.types-DWOEUs28.mjs';
-import './A-FrameBundle.types-DaaUvViw.mjs';
+import './A-FrameEnv.types-DnK-CYVk.mjs';
+import './A-FrameChannel.types-BXEKJK9t.mjs';
+import './A-FrameBundle.types-LzfgdMiQ.mjs';
 
 declare class A_FrameStorageOperation<_ParamsType = any, _ResultType = any> extends A_Fragment {
     protected _result?: _ResultType;
@@ -126,8 +128,12 @@ declare class A_FrameStorageCodec extends A_Fragment {
     A_FRAME_FILE_VERSION: number;
     A_FRAME_HEADER_SIZE: number;
     static get fileExtension(): string;
-    getFileName(namespace: string): string;
+    /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */
+    getDefinitionsFileName(namespaceId: string): string;
+    /** Returns the reserved namespaces index file name: `.namespaces.aframe` */
     getNamespaceFileName(): string;
+    /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */
+    static get definitionsFilePattern(): string;
     encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
     decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
     encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;

package/dist/browser/storage.mjs

@@ -1,2 +1,2 @@
-export{f as A_FrameBrowserStorageBlobs,h as A_FrameBrowserStorageProvider,e as A_FrameStorage,g as A_FrameStorageCodec,d as A_FrameStorageError,b as A_FrameStorageFeatures,c as A_FrameStorageOperation}from'./chunk-GOADBDTE.mjs';import'./chunk-YQJFTBGV.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-AYN7KUQT.mjs';import'./chunk-INS7RO3B.mjs';import'./chunk-ZVCTU2DN.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=storage.mjs.map
+export{f as A_FrameBrowserStorageBlobs,h as A_FrameBrowserStorageProvider,e as A_FrameStorage,g as A_FrameStorageCodec,d as A_FrameStorageError,b as A_FrameStorageFeatures,c as A_FrameStorageOperation}from'./chunk-EFC7OUNO.mjs';import'./chunk-RWQSCROK.mjs';import'./chunk-VSSANMPF.mjs';import'./chunk-INS7RO3B.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=storage.mjs.map
 //# sourceMappingURL=storage.mjs.map

package/dist/browser/vector.d.mts

@@ -4,10 +4,17 @@ declare class A_FrameVector extends A_Entity {
     static get concept(): string;
     readonly values: Float32Array;
     constructor(values: number[] | Float32Array);
+    get dimensions(): number;
     get length(): number;
+    isEqualTo(vector: A_FrameVector): boolean;
     magnitude(): number;
     normalize(): A_FrameVector;
     dot(other: A_FrameVector): number;
+    /**
+     * Returns the cosine similarity between this vector and `other` (range −1 to 1).
+     * Vectors with zero magnitude return 0.
+     */
+    cosineSimilarity(other: A_FrameVector): number;
     private assertSameLength;
     toArray(): number[];
 }

package/dist/browser/vector.mjs

@@ -1,2 +1,2 @@
-export{a as A_FrameVector}from'./chunk-VDVJWU5T.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=vector.mjs.map
+export{a as A_FrameVector}from'./chunk-46LRNZRG.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=vector.mjs.map
 //# sourceMappingURL=vector.mjs.map