@adaas/a-frame 0.0.21 → 0.0.23

package/dist/browser/logger.d.mts

@@ -0,0 +1,41 @@
+import { A as A_FrameLogLevelType } from './A-FrameLogger.component.env-browser-BIPAP4oQ.mjs';
+export { a as A_FrameLogEntry, b as A_FrameLogger, c as A_FrameLoggerBase, d as A_FrameLoggerConfig, e as A_FrameProgressBar, I as IA_FrameLogger } from './A-FrameLogger.component.env-browser-BIPAP4oQ.mjs';
+import '@adaas/a-concept';
+
+declare const A_FrameLogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Success: "success";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+/** Numeric priority used for level filtering. Higher = more severe. */
+declare const A_FRAME_LOG_LEVEL_PRIORITY: Record<A_FrameLogLevelType, number>;
+/** Glyphs used as the leading symbol for each log level. */
+declare const A_FrameLogIcon: Record<A_FrameLogLevelType, string>;
+/** ANSI escape sequences. Used by the Node implementation only. */
+declare const A_FRAME_ANSI: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly gray: "\u001B[90m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly cyan: "\u001B[36m";
+};
+/**
+ * Browser console CSS — used with `console.log('%c...', style)` for coloured
+ * output in DevTools. Mirrors the ANSI palette by intent.
+ */
+declare const A_FRAME_BROWSER_CSS: Record<A_FrameLogLevelType, string>;
+/** Defaults applied when building a logger without explicit options. */
+declare const A_FRAME_LOG_DEFAULTS: {
+    readonly progressBarWidth: 24;
+    readonly summaryTitle: "Summary";
+    /** Update progress at most this often (ms) for non-TTY/browser output. */
+    readonly progressThrottleMs: 250;
+};
+
+export { A_FRAME_ANSI, A_FRAME_BROWSER_CSS, A_FRAME_LOG_DEFAULTS, A_FRAME_LOG_LEVEL_PRIORITY, A_FrameLogIcon, A_FrameLogLevel, A_FrameLogLevelType };

package/dist/browser/logger.mjs

@@ -0,0 +1,2 @@
+export{d as A_FRAME_ANSI,e as A_FRAME_BROWSER_CSS,f as A_FRAME_LOG_DEFAULTS,b as A_FRAME_LOG_LEVEL_PRIORITY,c as A_FrameLogIcon,a as A_FrameLogLevel,h as A_FrameLogger,g as A_FrameLoggerBase}from'./chunk-5TTVFB3G.mjs';import'./chunk-DMGQW3AO.mjs';//# sourceMappingURL=logger.mjs.map
+//# sourceMappingURL=logger.mjs.map

package/dist/browser/logger.mjs.map

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

package/dist/browser/namespace.d.mts

@@ -0,0 +1,13 @@
+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';
+import '@adaas/a-concept';
+import './vector.mjs';
+
+declare const A_FRAME_DEFAULT_NAMESPACE_KEY = "default";
+declare const A_FrameNamespaceFeatures: {
+    readonly Load: "_A_FRAME_NAMESPACE_LOAD";
+    readonly Save: "_A_FRAME_NAMESPACE_SAVE";
+    readonly Embed: "_A_FRAME_NAMESPACE_EMBED";
+    readonly Destroy: "_A_FRAME_NAMESPACE_DESTROY";
+};
+
+export { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespaceFeatures };

package/dist/browser/namespace.mjs

@@ -0,0 +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
+//# sourceMappingURL=namespace.mjs.map

package/dist/browser/namespace.mjs.map

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

package/dist/browser/storage.d.mts

