@adaas/a-frame 0.0.23 → 0.1.2

package/dist/node/bundle.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts","../../src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts"],"names":[],"mappings":"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","file":"bundle.mjs","sourcesContent":["/** Current bundle format revision. Bumped on incompatible structural changes. */\nexport const A_FRAME_BUNDLE_VERSION = 1;\n\n/** Default file name when none is provided to the CLI. */\nexport const A_FRAME_BUNDLE_DEFAULT_FILENAME = 'a-frame-bundle.json';\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { A_Component } from '@adaas/a-concept';\nimport { A_FrameBundle } from './A-FrameBundle.types';\nimport { A_FRAME_BUNDLE_VERSION } from './A-FrameBundle.constants';\nimport { A_FrameStorageCodec } from '../A-FrameStorage/A-FrameStorage.codec';\nimport * as pkg from '../../../package.json';\n\n\nexport interface A_FrameBundleBuilderOptions {\n    /** Source directory containing the encrypted `*.aframe` files (Node storage). */\n    storageDir: string;\n    /** Server version to embed in the bundle metadata. */\n    serverVersion: string;\n}\n\n\n/**\n * A_FrameBundleBuilder — Node-only build-time helper.\n *\n * Reads the encrypted `*.aframe` files produced by Node storage and packages\n * them into a single JSON (or generated TypeScript module) artifact that ships\n * with the browser bundle. The browser bootstrap then seeds these blobs into\n * `A_FrameBrowserStorageBlobs` so that read-only `definition.load()` /\n * `namespace.load()` calls work without a filesystem.\n */\nexport class A_FrameBundleBuilder extends A_Component {\n\n    /** Read all `.aframe` files from a storage directory and serialise them. */\n    async build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle> {\n        const ext = A_FrameStorageCodec.fileExtension; // \".aframe\"\n        const namespacesFile = `__namespaces${ext}`;\n\n        let entries: string[];\n        try {\n            entries = await fs.readdir(opts.storageDir);\n        } catch (err: any) {\n            if (err?.code === 'ENOENT') {\n                throw new Error(`A-Frame storage directory not found: ${opts.storageDir}`);\n            }\n            throw err;\n        }\n\n        const aframeFiles = entries.filter(f => f.endsWith(ext));\n\n        let namespaces: string | null = null;\n        const definitions: Record<string, string> = {};\n\n        for (const file of aframeFiles) {\n            const buf = await fs.readFile(path.join(opts.storageDir, file));\n            const b64 = buf.toString('base64');\n\n            if (file === namespacesFile) {\n                namespaces = b64;\n            } else {\n                const id = file.slice(0, -ext.length);\n                definitions[id] = b64;\n            }\n        }\n\n        return {\n            bundleVersion: A_FRAME_BUNDLE_VERSION,\n            aFrameVersion: (pkg as any).version || '0.0.0',\n            serverVersion: opts.serverVersion,\n            builtAt: new Date().toISOString(),\n            namespaces,\n            definitions,\n        };\n    }\n\n    /** Write the bundle to disk as a JSON file. */\n    async writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, JSON.stringify(bundle, null, 2));\n    }\n\n    /**\n     * Emit a TypeScript module that exports the bundle as a typed constant.\n     * Useful for bundlers that prefer TS imports over JSON imports.\n     */\n    async writeTS(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        const banner = '// AUTO-GENERATED by @adaas/a-frame — do not edit.\\n';\n        const body =\n            `import type { A_FrameBundle } from '@adaas/a-frame';\\n\\n` +\n            `export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;\\n`;\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, banner + body);\n    }\n\n    /** Convenience: detect output format by extension and write. */\n    async writeAuto(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        if (/\\.tsx?$/.test(outFile)) return this.writeTS(bundle, outFile);\n        return this.writeJSON(bundle, outFile);\n    }\n}\n"]}
+{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts","../../src/lib/A-FrameBundle/A-FrameBundle.builder.env-node.ts"],"names":[],"mappings":"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","file":"bundle.mjs","sourcesContent":["/** Current bundle format revision. Bumped on incompatible structural changes. */\nexport const A_FRAME_BUNDLE_VERSION = 2;\n\n/** Default file name when none is provided to the CLI. */\nexport const A_FRAME_BUNDLE_DEFAULT_FILENAME = 'a-frame-bundle.json';\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport { A_Component } from '@adaas/a-concept';\nimport { A_FrameBundle, A_FrameBundleDefinitionRecord, A_FrameBundleNamespaceRecord } from './A-FrameBundle.types';\nimport { A_FRAME_BUNDLE_VERSION } from './A-FrameBundle.constants';\nimport { A_FrameStorageCodec } from '../A-FrameStorage/A-FrameStorage.codec';\nimport { A_FrameCrypto } from '../A-FrameCrypto/A-FrameCrypto.component.env-node';\nimport * as pkg from '../../../package.json';\n\n\nexport interface A_FrameBundleBuilderOptions {\n    /**\n     * Source directory containing the encrypted `*.aframe` files (Node storage).\n     * Defaults to `.aframe/` in the current working directory.\n     */\n    storageDir?: string;\n    /** Server version to embed in the bundle metadata. */\n    serverVersion: string;\n    /**\n     * AES-256-GCM encryption key used when the `.aframe` files were written.\n     * This is the `encryptionKey` returned by the A-Frame server credentials API.\n     * Required so the builder can decrypt the files and produce plain-JSON records.\n     */\n    encryptionKey: string;\n}\n\n\n/**\n * A_FrameBundleBuilder — Node-only build-time helper.\n *\n * Reads the encrypted `*.aframe` files produced by Node storage, decrypts them\n * with the provided key, and packages the decoded definition/namespace records\n * into a single JSON artifact that ships with the browser bundle.\n *\n * The output bundle stores plain records (no encryption). The browser bootstrap\n * seeds these directly into `A_FrameBrowserStorageBlobs` so that definitions\n * load without any server connection or encryption key.\n *\n * Usage:\n * ```ts\n * import { A_FrameBundleBuilder } from '@adaas/a-frame/bundle';\n *\n * const builder = new A_FrameBundleBuilder();\n * const bundle = await builder.build({\n *   storageDir: '.aframe',\n *   serverVersion: '1.0.0',\n *   encryptionKey: process.env.A_FRAME_ENCRYPTION_KEY!,\n * });\n * await builder.writeAuto(bundle, 'src/generated/a-frame-bundle.ts');\n * ```\n */\nexport class A_FrameBundleBuilder extends A_Component {\n\n    private codec = new A_FrameStorageCodec();\n\n    /** Read, decrypt and decode all `.aframe` files from a storage directory. */\n    async build(opts: A_FrameBundleBuilderOptions): Promise<A_FrameBundle> {\n        const storageDir = opts.storageDir ?? '.aframe';\n        const namespacesFile = this.codec.getNamespaceFileName();   // '.namespaces.aframe'\n        const defSuffix = `.definitions${A_FrameStorageCodec.fileExtension}`; // '.definitions.aframe'\n\n        let entries: string[];\n        try {\n            entries = await fs.readdir(storageDir);\n        } catch (err: any) {\n            if (err?.code === 'ENOENT') {\n                throw new Error(`A-Frame storage directory not found: ${path.resolve(storageDir)}`);\n            }\n            throw err;\n        }\n\n        // Accept both the namespace index and definition files\n        const aframeFiles = entries.filter(f => f === namespacesFile || f.endsWith(defSuffix));\n\n        const records: Record<string, A_FrameBundleDefinitionRecord[]> = {};\n        const namespaceRecords: A_FrameBundleNamespaceRecord[] = [];\n\n        for (const file of aframeFiles) {\n            const raw = await fs.readFile(path.join(storageDir, file));\n            let plain: Uint8Array;\n            try {\n                plain = await A_FrameCrypto.decryptBytes(new Uint8Array(raw), opts.encryptionKey);\n            } catch {\n                throw new Error(\n                    `Failed to decrypt \"${file}\". Ensure encryptionKey matches the key used when the files were written.`\n                );\n            }\n\n            if (file === namespacesFile) {\n                const decoded = this.codec.decodeNamespacePayload(plain);\n                for (const r of decoded) {\n                    namespaceRecords.push({\n                        aseid: r.aseid,\n                        hash: r.hash,\n                        name: r.name,\n                        description: r.description,\n                        metadata: r.metadata,\n                        embedding: Array.from(r.embedding ?? []),\n                        embeddedAt: r.embeddedAt,\n                        embeddingModel: r.embeddingModel,\n                        credentialId: r.credentialId,\n                        aFrameVersion: r.aFrameVersion,\n                        aFrameServerVersion: r.aFrameServerVersion,\n                    });\n                }\n            } else {\n                // Strip '.definitions.aframe' suffix to recover the namespace id\n                const namespaceId = file.slice(0, -defSuffix.length);\n                const decoded = this.codec.decodePayload(plain);\n                records[namespaceId] = decoded.map(r => ({\n                    aseid: r.aseid,\n                    name: r.name,\n                    hash: r.hash,\n                    type: r.type,\n                    source: r.source,\n                    description: r.description,\n                    metadata: r.metadata,\n                    namespace: r.namespace,\n                    embedding: Array.from(r.embedding ?? []),\n                    date: r.date,\n                    model: r.model,\n                    credentialId: r.credentialId,\n                    aFrameVersion: r.aFrameVersion,\n                    aFrameServerVersion: r.aFrameServerVersion,\n                    aFrameMeta: r.aFrameMeta,\n                }));\n            }\n        }\n\n        return {\n            bundleVersion: A_FRAME_BUNDLE_VERSION,\n            aFrameVersion: (pkg as any).version || '0.0.0',\n            serverVersion: opts.serverVersion,\n            builtAt: new Date().toISOString(),\n            records,\n            namespaceRecords,\n        };\n    }\n\n    /** Write the bundle to disk as a JSON file. */\n    async writeJSON(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, JSON.stringify(bundle, null, 2));\n    }\n\n    /**\n     * Emit a TypeScript module that exports the bundle as a typed constant.\n     * Ideal for Vite/Webpack/esbuild projects that tree-shake TS imports.\n     */\n    async writeTS(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        const banner = '// AUTO-GENERATED by @adaas/a-frame — do not edit.\\n';\n        const body =\n            `import type { A_FrameBundle } from '@adaas/a-frame/bundle';\\n\\n` +\n            `export const A_FRAME_BUNDLE: A_FrameBundle = ${JSON.stringify(bundle, null, 2)} as A_FrameBundle;\\n`;\n        await fs.mkdir(path.dirname(path.resolve(outFile)), { recursive: true });\n        await fs.writeFile(outFile, banner + body);\n    }\n\n    /** Convenience: detect output format by extension and write. */\n    async writeAuto(bundle: A_FrameBundle, outFile: string): Promise<void> {\n        if (/\\.tsx?$/.test(outFile)) return this.writeTS(bundle, outFile);\n        return this.writeJSON(bundle, outFile);\n    }\n}\n\n"]}

package/dist/node/channel.cjs

@@ -1,60 +1,67 @@
 'use strict';
 
-var chunkLJIZ47HO_cjs = require('./chunk-LJIZ47HO.cjs');
-require('./chunk-B7ZDJXD3.cjs');
+var chunkX3TRPYGV_cjs = require('./chunk-X3TRPYGV.cjs');
+var chunkBBYOL3LM_cjs = require('./chunk-BBYOL3LM.cjs');
+require('./chunk-WTBRJXFG.cjs');
+require('./chunk-KKL2DF2D.cjs');
+require('./chunk-BSBY37MG.cjs');
 require('./chunk-KK64VLZN.cjs');
-require('./chunk-KLG6HKFU.cjs');
-require('./chunk-3LOMGNWA.cjs');
-require('./chunk-GBTFMT3K.cjs');
+require('./chunk-7SEZMRLI.cjs');
+require('./chunk-3ZDHQOIU.cjs');
+require('./chunk-C37B34MH.cjs');
+require('./chunk-HELNAM5Y.cjs');
+require('./chunk-IYEDO7OQ.cjs');
 require('./chunk-ZM2RLVVH.cjs');
-require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-A7CJIUYY.cjs');
+require('./chunk-HAORARSB.cjs');
+require('./chunk-64QCZG53.cjs');
 require('./chunk-QFHZIG7Y.cjs');
 
 
 
-Object.defineProperty(exports, "A_FrameChannel", {
+Object.defineProperty(exports, "A_FrameChannelEvent", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannel; }
+  get: function () { return chunkX3TRPYGV_cjs.A_FrameChannelEvent; }
 });
-Object.defineProperty(exports, "A_FrameChannelError", {
+Object.defineProperty(exports, "A_FrameChannelStream", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelError; }
+  get: function () { return chunkX3TRPYGV_cjs.A_FrameChannelStream; }
 });
-Object.defineProperty(exports, "A_FrameChannelEvent", {
+Object.defineProperty(exports, "A_FrameNodeChannel", {
+  enumerable: true,
+  get: function () { return chunkX3TRPYGV_cjs.A_FrameNodeChannel; }
+});
+Object.defineProperty(exports, "A_FrameChannel", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelEvent; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannel; }
+});
+Object.defineProperty(exports, "A_FrameChannelError", {
+  enumerable: true,
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelError; }
 });
 Object.defineProperty(exports, "A_FrameChannelRequest", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelRequest; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelRequest; }
 });
 Object.defineProperty(exports, "A_FrameChannelSocketFeatures", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelSocketFeatures; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelSocketFeatures; }
 });
 Object.defineProperty(exports, "A_FrameChannelSocketStatuses", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelSocketStatuses; }
