@adaas/a-frame 0.0.23 → 0.1.2

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

@@ -8,6 +8,7 @@ import {
 } from "./A-FrameNamespace.types";
 import { A_FrameHashHelper } from "@adaas/a-frame/helpers/Hash.helper";
 import { A_FrameNamespaceFeatures } from "./A-FrameNamespace.constants";
+import { A_FRAME_MODELS } from "../A-FrameModels";
 
 
 export class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNamespace_Serialized> {
@@ -23,8 +24,7 @@ export class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNam
     protected _vector?: A_FrameVector;
     protected _embeddedAt?: number;
     // ─── Provenance ───────────────────────────────────────────────────────────
-    protected _embeddingModel?: string;
-    protected _credentialId?: string;
+    protected _embeddingModel?: string;    protected _requestedModel!: string;    protected _credentialId?: string;
     protected _aFrameVersion?: string;
     protected _aFrameServerVersion?: string;
 
@@ -73,6 +73,13 @@ export class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNam
     get isEmbed(): boolean {
         return this._vector !== undefined;
     }
+    /**
+     * The model requested for embedding at init time. Defaults to `A_FRAME_MODELS.ANTARES`.
+     * Sent to the server in the embed request body as the `model` field.
+     */
+    get requestedModel(): string {
+        return this._requestedModel;
+    }
     /**
       * Saves Namespace to storage. The actual implementation of saving is handled by the A_FrameNamespaceFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.
       * 
@@ -80,7 +87,6 @@ export class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNam
       * @returns 
       */
     save(scope?: A_Scope): Promise<void> | void {
-        console.log(`Saving namespace "${this._name}"...`);
         return this.call(A_FrameNamespaceFeatures.Save, scope);
     }
     /**
@@ -140,6 +146,7 @@ export class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNam
         this._hash = A_FrameHashHelper.fnv1a(hashSource);
         this._description = init.description;
         this._metadata = init.metadata;
+        this._requestedModel = init.model ?? A_FRAME_MODELS.ANTARES;
     }
 
     fromJSON(serialized: A_FrameNamespace_Serialized): void {

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

@@ -8,6 +8,11 @@ export type A_FrameNamespace_Init = {
     name: string;
     description?: string;
     metadata?: Record<string, any>;
+    /**
+     * Optional embedding model override (e.g. `A_FRAME_MODELS.ANTARES`). When omitted the
+     * server defaults to the Antares model.
+     */
+    model?: string;
 }
 
 export type A_FrameNamespace_Serialized = {

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

@@ -0,0 +1,4 @@
+export const A_FrameSchemaFeatures = {
+    /** POST /api/v1/schema/extract — extract structured data from a prompt */
+    Extract: '_A_FRAME_SCHEMA_EXTRACT',
+} as const;

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

@@ -0,0 +1,154 @@
+import { A_Entity, A_Scope } from "@adaas/a-concept";
+import {
+    A_FrameSchema_Init,
+    A_FrameSchema_Serialized,
+    A_FrameSchema_ExtractionMeta,
+    A_FrameSchemaOptions,
+} from "./A-FrameSchema.types";
+import { A_FrameSchemaFeatures } from "./A-FrameSchema.constants";
+import { A_FRAME_MODELS } from "../A-FrameModels/A-FrameModels.constants";
+
+
+/**
+ * A_FrameSchema<T>
+ *
+ * Sends a natural-language prompt together with a schema descriptor to the
+ * server's `/api/v1/schema/extract` endpoint (Nova model).  The server
+ * returns a structured JSON object that maps the prompt's content to the
+ * fields described by `schema`.
+ *
+ * Generic parameter `T` constrains the shape of the extracted `data` getter
+ * so call-sites get full type-safety without casting.
+ *
+ * Usage:
+ * ```ts
+ * const scheme = new A_FrameSchema<{ city: string; date: string }>({
+ *     prompt: 'Book a flight to Paris next Monday.',
+ *     schema: { city: 'string', date: 'string' },
+ * });
+ * container.scope.register(scheme);
+ * await scheme.extract();
+ *
+ * console.log(scheme.data);   // { city: 'Paris', date: '...' }
+ * console.log(scheme.model);  // physical model name returned by the server
+ * console.log(scheme.isExtracted); // true
+ * ```
+ */
+export class A_FrameSchema<T extends Record<string, unknown> = Record<string, unknown>>
+    extends A_Entity<A_FrameSchema_Init<T>, A_FrameSchema_Serialized<T>> {
+
+    static get concept(): string {
+        return 'a-frame';
+    }
+
+    protected _prompt!: string;
+    protected _schema!: Record<keyof T, string | Record<string, string>>;
+    protected _options?: A_FrameSchemaOptions;
+
+    protected _data?: T;
+    protected _model?: string;
+    protected _date?: string;
+    protected _aFrameVersion?: string;
+    protected _aFrameServerVersion?: string;
+
+
+    // ─── Getters ──────────────────────────────────────────────────────────────
+
+    /** The natural-language input prompt used for extraction. */
+    get prompt(): string {
+        return this._prompt;
+    }
+
+    /** The schema descriptor passed at construction time. */
+    get schema(): Record<keyof T, string | Record<string, string>> {
+        return this._schema;
+    }
+
+    /** Configured options (model, system, temperature, max_tokens). */
+    get options(): A_FrameSchemaOptions | undefined {
+        return this._options;
+    }
+
+    /**
+     * The structured data extracted by the model.
+     * Returns `undefined` until `extract()` has been called successfully.
+     */
+    get data(): T | undefined {
+        return this._data;
+    }
+
+    /** Physical model name returned by the server after extraction. */
+    get model(): string | undefined {
+        return this._model;
+    }
+
+    /** ISO timestamp string of when the extraction was performed. */
+    get date(): string | undefined {
+        return this._date;
+    }
+
+    /** `true` once `extract()` has been called and data is populated. */
+    get isExtracted(): boolean {
+        return this._data !== undefined;
+    }
+
+
+    // ─── Lifecycle ────────────────────────────────────────────────────────────
+
+    fromNew(init: A_FrameSchema_Init<T>): void {
+        super.fromNew(init);
+        this._prompt = init.prompt;
+        this._schema = init.schema;
+        // Default to Nova — the structured-extraction model
+        this._options = init.options?.model
+            ? init.options
+            : { model: A_FRAME_MODELS.NOVA, ...init.options };
+    }
+
+    fromJSON(serialized: A_FrameSchema_Serialized<T>): void {
+        this._prompt = serialized.prompt;
+        this._schema = serialized.schema as Record<keyof T, string | Record<string, string>>;
+        this._data = serialized.data;
+        this._model = serialized.model;
+        this._date = serialized.date;
+        this._aFrameVersion = serialized.aFrameVersion;
+        this._aFrameServerVersion = serialized.aFrameServerVersion;
+    }
+
+    toJSON(): A_FrameSchema_Serialized<T> {
+        return {
+            ...super.toJSON(),
+            prompt: this._prompt,
+            schema: this._schema as Record<string, string | Record<string, string>>,
+            data: this._data,
+            model: this._model,
+            date: this._date,
+            aFrameVersion: this._aFrameVersion,
+            aFrameServerVersion: this._aFrameServerVersion,
+        };
+    }
+
+
+    // ─── Operations ───────────────────────────────────────────────────────────
+
+    /**
+     * Sends the prompt and schema to the server for structured extraction.
+     * After completion, `data` will be populated with a typed `T` object.
+     *
+     * The feature is implemented by `A_FrameChannel.extractSchema`.
+     */
+    extract(scope?: A_Scope): Promise<void> | void {
+        return this.call(A_FrameSchemaFeatures.Extract, scope);
+    }
+
+
+    // ─── Hydration ────────────────────────────────────────────────────────────
+
+    hydrateFromExtraction(data: T, meta: A_FrameSchema_ExtractionMeta): void {
+        this._data = data;
+        this._model = meta.model;
+        this._date = meta.date;
+        this._aFrameVersion = meta.aFrameVersion;
+        this._aFrameServerVersion = meta.aFrameServerVersion;
+    }
+}

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

@@ -0,0 +1,88 @@
+import { A_TYPES__Entity_Serialized } from "@adaas/a-concept";
+import { A_FRAME_MODELS } from "../A-FrameModels/A-FrameModels.constants";
+
+// ─── Options ──────────────────────────────────────────────────────────────────
+
+export type A_FrameSchemaOptions = {
+    /**
+     * Override the AI model used for parameter extraction.
+     *
+     * Defaults to `A_FRAME_MODELS.NOVA` ('adaas-nova-v1') — the structured
+     * JSON extraction model.  Pass any other `A_FRAME_MODELS` constant or a
+     * raw model name to override.
+     */
+    model?: string;
+    /**
+     * Optional system prompt that describes the target JSON schema to the model.
+     *
+     * When provided this is prepended before the standard extraction instructions,
+     * giving the model additional context about the shape it should produce.
+     *
+     * Example:
+     * ```
+     * system: 'You extract { name: string, age: number, city: string } from text.'
+     * ```
+     */
+    system?: string;
+    /** Temperature 0–1.  Lower values produce more deterministic JSON.  Default: 0. */
+    temperature?: number;
+    /** Maximum tokens the model may generate for the JSON response. */
+    max_tokens?: number;
+}
+
+/** Convenience re-export so consumers can reference model IDs from the same import. */
+export { A_FRAME_MODELS };
+
+// ─── Init ─────────────────────────────────────────────────────────────────────
+
+/**
+ * `T` — the shape of the structured data object you expect back from the model.
+ *
+ * Example:
+ * ```ts
+ * const scheme = new A_FrameSchema<{ city: string; date: string }>({
+ *     prompt: 'Book a flight to Paris next Monday.',
+ *     schema: { city: 'string', date: 'string' },
+ * });
+ * ```
+ */
+export type A_FrameSchema_Init<T extends Record<string, unknown> = Record<string, unknown>> = {
+    /**
+     * The natural-language input from which parameters should be extracted.
+     * This is the text sent to the model together with schema instructions.
+     */
+    prompt: string;
+    /**
+     * A plain-object describing the expected output schema.
+     *
+     * Each key is a field name; each value is either a type hint string
+     * (`'string'`, `'number'`, `'boolean'`) or a nested schema object.
+     * The server converts this into a system prompt that instructs the model
+     * to return JSON matching the shape.
+     *
+     * Example: `{ name: 'string', age: 'number', active: 'boolean' }`
+     */
+    schema: Record<keyof T, string | Record<string, string>>;
+    options?: A_FrameSchemaOptions;
+}
+
+// ─── Serialized ───────────────────────────────────────────────────────────────
+
+export type A_FrameSchema_Serialized<T extends Record<string, unknown> = Record<string, unknown>> = {
+    prompt: string;
+    schema: Record<string, string | Record<string, string>>;
+    data?: T;
+    model?: string;
+    date?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized
+
+// ─── Hydration ────────────────────────────────────────────────────────────────
+
+export type A_FrameSchema_ExtractionMeta = {
+    model: string;
+    date: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+}

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

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

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

@@ -0,0 +1,12 @@
+import { A_FrameSegment } from "./A-FrameSegment.entity";
+
+
+export const A_FRAME_DEFAULT_SEGMENT_KEY = 'default';
+
+
+export const A_FrameSegmentFeatures = {
+    Load: '_A_FRAME_SEGMENT_LOAD',
+    Save: '_A_FRAME_SEGMENT_SAVE',
+    Embed: '_A_FRAME_SEGMENT_EMBED',
+    Destroy: '_A_FRAME_SEGMENT_DESTROY',
+} as const;

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

@@ -0,0 +1,221 @@
+import { A_Context, A_Entity, A_FormatterHelper, A_Scope } from "@adaas/a-concept";
+import { A_FrameVector } from "../A-FrameVector/A-FrameVector.entity";
+import {
+    A_FrameSegment_Init,
+    A_FrameSegment_Serialized,
+    A_FrameSegment_Record,
+    A_FrameSegment_EmbeddingMeta,
+    A_FrameSegmentOptions,
+} from "./A-FrameSegment.types";
+import { A_FrameHashHelper } from "@adaas/a-frame/helpers/Hash.helper";
+import { A_FrameSegmentFeatures } from "./A-FrameSegment.constants";
+import { A_FRAME_MODELS } from "../A-FrameModels";
+
+
+export class A_FrameSegment extends A_Entity<A_FrameSegment_Init, A_FrameSegment_Serialized> {
+
+    static get concept(): string {
+        return 'a-frame';
+    }
+
+    protected _content!: string;
+    protected _hash!: string;
+    protected _vector?: A_FrameVector;
+    protected _embeddedAt?: string;
+    protected _model?: string;
+    protected _credentialId?: string;
+    protected _aFrameVersion?: string;
+    protected _aFrameServerVersion?: string;
+    protected _options?: Partial<A_FrameSegmentOptions>;
+
+
+    // ─── Getters ──────────────────────────────────────────────────────────────
+
+    get id(): string {
+        return this.aseid.id;
+    }
+
+    get content(): string {
+        return this._content;
+    }
+
+    get hash(): string {
+        return this._hash;
+    }
+
+    get vector(): A_FrameVector | undefined {
+        return this._vector;
+    }
+
+    get embedding(): Float32Array | null {
+        return this._vector?.values ?? null;
+    }
+
+    //-----------------------------------------------------------------------------------------------------
+    //--------------------------------------- Computed properties -----------------------------------------
+    //-----------------------------------------------------------------------------------------------------
+    get aFrameServerVersion(): string | undefined {
+        return this._aFrameServerVersion;
+    }
+
+    get aFrameVersion(): string | undefined {
+        return this._aFrameVersion;
+    }
+
+    get isEmbed(): boolean {
+        return this._vector !== undefined;
+    }
+
+    get options(): Partial<A_FrameSegmentOptions> | undefined {
+        return this._options;
+    }
+
+    /**
+     * Physical model name returned by the server after embedding.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get model(): string | undefined {
+        return this._model;
+    }
+
+    /**
+     * ISO timestamp of when the embedding was produced.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get embeddedAt(): string | undefined {
+        return this._embeddedAt;
+    }
+
+    /**
+     * ID of the server credential (API key) used during embedding.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get credentialId(): string | undefined {
+        return this._credentialId;
+    }
+
+    /**
+      * Saves Segment to storage. The actual implementation of saving is handled by the A_FrameSegmentFeatures.Save feature, which can be implemented by the environment to persist the definition to a database, file system, or other storage mechanism.
+      * 
+      * @param scope 
+      * @returns 
+      */
+    save(scope?: A_Scope): Promise<void> | void {
+        return this.call(A_FrameSegmentFeatures.Save, scope);
+    }
+    /**
+     * Deletes the namespace from storage. The actual implementation of deletion is handled by the A_FrameSegmentFeatures.Destroy feature, which can be implemented by the environment to remove the namespace from the database, file system, or other storage mechanism.
+     * 
+     * @param scope 
+     * @returns 
+     */
+    destroy(scope?: A_Scope): Promise<void> | void {
+        return this.call(A_FrameSegmentFeatures.Destroy, scope);
+    }
+    /**
+     * Loads the namespace from storage. The actual implementation of loading is handled by the A_FrameSegmentFeatures.Load feature, which can be implemented by the environment to retrieve the namespace from the database, file system, or other storage mechanism and populate the entity's properties accordingly.
+     * 
+     * @param scope 
+     * @returns 
+     */
+    async load(scope?: A_Scope): Promise<void> {
+        return this.call(A_FrameSegmentFeatures.Load, scope);
+    }
+    /**
+     * Updates the definition's properties. This can be used to modify the source code, description, metadata, or namespace of the definition. After updating, you may want to call `embed()` again to refresh the embedding based on the new content.
+     * 
+     * @param updates 
+     */
+    update(updates: Partial<Pick<A_FrameSegment, 'content'>>): void {
+        if (updates.content) this._content = updates.content;
+    }
+    /**
+     * Generates an embedding vector for the namespace using the A_FrameSegmentFeatures.Embed feature. This typically involves sending the namespace's content (name + description) to an embedding model and storing the resulting vector in the entity. Once embedded, the namespace can be searched using its vector representation.
+     * 
+     * @param scope 
+     * @returns 
+     */
+    embed(scope?: A_Scope): Promise<void> | void {
+        return this.call(A_FrameSegmentFeatures.Embed, scope);
+    }
+
+    // ─── A_Entity lifecycle ───────────────────────────────────────────────────
+
+    fromNew(init: A_FrameSegment_Init): void {
+        super.fromNew(init);
+
+        this._content = init.content;
+        this._options = { model: A_FRAME_MODELS.ANTARES, ...init.options };
+
+        const hashSource = this._content;
+
+        this._hash = A_FrameHashHelper.fnv1a(hashSource);
+    }
+
+    fromJSON(serialized: A_FrameSegment_Serialized): void {
+        this._content = serialized.content;
+        this._hash = serialized.hash;
+        this._vector = serialized.embedding ? new A_FrameVector(serialized.embedding) : undefined;
+        this._embeddedAt = serialized.embeddedAt;
+        this._model = serialized.model;
+        this._credentialId = serialized.credentialId;
+        this._aFrameVersion = serialized.aFrameVersion;
+        this._aFrameServerVersion = serialized.aFrameServerVersion;
+        if (serialized.task) {
+            this._options = { ...this._options, task: serialized.task };
+        }
+    }
+
+
+
+    toJSON(): A_FrameSegment_Serialized {
+        return {
+            ...super.toJSON(),
+            hash: this._hash,
+            content: this._content,
+            embedding: this._vector?.values,
+            embeddedAt: this._embeddedAt ?? new Date().toISOString(),
+            task: this._options?.task,
+            model: this._model,
+            credentialId: this._credentialId,
+            aFrameVersion: this._aFrameVersion,
+            aFrameServerVersion: this._aFrameServerVersion,
+        };
+    }
+
+
+    // ─── Embedding hydration ──────────────────────────────────────────────────
+
+    hydrateFromRecord(record: A_FrameSegment_Record): void {
+        if (record.hash !== this._hash) {
+            throw new Error(
+                `A_FrameSegment.hydrateFromRecord: hash mismatch for "${this._content}" ` +
+                `(expected ${this._hash}, got ${record.hash})`
+            );
+        }
+        this._vector = new A_FrameVector(record.embedding);
+        this._embeddedAt = record.embeddedAt;
+        if (record.task) {
+            this._options = { ...this._options, task: record.task };
+        }
+    }
+
+    /**
+     * Populate the embedding vector directly from a raw `Float32Array`.
+     * Use this when the vector is obtained externally (e.g. from a server
+     * response) without going through the full `embed()` feature pipeline.
+     */
+    hydrateFromEmbedding(embedding: Float32Array): void {
+        this._vector = new A_FrameVector(embedding);
+    }
+
+    /**
+     * Build the text string sent to the embedding model.
+     * Uses content so the vector captures semantic intent.
+     */
+    toString(): string {
+        const parts: string[] = [`// content: ${this._content}`];
+        return parts.join('\n');
+    }
+}
+

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

@@ -0,0 +1,91 @@
+import { A_TYPES__Entity_Serialized } from "@adaas/a-concept";
+
+
+// ─── Entity lifecycle types ───────────────────────────────────────────────────
+export type A_FrameSegmentOptions = {
+    /**
+     * model: Optional name of the embedding model to associate with this segment (e.g. "adaas-antares-v1"). If not provided, the server will attempt to infer the model based on the vector dimensions or other available metadata.
+     */
+    model: string;
+    /**
+     * Retrieval task hint for asymmetric embedding models (e.g. adaas-antares-v1).
+     * - 'query'    — text is a search query
+     * - 'document' — text is content being indexed
+     * - 'default'  — no prefix / symmetric mode
+     */
+    task: 'document' | 'query' | 'default';
+}
+
+
+export type A_FrameSegment_Init = {
+    /** Unique identifier / slug for the namespace (e.g. "math", "finance/options") */
+    content: string;
+    metadata?: Record<string, any>;
+    options?: Partial<A_FrameSegmentOptions>;
+}
+
+export type A_FrameSegment_Serialized = {
+    hash: string;
+    content: string;
+    embedding?: Float32Array;
+    embeddedAt: string;
+    /**
+     * Embedding task used when this segment was embedded.
+     * Persisted so that re-embedding after cache invalidation uses the same task.
+     */
+    task?: 'document' | 'query' | 'default';
+    // ─── Provenance ───────────────────────────────────────────────────────────
+    model?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized
+
+
+// ─── Stored record (written to __namespaces.bin) ─────────────────────────────
+
+export type A_FrameSegment_Record = {
+    /** SHA-256 hex of the namespace name — acts as stable identity key */
+    hash: string;
+    /** Segment name / slug */
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    embedding: Float32Array;
+    embeddedAt: string;
+    /** Embedding task used when this segment was embedded ('document' | 'query' | 'default'). */
+    task?: 'document' | 'query' | 'default';
+    // ─── Provenance metadata ──────────────────────────────────────────────────
+    /** Name of the embedding model used to produce the vector */
+    embeddingModel?: string;
+    /** ID of the server credential (API key) used during embedding */
+    credentialId?: string;
+    /** Version of @adaas/a-frame that produced this record */
+    aFrameVersion?: string;
+    /** Version of adaas-a-frame-mcp that produced the vector */
+    aFrameServerVersion?: string;
+}
+
+
+// ─── Embedding hydration metadata ────────────────────────────────────────────
+
+export type A_FrameSegment_EmbeddingMeta = {
+    model?: string;
+    date: string;
+    dimensions: number;
+    inputCount: number;
+    credentialId?: string | null;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+}
+
+
+// ─── Search result ────────────────────────────────────────────────────────────
+
+export type A_FrameSegment_SearchResult = {
+    name: string;
+    score: number;
+    hash: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+}

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

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

package/src/lib/A-FrameStorage/A-FrameStorage.codec.ts

@@ -60,13 +60,19 @@ export class A_FrameStorageCodec extends A_Fragment {
         return '.aframe';
     }
 
-
-    getFileName(namespace: string) {
-        return `${namespace}${A_FrameStorageCodec.fileExtension}`;
+    /** Returns the definitions file name for a given namespace id, e.g. `my-ns.definitions.aframe` */
+    getDefinitionsFileName(namespaceId: string) {
+        return `${namespaceId}.definitions${A_FrameStorageCodec.fileExtension}`;
     }
 
+    /** Returns the reserved namespaces index file name: `.namespaces.aframe` */
     getNamespaceFileName() {
-        return `__namespaces${A_FrameStorageCodec.fileExtension}`;
+        return `.namespaces${A_FrameStorageCodec.fileExtension}`;
+    }
+
+    /** Glob pattern that matches all definitions files under a directory, e.g. `*.definitions.aframe` */
+    static get definitionsFilePattern() {
+        return `*.definitions${A_FrameStorageCodec.fileExtension}`;
     }