@@ -0,0 +1,194 @@
+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 './vector.mjs';
+import './A-FrameChannel.types-DWOEUs28.mjs';
+import './A-FrameBundle.types-DaaUvViw.mjs';
+
+declare class A_FrameStorageOperation<_ParamsType = any, _ResultType = any> extends A_Fragment {
+    protected _result?: _ResultType;
+    protected _error?: A_Error;
+    protected _params: _ParamsType;
+    constructor(params: _ParamsType);
+    /**
+     * If the operation succeeded, this will contain the result data. If the operation failed, this will be undefined.
+     */
+    get result(): _ResultType | undefined;
+    /**
+     * If the operation failed, this will contain an error object with details about the failure. If the operation succeeded, this will be undefined.
+     */
+    get error(): A_Error | undefined;
+    /**
+     * Parameters used to execute the operation, e.g. definitionId and namespaceId for a saveDefinition operation.
+     */
+    get params(): _ParamsType;
+    /**
+     * Marks the operation as completed successfully with the given result. This will set the `result` property and leave `error` as undefined.
+     *
+     * @param result
+     */
+    complete(result: _ResultType): void;
+    /**
+     * Marks the operation as failed with the given error. This will set the `error` property and leave `result` as undefined.
+     *
+     * @param error
+     */
+    fail(error: A_Error): void;
+}
+
+interface IA_FrameStorage {
+    saveDefinitions(definitions: Array<A_FrameDefinition_Serialized>): Promise<A_FrameStorageSaveDefinitionOperationResult>;
+    loadDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageLoadDefinitionsOperationResult>;
+    destroyDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageDestroyDefinitionsOperationResult>;
+    saveNamespaces(namespaces: A_FrameNamespace_Serialized[]): Promise<A_FrameStorageSaveNamespaceOperationResult>;
+    loadNamespaces(): Promise<A_FrameStorageLoadNamespacesOperationResult>;
+    destroyNamespaces(namespaceId: string): Promise<A_FrameStorageDestroyNamespacesOperationResult>;
+}
+type A_FrameStorageSaveDefinitionOperationParams = {
+    records: A_FrameDefinition_Serialized[];
+};
+type A_FrameStorageSaveDefinitionOperationResult = {
+    saved: number;
+};
+type A_FrameStorageLoadDefinitionsOperationParams = {
+    namespaceId: string;
+};
+type A_FrameStorageLoadDefinitionsOperationResult = {
+    records?: A_FrameDefinition_Serialized[];
+};
+type A_FrameStorageDestroyDefinitionsOperationParams = {
+    namespaceId: string;
+    definitionId: string;
+};
+type A_FrameStorageDestroyDefinitionsOperationResult = {
+    records: Array<A_FrameDefinition_Serialized>;
+};
+type A_FrameStorageSaveDefinitionOperation = A_FrameStorageOperation<A_FrameStorageSaveDefinitionOperationParams, A_FrameStorageSaveDefinitionOperationResult>;
+type A_FrameStorageLoadDefinitionsOperation = A_FrameStorageOperation<A_FrameStorageLoadDefinitionsOperationParams, A_FrameStorageLoadDefinitionsOperationResult>;
+type A_FrameStorageDestroyDefinitionsOperation = A_FrameStorageOperation<A_FrameStorageDestroyDefinitionsOperationParams, A_FrameStorageDestroyDefinitionsOperationResult>;
+type A_FrameStorageSaveNamespaceOperationParams = {
+    records: A_FrameNamespace_Serialized[];
+};
+type A_FrameStorageSaveNamespaceOperationResult = {
+    success: boolean;
+};
+type A_FrameStorageLoadNamespacesOperationParams = {
+    namespaces?: string[];
+};
+type A_FrameStorageLoadNamespacesOperationResult = {
+    records: A_FrameNamespace_Serialized[];
+};
+type A_FrameStorageDestroyNamespacesOperationParams = {
+    namespaces: string[];
+};
+type A_FrameStorageDestroyNamespacesOperationResult = {
+    success: boolean;
+};
+type A_FrameStorageSaveNamespaceOperation = A_FrameStorageOperation<A_FrameStorageSaveNamespaceOperationParams, A_FrameStorageSaveNamespaceOperationResult>;
+type A_FrameStorageLoadNamespacesOperation = A_FrameStorageOperation<A_FrameStorageLoadNamespacesOperationParams, A_FrameStorageLoadNamespacesOperationResult>;
+type A_FrameStorageDestroyNamespacesOperation = A_FrameStorageOperation<A_FrameStorageDestroyNamespacesOperationParams, A_FrameStorageDestroyNamespacesOperationResult>;
+
+declare class A_FrameStorage extends A_Component {
+    saveDefinitions(definitions: Array<A_FrameDefinition_Serialized>): Promise<A_FrameStorageSaveDefinitionOperation>;
+    loadDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageLoadDefinitionsOperation>;
+    destroyDefinitions(namespaceId: string, definitionId: string): Promise<A_FrameStorageDestroyDefinitionsOperation>;
+    saveNamespaces(namespaces: A_FrameNamespace_Serialized[]): Promise<A_FrameStorageSaveNamespaceOperation>;
+    loadNamespaces(namespaceIds: string[]): Promise<A_FrameStorageLoadNamespacesOperation>;
+    destroyNamespaces(namespacesIds: string[]): Promise<A_FrameStorageDestroyNamespacesOperation>;
+}
+
+/**
+ * A-FrameStorage binary codec — shared between node and browser environments.
+ *
+ * Binary payload format (decrypted) — used for BOTH definition records and namespace records:
+ *   [HEADER 20B]
+ *     magic    4B = 0x454D424B ("EMBK")
+ *     version  1B = 0x01
+ *     count    4B (uint32 LE)
+ *     dims     2B (uint16 LE)
+ *     reserved 9B
+ *   [RECORD × count]
+ *     aseidLen 2B  (uint16 LE)
+ *     aseid    NB  utf-8  (primary entity ID, e.g. "app@root:123@v2")
+ *     nameLen  2B  (uint16 LE)
+ *     name     NB  utf-8
+ *     vector   dims×4B  Float32 LE
+ *     metaLen  4B  (uint32 LE)
+ *     meta     NB  JSON
+ */
+
+declare class A_FrameStorageCodec extends A_Fragment {
+    protected enc: TextEncoder;
+    protected dec: TextDecoder;
+    A_FRAME_FILE_MAGIC: number;
+    A_FRAME_FILE_VERSION: number;
+    A_FRAME_HEADER_SIZE: number;
+    static get fileExtension(): string;
+    getFileName(namespace: string): string;
+    getNamespaceFileName(): string;
+    encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
+    decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
+    encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;
+    decodeNamespacePayload(data: Uint8Array): A_FrameNamespace_Serialized[];
+}
+
+declare class A_FrameStorageError extends A_Error {
+    static readonly SaveDefinitionFailed = "SaveDefinitionFailed";
+    static readonly LoadDefinitionsFailed = "LoadDefinitionsFailed";
+    static readonly DestroyDefinitionsFailed = "DestroyDefinitionsFailed";
+    static readonly SaveNamespaceFailed = "SaveNamespaceFailed";
+    static readonly LoadNamespacesFailed = "LoadNamespacesFailed";
+    static readonly DestroyNamespacesFailed = "DestroyNamespacesFailed";
+}
+
+declare const A_FrameStorageFeatures: {
+    readonly SaveDefinitions: "_A_FRAME_STORAGE_SAVE";
+    readonly LoadDefinitions: "_A_FRAME_STORAGE_LOAD";
+    readonly DestroyDefinitions: "_A_FRAME_STORAGE_DESTROY";
+    readonly SaveNamespaces: "_A_FRAME_STORAGE_SAVE_NAMESPACES";
+    readonly LoadNamespaces: "_A_FRAME_STORAGE_LOAD_NAMESPACES";
+    readonly DestroyNamespaces: "_A_FRAME_STORAGE_DESTROY_NAMESPACES";
+};
+
+/**
+ * A_FrameBrowserStorageProvider — Browser environment
+ *
+ * Stores encrypted definition and namespace records entirely in memory.
+ * Pre-built .aframe index files should be injected at bundle startup via
+ * A_FrameBrowserStorageProvider.loadBlob() so that read-only access works
+ * without any network or filesystem calls.
+ *
+ * Example (Vite):
+ *   import mathBin from './embed-index/math.aframe?arraybuffer';
+ *   A_FrameBrowserStorageProvider.loadBlob('math', new Uint8Array(mathBin));
+ */
+declare class A_FrameBrowserStorageProvider extends A_FrameStorage {
+    onLoad(scope: A_Scope, blobs?: A_FrameBrowserStorageBlobs): void;
+    saveDefinitionsToMemory(env: A_FrameEnv, operation: A_FrameStorageSaveDefinitionOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    loadDefinitionsFromMemory(env: A_FrameEnv, operation: A_FrameStorageLoadDefinitionsOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    destroyDefinitionsFromMemory(env: A_FrameEnv, operation: A_FrameStorageDestroyDefinitionsOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    saveNamespacesToMemory(env: A_FrameEnv, operation: A_FrameStorageSaveNamespaceOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    loadNamespacesFromMemory(env: A_FrameEnv, operation: A_FrameStorageLoadNamespacesOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    destroyNamespacesFromMemory(env: A_FrameEnv, operation: A_FrameStorageDestroyNamespacesOperation, global: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    /**
+     * Hydrate a single A_FrameDefinition from the in-memory bundle blobs.
+     *
+     * Mirrors the Node `loadDefinitionFromDisk` extension. Looks up the
+     * namespace's encrypted blob in the singleton blob store, decrypts and
+     * decodes it, then calls `definition.fromJSON(record)` only when the
+     * stored hash and server version match the live entity.
+     *
+     * No-op when:
+     *   - no blob has been seeded for the namespace
+     *   - decryption fails (wrong key / corrupted blob)
+     *   - the record is absent or stale
+     */
+    loadDefinitionFromBlobs(definition: A_FrameDefinition, context: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    loadNamespaceFromBlobs(namespace: A_FrameNamespace, context: A_FrameContext, codec: A_FrameStorageCodec, blobs: A_FrameBrowserStorageBlobs): Promise<void>;
+    private _loadDefinitionsFromMemory;
+    private _loadNamespacesFromMemory;
+}
+
+export { A_FrameBrowserStorageBlobs, A_FrameBrowserStorageProvider, A_FrameStorage, A_FrameStorageCodec, type A_FrameStorageDestroyDefinitionsOperation, type A_FrameStorageDestroyDefinitionsOperationParams, type A_FrameStorageDestroyDefinitionsOperationResult, type A_FrameStorageDestroyNamespacesOperation, type A_FrameStorageDestroyNamespacesOperationParams, type A_FrameStorageDestroyNamespacesOperationResult, A_FrameStorageError, A_FrameStorageFeatures, type A_FrameStorageLoadDefinitionsOperation, type A_FrameStorageLoadDefinitionsOperationParams, type A_FrameStorageLoadDefinitionsOperationResult, type A_FrameStorageLoadNamespacesOperation, type A_FrameStorageLoadNamespacesOperationParams, type A_FrameStorageLoadNamespacesOperationResult, A_FrameStorageOperation, type A_FrameStorageSaveDefinitionOperation, type A_FrameStorageSaveDefinitionOperationParams, type A_FrameStorageSaveDefinitionOperationResult, type A_FrameStorageSaveNamespaceOperation, type A_FrameStorageSaveNamespaceOperationParams, type A_FrameStorageSaveNamespaceOperationResult, type IA_FrameStorage };

package/dist/browser/storage.mjs

@@ -0,0 +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-X3C4I6YJ.mjs';import'./chunk-OFKV5GNB.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
+//# sourceMappingURL=storage.mjs.map

package/dist/browser/storage.mjs.map

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

package/dist/browser/vector.d.mts

@@ -0,0 +1,15 @@
+import { A_Entity } from '@adaas/a-concept';
+
+declare class A_FrameVector extends A_Entity {
+    static get concept(): string;
+    readonly values: Float32Array;
+    constructor(values: number[] | Float32Array);
+    get length(): number;
+    magnitude(): number;
+    normalize(): A_FrameVector;
+    dot(other: A_FrameVector): number;
+    private assertSameLength;
+    toArray(): number[];
+}
+
+export { A_FrameVector };

package/dist/browser/vector.mjs

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

package/dist/browser/vector.mjs.map

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

package/dist/node/A-FrameChannel.component-BfBcs734.d.ts

@@ -0,0 +1,62 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope, A_Component } from '@adaas/a-concept';
+import { I as IA_Frame_Channel, A as A_FrameChannelRequest, a as A_Frame_GenerateResponse, b as A_Frame_EmbedResponse, c as A_Frame_CredentialResponse } from './A-FrameChannel.types-DQF-IiRq.js';
+import { A_FrameEnv } from './env.js';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-CAUOdEvU.js';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-D3fZBGDx.js';
+import { A as A_FrameDynamicStructure, k as A_FrameDynamicStructureOperation } from './A-FrameDynamicStructure.entity-DaBgSRCR.js';
+
+type A_FrameDynamicSession_Init = {
+    turnsCount: number;
+};
+type A_FrameDynamicSession_Serialized = {
+    turnsCount: number;
+    currentTurn: number;
+    initDate: string;
+} & A_TYPES__Entity_Serialized;
+
+declare class A_FrameDynamicSession extends A_Entity<A_FrameDynamicSession_Init, A_FrameDynamicSession_Serialized> {
+    static get concept(): string;
+    /**
+     *
+     */
+    protected _scope: A_Scope;
+    protected _turnsCount: number;
+    protected _currentTurn: number;
+    protected _initDate: string;
+    /**
+     *
+     */
+    get scope(): A_Scope;
+    get currentTurn(): number;
+    get initDate(): Date;
+    static onQuestion(): void;
+    static onAnswer(): void;
+    fromNew(newEntity: A_FrameDynamicSession_Init): void;
+    fromJSON(serialized: A_FrameDynamicSession_Serialized): void;
+    init(): Promise<void>;
+    destroy(scope?: A_Scope): Promise<void>;
+    question(): Promise<void>;
+    answer(): Promise<void>;
+    toJSON(): A_FrameDynamicSession_Serialized;
+}
+
+/**
+ * A_FrameChannel — Node.js environment
+ *
+ * HTTP client for the embed-server API.
+ * Configuration is resolved from process.env via A_FrameEnv injected at
+ * feature execution time — no state is stored on the component itself.
+ *
+ * Uses the global fetch (available in Node 18+; no extra dependency needed).
+ */
+declare class A_FrameChannel extends A_Component implements IA_Frame_Channel {
+    generate(prompt: string): Promise<A_FrameChannelRequest<A_Frame_GenerateResponse>>;
+    embed(input: string | string[]): Promise<A_FrameChannelRequest<A_Frame_EmbedResponse>>;
+    getCredentials(): Promise<A_FrameChannelRequest<A_Frame_CredentialResponse>>;
+    ping(): Promise<A_FrameChannelRequest<boolean>>;
+    embedDefinition(definition: A_FrameDefinition, env: A_FrameEnv): Promise<void>;
+    embedNamespace(namespace: A_FrameNamespace, env: A_FrameEnv): Promise<void>;
+    generateDynamicStructure(structure: A_FrameDynamicStructure, session: A_FrameDynamicSession, operation: A_FrameDynamicStructureOperation): Promise<void>;
+}
+
+export { A_FrameChannel as A };

package/dist/node/A-FrameChannel.component-NNKcFViw.d.mts

@@ -0,0 +1,62 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope, A_Component } from '@adaas/a-concept';
+import { I as IA_Frame_Channel, A as A_FrameChannelRequest, a as A_Frame_GenerateResponse, b as A_Frame_EmbedResponse, c as A_Frame_CredentialResponse } from './A-FrameChannel.types-DQF-IiRq.mjs';
+import { A_FrameEnv } from './env.mjs';
+import { A as A_FrameDefinition } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
+import { A as A_FrameDynamicStructure, k as A_FrameDynamicStructureOperation } from './A-FrameDynamicStructure.entity-DaBgSRCR.mjs';
+
+type A_FrameDynamicSession_Init = {
+    turnsCount: number;
+};
+type A_FrameDynamicSession_Serialized = {
+    turnsCount: number;
+    currentTurn: number;
+    initDate: string;
+} & A_TYPES__Entity_Serialized;
+
+declare class A_FrameDynamicSession extends A_Entity<A_FrameDynamicSession_Init, A_FrameDynamicSession_Serialized> {
+    static get concept(): string;
+    /**
+     *
+     */
+    protected _scope: A_Scope;
+    protected _turnsCount: number;
+    protected _currentTurn: number;
+    protected _initDate: string;
+    /**
+     *
+     */
+    get scope(): A_Scope;
+    get currentTurn(): number;
+    get initDate(): Date;
+    static onQuestion(): void;
+    static onAnswer(): void;
+    fromNew(newEntity: A_FrameDynamicSession_Init): void;
+    fromJSON(serialized: A_FrameDynamicSession_Serialized): void;
+    init(): Promise<void>;
+    destroy(scope?: A_Scope): Promise<void>;
+    question(): Promise<void>;
+    answer(): Promise<void>;
+    toJSON(): A_FrameDynamicSession_Serialized;
+}
+
+/**
+ * A_FrameChannel — Node.js environment
+ *
+ * HTTP client for the embed-server API.
+ * Configuration is resolved from process.env via A_FrameEnv injected at
+ * feature execution time — no state is stored on the component itself.
+ *
+ * Uses the global fetch (available in Node 18+; no extra dependency needed).
+ */
+declare class A_FrameChannel extends A_Component implements IA_Frame_Channel {
+    generate(prompt: string): Promise<A_FrameChannelRequest<A_Frame_GenerateResponse>>;
+    embed(input: string | string[]): Promise<A_FrameChannelRequest<A_Frame_EmbedResponse>>;
+    getCredentials(): Promise<A_FrameChannelRequest<A_Frame_CredentialResponse>>;
+    ping(): Promise<A_FrameChannelRequest<boolean>>;
+    embedDefinition(definition: A_FrameDefinition, env: A_FrameEnv): Promise<void>;
+    embedNamespace(namespace: A_FrameNamespace, env: A_FrameEnv): Promise<void>;
+    generateDynamicStructure(structure: A_FrameDynamicStructure, session: A_FrameDynamicSession, operation: A_FrameDynamicStructureOperation): Promise<void>;
+}
+
+export { A_FrameChannel as A };

package/dist/node/A-FrameChannel.types-DQF-IiRq.d.mts

@@ -0,0 +1,146 @@
+import { A_Fragment, A_Error, A_TYPES__Error_Serialized, A_TYPES__Entity_Serialized } from '@adaas/a-concept';
+
+declare class A_FrameChannelRequest<_Response = any> extends A_Fragment {
+    method: string;
+    path: string;
+    body?: unknown;
+    protected _response?: _Response;
+    protected _error?: A_Error;
+    constructor(method: string, path: string, body?: unknown);
+    complete(response: _Response): void;
+    fail(error: A_Error): void;
+    get response(): _Response | undefined;
+    get error(): A_Error | undefined;
+}
+
+declare const A_FrameFeatures: {
+    readonly Request: "_A_FRAME_REQUEST";
+    readonly Socket: "_A_FRAME_SOCKET";
+};
+declare const A_FrameChannelStreamStatuses: {
+    readonly Open: "open";
+    readonly Closed: "closed";
+};
+declare const A_FrameChannelStreamFeatures: {
+    readonly open: "_A_FRAME_CHANNEL_STREAM_OPEN";
+    readonly send: "_A_FRAME_CHANNEL_STREAM_SEND";
+    readonly onEvent: "_A_FRAME_CHANNEL_STREAM_ON_EVENT";
+    readonly onError: "_A_FRAME_CHANNEL_STREAM_ON_ERROR";
+    readonly onComplete: "_A_FRAME_CHANNEL_STREAM_ON_COMPLETE";
+    readonly onClose: "_A_FRAME_CHANNEL_STREAM_ON_CLOSE";
+};
+declare const A_FrameChannelSocketStatuses: {
+    readonly Connecting: "connecting";
+    readonly Open: "open";
+    readonly Closed: "closed";
+};
+declare const A_FrameChannelSocketFeatures: {
+    readonly onEvent: "_A_FRAME_CHANNEL_SOCKET_ON_EVENT";
+    readonly onError: "_A_FRAME_CHANNEL_SOCKET_ON_ERROR";
+    readonly onOpen: "_A_FRAME_CHANNEL_SOCKET_ON_OPEN";
+    readonly onClose: "_A_FRAME_CHANNEL_SOCKET_ON_CLOSE";
+};
+
+interface A_Frame_EmbedResponse {
+    data: Array<{
+        embedding: number[];
+        index: number;
+    }>;
+    model: string;
+    /**
+     * Execution backend reported by the server ("local" | "remote" | …)
+     */
+    backend?: string;
+    /**
+     * ISO timestamp of when the embedding was generated, as reported by the server. Useful for cache validation and staleness checks.
+     */
+    date: string;
+    meta: {
+        dimensions: number;
+        input_count: 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;
+    };
+}
+interface A_Frame_GenerateResponse {
+    data: {
+        text: string;
+    };
+    model: string;
+    /**
+     * Execution backend reported by the server ("local" | "remote" | …)
+     */
+    backend?: string;
+    /**
+     * ISO timestamp of when the embedding was generated, as reported by the server. Useful for cache validation and staleness checks.
+     */
+    date: string;
+    meta: {
+        /** Embed-server (a-frame-mcp) package version */
+        server_version: string;
+        /** ID of the credential (API key) used for this request */
+        credential_id: string | null;
+    };
+}
+interface A_Frame_CredentialResponse {
+    /** Unique identifier for the credential */
+    id: string;
+    /** Name of the credential */
+    name: string;
+    /** Optional description of the credential */
+    description: string | null;
+    /** The encryption key in base64 format */
+    encryption_key: string;
+    /** Encryption algorithm used (e.g., "AES-256-GCM") */
+    algorithm: string;
+    /** Encoding format of the encryption key (e.g., "base64") */
+    key_encoding: string;
+    /** Usage instructions for the encryption key */
+    usage_note: string;
+    /** Version of the a-frame-mcp server */
+    server_version: string;
+}
+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>>;
+    /** Fetch credential details (incl. encryption key) for the authenticated API key */
+    getCredentials(): Promise<A_FrameChannelRequest<A_Frame_CredentialResponse>>;
+    /** Returns true if the embed server is reachable */
+    ping(): Promise<A_FrameChannelRequest<boolean>>;
+}
+type A_FrameChannelStreamStatusNames = typeof A_FrameChannelStreamStatuses[keyof typeof A_FrameChannelStreamStatuses];
+type A_FrameChannelStreamFeatureNames = typeof A_FrameChannelStreamFeatures[keyof typeof A_FrameChannelStreamFeatures];
+type A_FrameChannelStream_Init<T extends Record<string, any> = Record<string, any>> = {
+    method: string;
+    path: string;
+    body?: T;
+};
+type A_FrameChannelStream_Serialized<T extends Record<string, any> = Record<string, any>> = {
+    method: string;
+    path: string;
+    body?: T;
+    initDate: string;
+    status: A_FrameChannelStreamStatusNames;
+    error?: A_TYPES__Error_Serialized;
+} & A_TYPES__Entity_Serialized;
+type A_FrameChannelSocketStatusNames = typeof A_FrameChannelSocketStatuses[keyof typeof A_FrameChannelSocketStatuses];
+type A_FrameChannelSocketFeatureNames = typeof A_FrameChannelSocketFeatures[keyof typeof A_FrameChannelSocketFeatures];
+type A_FrameChannelSocket_Init<T extends Record<string, any> = Record<string, any>> = {
+    method: string;
+    path: string;
+    /** Optional JSON body sent as the X-A-Frame-Init header during the upgrade request. */
+    body?: T;
+};
+type A_FrameChannelSocket_Serialized<T extends Record<string, any> = Record<string, any>> = {
+    method: string;
+    path: string;
+    body?: T;
+    initDate: string;
+    status: A_FrameChannelSocketStatusNames;
+    error?: A_TYPES__Error_Serialized;
+} & A_TYPES__Entity_Serialized;
+
+export { A_FrameChannelRequest as A, type IA_Frame_Channel as I, type A_Frame_GenerateResponse as a, type A_Frame_EmbedResponse as b, type A_Frame_CredentialResponse as c, type A_FrameChannelStream_Init as d, type A_FrameChannelStream_Serialized as e, type A_FrameChannelStreamStatusNames as f, type A_FrameChannelSocketFeatureNames as g, A_FrameChannelSocketFeatures as h, type A_FrameChannelSocketStatusNames as i, A_FrameChannelSocketStatuses as j, type A_FrameChannelSocket_Init as k, type A_FrameChannelSocket_Serialized as l, type A_FrameChannelStreamFeatureNames as m, A_FrameChannelStreamFeatures as n, A_FrameChannelStreamStatuses as o, A_FrameFeatures as p };