@adaas/a-frame 0.0.23 → 0.1.2

package/src/lib/A-FrameChannel/A-FrameChannel.types.ts

@@ -6,6 +6,33 @@ import {
     A_FrameChannelSocketStatuses,
     A_FrameChannelSocketFeatures,
 } from "./A-FrameChannel.constants";
+import { DefinitionExtractedMeta } from "../A-FrameDefinition/A-FrameDefinition.types";
+
+/**
+ * Retrieval task hint for asymmetric embedding models (e.g. adaas-antares-v1).
+ * - 'query'    — text is a search query (default for channel.embed)
+ * - 'document' — text is content being indexed (used internally for definitions)
+ * - 'default'  — no prefix / symmetric mode
+ */
+export type A_FrameEmbeddingTask = 'document' | 'query' | 'default';
+
+/**
+ * Options for channel.embed() — mirrors A_FrameCompletionOptions so the
+ * same override pattern is available for both completions and embeddings.
+ */
+export interface A_FrameEmbedOptions {
+    /**
+     * Override the embedding model for this request
+     * (e.g. "adaas-antares-v1", "adaas-vega-v1").
+     * Falls back to the server's configured default when omitted.
+     */
+    model?: string;
+    /**
+     * Task hint used by asymmetric embedding models.
+     * Defaults to 'query' when calling channel.embed() for search.
+     */
+    task?: A_FrameEmbeddingTask;
+}
 
 export interface A_Frame_EmbedResponse {
     data: Array<{ embedding: number[]; index: number }>;
@@ -26,6 +53,8 @@ export interface A_Frame_EmbedResponse {
         /** ID of the credential (API key) used for this request */
         credential_id: string | null;
     };
+    /** Structural metadata extracted from the source by the server */
+    aFrameMeta?: DefinitionExtractedMeta;
 }
 
 
@@ -48,6 +77,26 @@ export interface A_Frame_GenerateResponse {
     };
 }
 