-});
-Object.defineProperty(exports, "A_FrameChannelStream", {
-  enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelStream; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelSocketStatuses; }
 });
 Object.defineProperty(exports, "A_FrameChannelStreamFeatures", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelStreamFeatures; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelStreamFeatures; }
 });
 Object.defineProperty(exports, "A_FrameChannelStreamStatuses", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameChannelStreamStatuses; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameChannelStreamStatuses; }
 });
 Object.defineProperty(exports, "A_FrameFeatures", {
   enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameFeatures; }
-});
-Object.defineProperty(exports, "A_FrameNodeChannel", {
-  enumerable: true,
-  get: function () { return chunkLJIZ47HO_cjs.A_FrameNodeChannel; }
+  get: function () { return chunkBBYOL3LM_cjs.A_FrameFeatures; }
 });
 //# sourceMappingURL=channel.cjs.map
 //# sourceMappingURL=channel.cjs.map

package/dist/node/channel.d.mts

@@ -1,12 +1,16 @@
-import { A as A_FrameChannel } from './A-FrameChannel.component-NNKcFViw.mjs';
-import { d as A_FrameChannelStream_Init, e as A_FrameChannelStream_Serialized, f as A_FrameChannelStreamStatusNames, A as A_FrameChannelRequest } from './A-FrameChannel.types-DQF-IiRq.mjs';
-export { g as A_FrameChannelSocketFeatureNames, h as A_FrameChannelSocketFeatures, i as A_FrameChannelSocketStatusNames, j as A_FrameChannelSocketStatuses, k as A_FrameChannelSocket_Init, l as A_FrameChannelSocket_Serialized, m as A_FrameChannelStreamFeatureNames, n as A_FrameChannelStreamFeatures, o as A_FrameChannelStreamStatuses, p as A_FrameFeatures, c as A_Frame_CredentialResponse, b as A_Frame_EmbedResponse, a as A_Frame_GenerateResponse, I as IA_Frame_Channel } from './A-FrameChannel.types-DQF-IiRq.mjs';
+import { e as A_FrameChannel } from './A-FrameChannel.component-DMA-3sUB.mjs';
+import { A as A_FrameChannelStream_Init, a as A_FrameChannelStream_Serialized, b as A_FrameChannelStreamStatusNames, c as A_FrameChannelRequest } from './A-FrameChannel.types-BsE6bNky.mjs';
+export { d as A_FrameChannelSocketFeatureNames, e as A_FrameChannelSocketFeatures, f as A_FrameChannelSocketStatusNames, g as A_FrameChannelSocketStatuses, h as A_FrameChannelSocket_Init, i as A_FrameChannelSocket_Serialized, j as A_FrameChannelStreamFeatureNames, k as A_FrameChannelStreamFeatures, l as A_FrameChannelStreamStatuses, m as A_FrameEmbedOptions, n as A_FrameEmbeddingTask, o as A_FrameFeatures, p as A_Frame_CompletionResponse, q as A_Frame_CredentialResponse, r as A_Frame_EmbedResponse, s as A_Frame_GenerateResponse, t as A_Frame_SchemaResponse, I as IA_Frame_Channel } from './A-FrameChannel.types-BsE6bNky.mjs';
 import { A_Error, A_Entity, A_Scope, A_Fragment } from '@adaas/a-concept';
 import { A_FrameEnv } from './env.mjs';