+export interface A_Frame_CompletionResponse {
+    /** The generated text completion. */
+    text: string;
+    /** Embedding of the generated text as a plain number array. */
+    embedding: number[];
+    /** The model used for completion (may differ from the embedding model). */
+    model: string;
+    /** ISO timestamp of when the response was produced. */
+    date: string;
+    meta: {
+        /** Dimensionality of the embedding vector. */
+        dimensions: number;
+        /** Embed-server (a-frame-mcp) package version. */
+        server_version: string;
+        /** ID of the credential (API key) used for this request. */
+        credential_id: string | null;
+    };
+}
+
+
 export interface A_Frame_CredentialResponse {
     /** Unique identifier for the credential */
     id: string;
@@ -75,7 +124,7 @@ export interface IA_Frame_Channel {
     generate(prompt: string): Promise<A_FrameChannelRequest<A_Frame_GenerateResponse>>;
 
     /** Embed one or more raw text strings and return the server response */
-    embed(inputs: string | string[]): Promise<A_FrameChannelRequest<A_Frame_EmbedResponse>>;
+    embed(inputs: string | string[], options?: A_FrameEmbedOptions): Promise<A_FrameChannelRequest<A_Frame_EmbedResponse>>;
 
     /** Fetch credential details (incl. encryption key) for the authenticated API key */
     getCredentials(): Promise<A_FrameChannelRequest<A_Frame_CredentialResponse>>;
@@ -122,6 +171,21 @@ export type A_FrameChannelSocketStatusNames = typeof A_FrameChannelSocketStatuse
 
 export type A_FrameChannelSocketFeatureNames = typeof A_FrameChannelSocketFeatures[keyof typeof A_FrameChannelSocketFeatures];
 
+export interface A_Frame_SchemaResponse<
+    T extends Record<string, unknown> = Record<string, unknown>
+> {
+    /** The structured data extracted from the prompt. */
+    data: T;
+    /** Physical model name used for extraction. */
+    model: string;
+    /** ISO timestamp of when the extraction was produced. */
+    date: string;
+    meta: {
+        /** Embed-server (a-frame-mcp) package version. */
+        server_version: string;
+    };
+}
+
 export type A_FrameChannelSocket_Init<
     T extends Record<string, any> = Record<string, any>
 > = {

package/src/lib/A-FrameChannel/A-FrameChannelDsgStream.entity.ts

@@ -0,0 +1,112 @@
+import { A_Inject } from "@adaas/a-concept";
+import { A_FrameChannelStream } from "./A-FrameChannelStream.entity";
+import { A_FrameChannelEvent } from "./A-FrameChannelEvent.context";
+import { A_FrameVector } from "../A-FrameVector/A-FrameVector.entity";
+import { A_FrameIndex } from "../A-FrameIndex/A-FrameIndex.context";
+
+/** @deprecated  Legacy SSE resolved-component shape — kept for backward compatibility only. */
+type A_FrameDynamicStructureResolvedComponent = { id: string; type: string; prompt: string; role: string };
+
+type DsgRespondFn = (requestId: string, data: { component: string | null; score: number }) => Promise<void>;
+
+/**
+ * A_FrameChannelDsgStream
+ *
+ * SSE stream entity used by the SSE-driven dynamic-structure generation
+ * pipeline.  Handles the following server-pushed events:
+ *
+ *   search_component   — server sends an embedded vector and asks the client
+ *                        to find the best matching registered component.
+ *   structure_complete — server sends the final resolved component list.
+ *   structure_error    — server reports a pipeline error.
+ *
+ * Usage:
+ *   const stream = new A_FrameChannelDsgStream({ path: `/api/v1/dsg/stream/${channelId}` });
+ *   stream.setRespondFn(async (requestId, data) => { ... });
+ *   // open SSE connection, then retrieve stream.resolvedComponents
+ */
+export class A_FrameChannelDsgStream extends A_FrameChannelStream {
+
+    private _respondFn?: DsgRespondFn;
+    private _resolvedComponents: A_FrameDynamicStructureResolvedComponent[] = [];
+
+    // ── Configuration ──────────────────────────────────────────────────────
+
+    /**
+     * Provide the callback that sends a component-search response back to the
+     * server via HTTP POST.  Must be set before the SSE stream is opened.
+     */
+    setRespondFn(fn: DsgRespondFn): void {
+        this._respondFn = fn;
+    }
+
+    // ── Result accessor ────────────────────────────────────────────────────
+
+    /**
+     * Contains the resolved components after `structure_complete` is received.
+     * Empty until the server pushes the final structure.
+     */
+    get resolvedComponents(): ReadonlyArray<A_FrameDynamicStructureResolvedComponent> {
+        return this._resolvedComponents;
+    }
+
+    // ── SSE event handlers ─────────────────────────────────────────────────
+
+    /**
+     * Server requests that the client search its local index for the best
+     * component matching the provided pre-embedded vector.
+     *
+     * Event data: { requestId, vector, type, role, prompt }
+     */
+    @A_FrameChannelStream.onEvent('search_component')
+    async onSearchComponent(
+        @A_Inject(A_FrameChannelEvent) event: A_FrameChannelEvent,
+    ) {
+        if (!this._respondFn) return;
+
+        const { requestId, vector } = event.data as {
+            requestId: string;
+            vector: number[];
+            type: string;
+            role: string;
+            prompt: string;
+        };
+
+        const queryVector = new A_FrameVector(vector ?? []);
+        const results = A_FrameIndex.search(queryVector, { topK: 1 });
+        const top = results[0];
+
+        await this._respondFn(requestId, {
+            component: top?.record?.name ?? null,
+            score: top?.score ?? 0,
+        });
+    }
+
+    /**
+     * Server pushes the final resolved component list.
+     *
+     * Event data: { components, prompt }
+     */
+    @A_FrameChannelStream.onEvent('structure_complete')
+    async onStructureComplete(
+        @A_Inject(A_FrameChannelEvent) event: A_FrameChannelEvent,
+    ) {
+        const { components } = event.data as {
+            components: A_FrameDynamicStructureResolvedComponent[];
+            prompt: string;
+        };
+        this._resolvedComponents = Array.isArray(components) ? components : [];
+    }
+
+    /**
+     * Server reports a generation error.
+     */
+    @A_FrameChannelStream.onEvent('structure_error')
+    async onStructureError(
+        @A_Inject(A_FrameChannelEvent) event: A_FrameChannelEvent,
+    ) {
+        const { message } = (event.data ?? {}) as { message?: string };
+
+        console.error('[A_FrameChannelDsgStream] Server reported structure error:', message ?? 'unknown');
+    }
+}

package/src/lib/A-FrameChannel/A-FrameChannelStream.entity.ts

@@ -115,6 +115,7 @@ export class A_FrameChannelStream<
     }
 
     fromNew(newEntity: A_FrameChannelStream_Init<T>): void {
+        this.aseid = this.generateASEID();
         this._method = newEntity.method;
         this._path = newEntity.path;
         this._body = newEntity.body;

package/src/lib/A-FrameChannel/index.browser.ts

@@ -1,3 +1,8 @@
 export * from './A-FrameChannel.component.env-browser';
 export { A_FrameChannelSocket } from './A-FrameChannelSocket.entity';
 export * from './A-FrameChannel.types';
+export * from './A-FrameChannel.error';
+export * from './A-FrameChannel.constants';
+export * from './A-FrameChannelStream.entity';
+export * from './A-FrameChannelEvent.context';
+export * from './A-FrameChannelRequest.context';

package/src/lib/A-FrameCompletion/A-FrameCompletion.constants.ts

@@ -0,0 +1,3 @@
+export const A_FrameCompletionFeatures = {
+    Generate: '_A_FRAME_COMPLETION_GENERATE',
+} as const;

package/src/lib/A-FrameCompletion/A-FrameCompletion.entity.ts

@@ -0,0 +1,128 @@
+import { A_Entity, A_Scope } from "@adaas/a-concept";
+import { A_FrameVector } from "../A-FrameVector/A-FrameVector.entity";
+import {
+    A_FrameCompletion_Init,
+    A_FrameCompletion_Serialized,
+    A_FrameCompletionOptions,
+} from "./A-FrameCompletion.types";
+import { A_FrameCompletionFeatures } from "./A-FrameCompletion.constants";
+import { A_FRAME_MODELS } from "../A-FrameModels/A-FrameModels.constants";
+
+
+export class A_FrameCompletion extends A_Entity<A_FrameCompletion_Init, A_FrameCompletion_Serialized> {
+
+    static get concept(): string {
+        return 'a-frame';
+    }
+
+    protected _prompt!: string;
+    protected _options?: A_FrameCompletionOptions;
+
+    protected _text?: string;
+    protected _vector?: A_FrameVector;
+    protected _model?: string;
+    protected _date?: string;
+    protected _aFrameVersion?: string;
+    protected _aFrameServerVersion?: string;
+
+
+    // ─── Getters ──────────────────────────────────────────────────────────────
+
+    get prompt(): string {
+        return this._prompt;
+    }
+
+    get options(): A_FrameCompletionOptions | undefined {
+        return this._options;
+    }
+
+    get text(): string | undefined {
+        return this._text;
+    }
+
+    get vector(): A_FrameVector | undefined {
+        return this._vector;
+    }
+
+    get embedding(): Float32Array | null {
+        return this._vector?.values ?? null;
+    }
+
+    get model(): string | undefined {
+        return this._model;
+    }
+
+    get date(): string | undefined {
+        return this._date;
+    }
+
+    get isGenerated(): boolean {
+        return this._text !== undefined;
+    }
+
+
+    // ─── Lifecycle ────────────────────────────────────────────────────────────
+
+    fromNew(init: A_FrameCompletion_Init): void {
+        super.fromNew(init);
+        this._prompt = init.prompt;
+        // Apply Rigel as the default model for code generation when none specified.
+        this._options = init.options?.model
+            ? init.options
+            : { model: A_FRAME_MODELS.RIGEL, ...init.options };
+    }
+
+    fromJSON(serialized: A_FrameCompletion_Serialized): void {
+        this._prompt = serialized.prompt;
+        this._text = serialized.text;
+        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;
+        this._model = serialized.model;
+        this._date = serialized.date;
+        this._aFrameVersion = serialized.aFrameVersion;
+        this._aFrameServerVersion = serialized.aFrameServerVersion;
+    }
+
+    toJSON(): A_FrameCompletion_Serialized {
+        return {
+            ...super.toJSON(),
+            prompt: this._prompt,
+            text: this._text,
+            embedding: this._vector?.values,
+            model: this._model,
+            date: this._date,
+            aFrameVersion: this._aFrameVersion,
+            aFrameServerVersion: this._aFrameServerVersion,
+        };
+    }
+
+
+    // ─── Operations ──────────────────────────────────────────────────────────
+
+    /**
+     * Generates a text completion for the prompt and stores the resulting text
+     * along with its embedding vector. The actual implementation is provided by
+     * the A_FrameCompletionFeatures.Generate feature (supplied by A_FrameChannel).
+     */
+    generate(scope?: A_Scope): Promise<void> | void {
+        return this.call(A_FrameCompletionFeatures.Generate, scope);
+    }
+
+
+    // ─── Hydration ────────────────────────────────────────────────────────────
+
+    hydrateFromGeneration(result: {
+        text: string;
+        embedding: Float32Array;
+        model?: string;
+        date?: string;
+        aFrameVersion?: string;
+        aFrameServerVersion?: string;
+    }): void {
+        this._text = result.text;
+        this._vector = new A_FrameVector(result.embedding);
+        this._model = result.model;
+        this._date = result.date;
+        this._aFrameVersion = result.aFrameVersion;
+        this._aFrameServerVersion = result.aFrameServerVersion;
+    }
+}

package/src/lib/A-FrameCompletion/A-FrameCompletion.types.ts

@@ -0,0 +1,40 @@
+import { A_TYPES__Entity_Serialized } from "@adaas/a-concept";
+import { A_FRAME_MODELS } from "../A-FrameModels/A-FrameModels.constants";
+
+
+// ─── Init / lifecycle types ───────────────────────────────────────────────────────────────────
+
+export type A_FrameCompletionOptions = {
+    /**
+     * Override the AI model for this completion.
+     * Defaults to `A_FRAME_MODELS.RIGEL` ('adaas-rigel-v1') — the
+     * code-generation model optimised for TypeScript/JavaScript output.
+     * Pass any other `A_FRAME_MODELS` constant or a raw model name to override.
+     */
+    model?: string;
+    /** Optional system prompt prepended before the user message. */
+    system?: string;
+    /** Max tokens to generate. */
+    max_tokens?: number;
+    /** Temperature 0–1. Lower = more deterministic. */
+    temperature?: number;
+}
+
+/** Convenience re-export so consumers can reference model IDs from the same import. */
+export { A_FRAME_MODELS };
+
+export type A_FrameCompletion_Init = {
+    /** The input prompt to generate a completion for. */
+    prompt: string;
+    options?: A_FrameCompletionOptions;
+}
+
+export type A_FrameCompletion_Serialized = {
+    prompt: string;
+    text?: string;
+    embedding?: Float32Array;
+    model?: string;
+    date?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized

package/src/lib/A-FrameCompletion/index.ts

@@ -0,0 +1,3 @@
+export * from './A-FrameCompletion.entity';
+export * from './A-FrameCompletion.types';
+export * from './A-FrameCompletion.constants';

package/src/lib/A-FrameCredentials/A-FrameCredentials.constants.ts

@@ -0,0 +1,5 @@
+export const A_FrameCredentialsFeatures = {
+    Load: '_A_FRAME_CREDENTIALS_LOAD',
+    Save: '_A_FRAME_CREDENTIALS_SAVE',
+    Destroy: '_A_FRAME_CREDENTIALS_DESTROY',
+} as const;

package/src/lib/A-FrameCredentials/A-FrameCredentials.entity.ts

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

package/src/lib/A-FrameCredentials/A-FrameCredentials.types.ts

@@ -0,0 +1,39 @@
+import { A_TYPES__Entity_Serialized } from "@adaas/a-concept";
+
+
+// ─── Entity lifecycle types ───────────────────────────────────────────────────
+
+/**
+ * Initialization shape — matches the server response from GET /api/v1/credentials/me
+ */
+export type A_FrameCredentials_Init = {
+    /** Unique identifier for the credential (as returned by the a-frame-mcp server) */
+    id: string;
+    /** Human-readable credential name */
+    name: string;
+    /** Optional description */
+    description?: string | null;
+    /** Encryption key in the encoding specified by key_encoding */
+    encryption_key: string;
+    /** Encryption algorithm (e.g. "AES-256-GCM") */
+    algorithm: string;
+    /** Encoding format of the key (e.g. "base64") */
+    key_encoding: string;
+    /** Usage note provided by the server */
+    usage_note?: string | null;
+    /** Version of the a-frame-mcp server that issued this credential */
+    server_version: string;
+};
+
+/**
+ * Serialized shape — persisted / round-tripped via toJSON / fromJSON.
+ * The encryption key is intentionally excluded from serialization.
+ */
+export type A_FrameCredentials_Serialized = {
+    credentialId: string;
+    name: string;
+    description?: string | null;
+    algorithm: string;
+    key_encoding: string;
+    serverVersion: string;
+} & A_TYPES__Entity_Serialized;

package/src/lib/A-FrameCredentials/index.ts

@@ -0,0 +1,3 @@
+export * from './A-FrameCredentials.entity';
+export * from './A-FrameCredentials.types';
+export * from './A-FrameCredentials.constants';

package/src/lib/A-FrameDefinition/A-FrameDefinition.entity.ts

@@ -3,12 +3,14 @@ import {
     A_FrameDefinition_EmbeddingMeta,
     A_FrameDefinition_Init,
     A_FrameDefinition_Serialized,
+    DefinitionExtractedMeta,
 } from "./A-FrameDefinition.types";
 import { A_FrameVector } from "../A-FrameVector/A-FrameVector.entity";
 import { A_FrameNamespace } from "../A-FrameNamespace";
 import { A_FrameHashHelper } from "@adaas/a-frame/helpers/Hash.helper";
 import { A_FrameDefinitionFeatures } from "./A-FrameDefinition.constants";
 import { A_FrameTargetType } from "../A-Frame/A-Frame.types";
+import { A_FRAME_MODELS } from "../A-FrameModels";
 
 export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameDefinition_Serialized> {
 
@@ -25,16 +27,17 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
     protected _metadata?: Record<string, any>;
     protected _vector?: A_FrameVector;
 
-
     /**
      * Common properties for all definition types (component, entity, container, fragment, method
      */
     protected _hash!: string;
     protected _date?: string;
     protected _model!: string;
+    protected _requestedModel!: string;
     protected _credentialId!: string;
     protected _aFrameVersion!: string;
     protected _aFrameServerVersion!: string;
+    protected _aFrameMeta?: DefinitionExtractedMeta;
 
     //-----------------------------------------------------------------------------------------------------
     //---------------------------------------- Primary properties -----------------------------------------
@@ -112,6 +115,13 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
     get model(): string {
         return this._model;
     }
+    /**
+     * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`
+     * if not explicitly overridden. Sent to the server in the embed request.
+     */
+    get requestedModel(): string {
+        return this._requestedModel;
+    }
     /**
      * ID of the server credential (API key) used during embedding. This is useful for auditing and debugging embedding operations, especially when multiple credentials are in use.
      */
@@ -130,6 +140,13 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
     get aFrameServerVersion(): string | undefined {
         return this._aFrameServerVersion;
     }
+    /**
+     * Structural metadata extracted server-side when the definition was embedded.
+     * Includes discovered methods, @A_Inject dependencies, and @A_Feature.Extend names.
+     */
+    get aFrameMeta(): DefinitionExtractedMeta | undefined {
+        return this._aFrameMeta;
+    }
     //-----------------------------------------------------------------------------------------------------
     //--------------------------------------- Computed properties -----------------------------------------
     //-----------------------------------------------------------------------------------------------------
@@ -208,6 +225,7 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
         this._namespace = newEntity.namespace;
         this._metadata = newEntity.metadata;
         this._dependency = newEntity.dependency;
+        this._requestedModel = newEntity.model ?? A_FRAME_MODELS.ANTARES;
     }
 
     fromJSON(serialized: A_FrameDefinition_Serialized): void {
@@ -222,6 +240,7 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
         this._credentialId = serialized.credentialId;
         this._aFrameVersion = serialized.aFrameVersion;
         this._aFrameServerVersion = serialized.aFrameServerVersion;
+        this._aFrameMeta = serialized.aFrameMeta;
     }
 
     toJSON(): A_FrameDefinition_Serialized {
@@ -239,6 +258,7 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
             credentialId: this._credentialId,
             aFrameVersion: this._aFrameVersion,
             aFrameServerVersion: this._aFrameServerVersion,
+            aFrameMeta: this._aFrameMeta,
         };
     }
 
@@ -270,6 +290,8 @@ export class A_FrameDefinition extends A_Entity<A_FrameDefinition_Init, A_FrameD
             this._credentialId = meta.credentialId ?? undefined;
             this._aFrameVersion = meta.aFrameVersion;
             this._aFrameServerVersion = meta.aFrameServerVersion;
+            if (meta.aFrameMeta)
+                this._aFrameMeta = meta.aFrameMeta;
         }
     }