-import './A-FrameDefinition.entity-DWGN_Ujr.mjs';
-import './A-FrameNamespace.entity-rCm1AavP.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
 import './vector.mjs';
-import './A-FrameDynamicStructure.entity-DaBgSRCR.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';
 
 declare class A_FrameChannelError extends A_Error {
     static readonly InvalidRequest = "InvalidRequest";

package/dist/node/channel.d.ts

@@ -1,12 +1,16 @@
-import { A as A_FrameChannel } from './A-FrameChannel.component-BfBcs734.js';
-import { d as A_FrameChannelStream_Init, e as A_FrameChannelStream_Serialized, f as A_FrameChannelStreamStatusNames, A as A_FrameChannelRequest } from './A-FrameChannel.types-DQF-IiRq.js';
-export { g as A_FrameChannelSocketFeatureNames, h as A_FrameChannelSocketFeatures, i as A_FrameChannelSocketStatusNames, j as A_FrameChannelSocketStatuses, k as A_FrameChannelSocket_Init, l as A_FrameChannelSocket_Serialized, m as A_FrameChannelStreamFeatureNames, n as A_FrameChannelStreamFeatures, o as A_FrameChannelStreamStatuses, p as A_FrameFeatures, c as A_Frame_CredentialResponse, b as A_Frame_EmbedResponse, a as A_Frame_GenerateResponse, I as IA_Frame_Channel } from './A-FrameChannel.types-DQF-IiRq.js';
+import { e as A_FrameChannel } from './A-FrameChannel.component-C0O3TaRD.js';
+import { A as A_FrameChannelStream_Init, a as A_FrameChannelStream_Serialized, b as A_FrameChannelStreamStatusNames, c as A_FrameChannelRequest } from './A-FrameChannel.types-DD2B11rf.js';
+export { d as A_FrameChannelSocketFeatureNames, e as A_FrameChannelSocketFeatures, f as A_FrameChannelSocketStatusNames, g as A_FrameChannelSocketStatuses, h as A_FrameChannelSocket_Init, i as A_FrameChannelSocket_Serialized, j as A_FrameChannelStreamFeatureNames, k as A_FrameChannelStreamFeatures, l as A_FrameChannelStreamStatuses, m as A_FrameEmbedOptions, n as A_FrameEmbeddingTask, o as A_FrameFeatures, p as A_Frame_CompletionResponse, q as A_Frame_CredentialResponse, r as A_Frame_EmbedResponse, s as A_Frame_GenerateResponse, t as A_Frame_SchemaResponse, I as IA_Frame_Channel } from './A-FrameChannel.types-DD2B11rf.js';
 import { A_Error, A_Entity, A_Scope, A_Fragment } from '@adaas/a-concept';
 import { A_FrameEnv } from './env.js';
-import './A-FrameDefinition.entity-CAUOdEvU.js';
-import './A-FrameNamespace.entity-D3fZBGDx.js';
+import './A-FrameDefinition.entity-C0kzaGJ0.js';
+import './A-FrameDefinition.types-BA_pLGpo.js';
+import './A-FrameNamespace.entity-HDXcLGcS.js';
 import './vector.js';
-import './A-FrameDynamicStructure.entity-DaBgSRCR.js';
+import './A-FrameDynamicContentOperation.context-C_aH1gEn.js';
+import './A-FrameSegment.entity-C0izuOmC.js';
+import './A-FrameCompletion.entity-Brx11JMp.js';
+import './A-FrameSchema.entity-DjYIhsoj.js';
 
 declare class A_FrameChannelError extends A_Error {
     static readonly InvalidRequest = "InvalidRequest";

package/dist/node/channel.mjs

@@ -1,11 +1,18 @@
-export { A_FrameChannel, A_FrameChannelError, A_FrameChannelEvent, A_FrameChannelRequest, A_FrameChannelSocketFeatures, A_FrameChannelSocketStatuses, A_FrameChannelStream, A_FrameChannelStreamFeatures, A_FrameChannelStreamStatuses, A_FrameFeatures, A_FrameNodeChannel } from './chunk-DDCEMKBP.mjs';
-import './chunk-JQBYDEMW.mjs';
+export { A_FrameChannelEvent, A_FrameChannelStream, A_FrameNodeChannel } from './chunk-IHELFDCW.mjs';
+export { A_FrameChannel, A_FrameChannelError, A_FrameChannelRequest, A_FrameChannelSocketFeatures, A_FrameChannelSocketStatuses, A_FrameChannelStreamFeatures, A_FrameChannelStreamStatuses, A_FrameFeatures } from './chunk-7OLLATCC.mjs';
+import './chunk-GRNVK7DW.mjs';
+import './chunk-M2ZSE6YJ.mjs';
+import './chunk-5OTXZ7BB.mjs';
 import './chunk-K4MZY4ME.mjs';
-import './chunk-APRYHBEF.mjs';
-import './chunk-TO4BPKCY.mjs';
-import './chunk-B7BXP7K4.mjs';
+import './chunk-AMMQ76RJ.mjs';
+import './chunk-OK7I5OQ3.mjs';
+import './chunk-UCAWV2IG.mjs';
+import './chunk-SKIEPTFS.mjs';
+import './chunk-RVXASBMQ.mjs';
 import './chunk-442DXGOD.mjs';
-import './chunk-3TD2PEDZ.mjs';
+import './chunk-WXCQCHAX.mjs';
+import './chunk-IAL2NK2V.mjs';
+import './chunk-2HUSP34L.mjs';
 import './chunk-OI76LHVT.mjs';
 //# sourceMappingURL=channel.mjs.map
 //# sourceMappingURL=channel.mjs.map

package/dist/node/chunk-2HUSP34L.mjs

@@ -0,0 +1,55 @@
+// src/lib/A-FrameModels/A-FrameModels.constants.ts
+var A_FRAME_MODELS = {
+  // ── Embedding ─────────────────────────────────────────────────────────────
+  /**
+   * 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.
+   */
+  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.
+   */
+  VEGA: "adaas-vega-v1",
+  // ── Completion ────────────────────────────────────────────────────────────
+  /**
+   * 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.
+   */
+  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.
+   */
+  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.
+   */
+  LYRA: "adaas-lyra-v1",
+  /**
+   * Nova — param extraction model.
+   *
+   * Illuminates structured JSON parameters hidden inside unstructured text.
+   * Outputs constrained JSON by default.
+   */
+  NOVA: "adaas-nova-v1"
+};
+
+export { A_FRAME_MODELS };
+//# sourceMappingURL=chunk-2HUSP34L.mjs.map
+//# sourceMappingURL=chunk-2HUSP34L.mjs.map

package/dist/node/chunk-2HUSP34L.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/A-FrameModels/A-FrameModels.constants.ts"],"names":[],"mappings":";AAcO,IAAM,cAAA,GAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAW1B,OAAA,EAAS,kBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQT,IAAA,EAAM,eAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWN,KAAA,EAAO,gBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASP,MAAA,EAAQ,iBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASR,IAAA,EAAM,eAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQN,IAAA,EAAM;AAEV","file":"chunk-2HUSP34L.mjs","sourcesContent":["/**\n * Adaas named model identifiers — client-side mirror of the server catalog.\n *\n * These are the stable logical identifiers for each model role. Pass them\n * wherever an entity or channel method accepts a `model` option to target a\n * specific named model on the server.\n *\n * The server resolves these IDs to physical backend models (e.g. Ollama,\n * OpenAI) and applies any required task prefixes automatically. Swapping to a\n * dedicated fine-tuned model in the future requires no changes on the client.\n *\n * @see adaas-a-frame-mcp/README.models.md\n */\n\nexport const A_FRAME_MODELS = {\n\n    // ── Embedding ─────────────────────────────────────────────────────────────\n\n    /**\n     * Antares — component definition embedding model.\n     *\n     * Indexes component sources and namespace definitions with the\n     * `search_document:` prefix.  The reference system everything navigates\n     * against.  Use when storing content that will be retrieved later.\n     */\n    ANTARES: 'adaas-antares-v1' as const,\n\n    /**\n     * Vega — search query embedding model.\n     *\n     * Produces `search_query:` prefixed vectors for retrieval against the\n     * Antares index.  Use when embedding a user query or search term.\n     */\n    VEGA: 'adaas-vega-v1' as const,\n\n    // ── Completion ────────────────────────────────────────────────────────────\n\n    /**\n     * Rigel — code completion model.\n     *\n     * Generates TypeScript/JavaScript code with syntax precision.\n     * Default model for `A_FrameCompletion` — use for code generation,\n     * scaffolding, and structured source output.\n     */\n    RIGEL: 'adaas-rigel-v1' as const,\n\n    /**\n     * Pulsar — software architecture completion model.\n     *\n     * Decomposes requirements into structured component designs.\n     * Use for architecture analysis, DSG structure generation, and\n     * patch planning.\n     */\n    PULSAR: 'adaas-pulsar-v1' as const,\n\n    /**\n     * Lyra — bridge/classifier model.\n     *\n     * Translates content semantics into structured text.\n     * Default model for `A_FrameDynamicContent` — use for content\n     * generation and patching.\n     */\n    LYRA: 'adaas-lyra-v1' as const,\n\n    /**\n     * Nova — param extraction model.\n     *\n     * Illuminates structured JSON parameters hidden inside unstructured text.\n     * Outputs constrained JSON by default.\n     */\n    NOVA: 'adaas-nova-v1' as const,\n\n} as const;\n\nexport type A_FrameModelId = typeof A_FRAME_MODELS[keyof typeof A_FRAME_MODELS];\n"]}