@adaas/a-frame 0.1.1 → 0.1.2

package/dist/browser/A-FrameSegment.entity-D1xjjWvG.d.mts

@@ -0,0 +1,161 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope } from '@adaas/a-concept';
+import { A_FrameVector } from './vector.mjs';
+
+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';
+};
+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>;
+};
+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';
+    model?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized;
+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';
+    /** 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;
+};
+type A_FrameSegment_EmbeddingMeta = {
+    model?: string;
+    date: string;
+    dimensions: number;
+    inputCount: number;
+    credentialId?: string | null;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+};
+type A_FrameSegment_SearchResult = {
+    name: string;
+    score: number;
+    hash: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+};
+
+declare class A_FrameSegment extends A_Entity<A_FrameSegment_Init, A_FrameSegment_Serialized> {
+    static get concept(): string;
+    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>;
+    get id(): string;
+    get content(): string;
+    get hash(): string;
+    get vector(): A_FrameVector | undefined;
+    get embedding(): Float32Array | null;
+    get aFrameServerVersion(): string | undefined;
+    get aFrameVersion(): string | undefined;
+    get isEmbed(): boolean;
+    get options(): Partial<A_FrameSegmentOptions> | undefined;
+    /**
+     * Physical model name returned by the server after embedding.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get model(): string | undefined;
+    /**
+     * ISO timestamp of when the embedding was produced.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get embeddedAt(): string | undefined;
+    /**
+     * ID of the server credential (API key) used during embedding.
+     * `undefined` until `embed()` has been called successfully.
+     */
+    get credentialId(): string | undefined;
+    /**
+      * 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;
+    /**
+     * 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;
+    /**
+     * 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
+     */
+    load(scope?: A_Scope): Promise<void>;
+    /**
+     * 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;
+    /**
+     * 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;
+    fromNew(init: A_FrameSegment_Init): void;
+    fromJSON(serialized: A_FrameSegment_Serialized): void;
+    toJSON(): A_FrameSegment_Serialized;
+    hydrateFromRecord(record: A_FrameSegment_Record): void;
+    /**
+     * 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;
+    /**
+     * Build the text string sent to the embedding model.
+     * Uses content so the vector captures semantic intent.
+     */
+    toString(): string;
+}
+
+export { A_FrameSegment as A, type A_FrameSegmentOptions as a, type A_FrameSegment_EmbeddingMeta as b, type A_FrameSegment_Init as c, type A_FrameSegment_Record as d, type A_FrameSegment_SearchResult as e, type A_FrameSegment_Serialized as f };

package/dist/browser/A-FrameSegment.entity-D7Aj39Wh.d.mts

@@ -0,0 +1,146 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope } from '@adaas/a-concept';
+import { A_FrameVector } from './vector.mjs';
+
+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';
+};
+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>;
+};
+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';
+    model?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized;
+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';
+    /** 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;
+};
+type A_FrameSegment_EmbeddingMeta = {
+    model?: string;
+    date: string;
+    dimensions: number;
+    inputCount: number;
+    credentialId?: string | null;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+};
+type A_FrameSegment_SearchResult = {
+    name: string;
+    score: number;
+    hash: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+};
+
+declare class A_FrameSegment extends A_Entity<A_FrameSegment_Init, A_FrameSegment_Serialized> {
+    static get concept(): string;
+    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>;
+    get id(): string;
+    get content(): string;
+    get hash(): string;
+    get vector(): A_FrameVector | undefined;
+    get embedding(): Float32Array | null;
+    get aFrameServerVersion(): string | undefined;
+    get aFrameVersion(): string | undefined;
+    get isEmbed(): boolean;
+    get options(): Partial<A_FrameSegmentOptions> | undefined;
+    /**
+      * 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;
+    /**
+     * 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;
+    /**
+     * 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
+     */
+    load(scope?: A_Scope): Promise<void>;
+    /**
+     * 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;
+    /**
+     * 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;
+    fromNew(init: A_FrameSegment_Init): void;
+    fromJSON(serialized: A_FrameSegment_Serialized): void;
+    toJSON(): A_FrameSegment_Serialized;
+    hydrateFromRecord(record: A_FrameSegment_Record): void;
+    /**
+     * 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;
+    /**
+     * Build the text string sent to the embedding model.
+     * Uses content so the vector captures semantic intent.
+     */
+    toString(): string;
+}
+
+export { A_FrameSegment as A, type A_FrameSegmentOptions as a, type A_FrameSegment_EmbeddingMeta as b, type A_FrameSegment_Init as c, type A_FrameSegment_Record as d, type A_FrameSegment_SearchResult as e, type A_FrameSegment_Serialized as f };

package/dist/browser/bundle.d.mts

@@ -1,7 +1,11 @@
-export { A as A_FrameBundle } from './A-FrameBundle.types-DaaUvViw.mjs';
+export { A as A_FrameBundle, a as A_FrameBundleDefinitionRecord, b as A_FrameBundleNamespaceRecord } from './A-FrameBundle.types-LzfgdMiQ.mjs';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import '@adaas/a-concept';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
+import './vector.mjs';
 
 /** Current bundle format revision. Bumped on incompatible structural changes. */
-declare const A_FRAME_BUNDLE_VERSION = 1;
+declare const A_FRAME_BUNDLE_VERSION = 2;
 /** Default file name when none is provided to the CLI. */
 declare const A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
 

package/dist/browser/bundle.mjs

@@ -1,2 +1,2 @@
-import'./chunk-DMGQW3AO.mjs';var E=1,_="a-frame-bundle.json";export{_ as A_FRAME_BUNDLE_DEFAULT_FILENAME,E as A_FRAME_BUNDLE_VERSION};//# sourceMappingURL=bundle.mjs.map
+import'./chunk-DMGQW3AO.mjs';var e=2,_="a-frame-bundle.json";export{_ as A_FRAME_BUNDLE_DEFAULT_FILENAME,e as A_FRAME_BUNDLE_VERSION};//# sourceMappingURL=bundle.mjs.map
 //# sourceMappingURL=bundle.mjs.map

package/dist/browser/bundle.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts"],"names":["A_FRAME_BUNDLE_VERSION","A_FRAME_BUNDLE_DEFAULT_FILENAME"],"mappings":"6BACO,IAAMA,CAAAA,CAAyB,EAGzBC,CAAAA,CAAkC","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"]}
+{"version":3,"sources":["../../src/lib/A-FrameBundle/A-FrameBundle.constants.ts"],"names":["A_FRAME_BUNDLE_VERSION","A_FRAME_BUNDLE_DEFAULT_FILENAME"],"mappings":"6BACO,IAAMA,CAAAA,CAAyB,EAGzBC,CAAAA,CAAkC","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"]}

package/dist/browser/channel.d.mts

@@ -1,76 +1,17 @@
-import { I as IA_Frame_Channel, A as A_FrameChannelRequest, b as A_Frame_GenerateResponse, c as A_Frame_EmbedResponse, a as A_Frame_CredentialResponse, d as A_FrameChannelSocket_Init, e as A_FrameChannelSocket_Serialized, f as A_FrameChannelSocketStatusNames } from './A-FrameChannel.types-DWOEUs28.mjs';
-export { g as A_FrameChannelSocketFeatureNames, h as A_FrameChannelStreamFeatureNames, i as A_FrameChannelStreamStatusNames, j as A_FrameChannelStream_Init, k as A_FrameChannelStream_Serialized } from './A-FrameChannel.types-DWOEUs28.mjs';
-import { I as IA_FrameEnv, A as A_FrameEnv$1 } from './index.browser-CZlhzfSP.mjs';
-import { A_Fragment, A_TYPES__Entity_Serialized, A_Entity, A_Scope, A_Component, A_Error } from '@adaas/a-concept';
-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';
+import { A as A_FrameChannelRequest, b as A_FrameChannelSocket_Init, c as A_FrameChannelSocket_Serialized, d as A_FrameChannelSocketStatusNames, e as A_FrameChannelStream_Init, f as A_FrameChannelStream_Serialized, g as A_FrameChannelStreamStatusNames } from './A-FrameChannel.types-BXEKJK9t.mjs';
+export { h as A_FrameChannelSocketFeatureNames, i as A_FrameChannelSocketFeatures, j as A_FrameChannelSocketStatuses, k as A_FrameChannelStreamFeatureNames, l as A_FrameChannelStreamFeatures, m as A_FrameChannelStreamStatuses, n as A_FrameEmbedOptions, o as A_FrameEmbeddingTask, p as A_FrameFeatures, q as A_Frame_CompletionResponse, a 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-BXEKJK9t.mjs';
+import { A_FrameEnv } from './env.mjs';
+import { e as A_FrameChannel } from './A-FrameChannel.component-4mTNctXL.mjs';
+import { A_Fragment, A_Entity, A_Scope, A_Error } from '@adaas/a-concept';
+import './A-FrameDefinition.types-BT02yAhQ.mjs';
+import './A-FrameNamespace.entity-BDg1FUgo.mjs';
 import './vector.mjs';
-
-declare class A_FrameEnv extends A_Fragment implements IA_FrameEnv {
-    get A_FRAME_FILE_EXTENSION(): string;
-    get A_FRAME_NAMESPACES_BIN(): string;
-    get A_FRAME_SYNC(): boolean;
-    get A_FRAME_TOKEN(): string;
-    get A_FRAME_SERVER_URL(): string;
-    get A_FRAME_SERVER_API_KEY(): string;
-    get A_FRAME_STORAGE_DIR(): string;
-    get A_FRAME_VERSION(): string;
-}
-
-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>;
-}
+import './A-FrameEnv.types-DnK-CYVk.mjs';
+import './A-FrameDefinition.entity-yA0GsBoe.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';
 
 /**
  * A_FrameChannel — Browser environment
@@ -83,7 +24,7 @@ declare class A_FrameChannel extends A_Component implements IA_Frame_Channel {
  * via A_FrameStorage.loadBlob() — no embedding calls are needed at runtime.
  */
 declare class A_FrameBrowserChannel extends A_FrameChannel {
-    request(context: A_FrameChannelRequest, env: A_FrameEnv$1): Promise<void>;
+    request(context: A_FrameChannelRequest, env: A_FrameEnv): Promise<void>;
 }
 
 declare class A_FrameChannelEvent<T extends Record<string, any> = any> extends A_Fragment {
@@ -162,4 +103,40 @@ declare class A_FrameChannelSocket<T extends Record<string, any> = Record<string
     toJSON(): A_FrameChannelSocket_Serialized<T>;
 }
 
-export { A_FrameBrowserChannel, A_FrameChannelSocket, A_FrameChannelSocketStatusNames, A_FrameChannelSocket_Init, A_FrameChannelSocket_Serialized, A_Frame_CredentialResponse, A_Frame_EmbedResponse, A_Frame_GenerateResponse, IA_Frame_Channel };
+declare class A_FrameChannelError extends A_Error {
+    static readonly InvalidRequest = "InvalidRequest";
+    static readonly Timeout = "Timeout";
+    static readonly RequestFailed = "RequestFailed";
+}
+
+declare class A_FrameChannelStream<T extends Record<string, any> = Record<string, any>> extends A_Entity<A_FrameChannelStream_Init<T>, A_FrameChannelStream_Serialized<T>> {
+    static onEvent(name?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => any;
+    protected _method: string;
+    protected _path: string;
+    protected _body?: T;
+    protected _scope: A_Scope;
+    protected _error?: A_Error;
+    protected _status: A_FrameChannelStreamStatusNames;
+    protected _initDate: string;
+    /**
+     * The scope of the session, Will be destroyed after the session is closed.
+     */
+    get scope(): A_Scope;
+    get method(): string;
+    get path(): string;
+    get body(): T | undefined;
+    get status(): A_FrameChannelStreamStatusNames;
+    get error(): A_Error | undefined;
+    get initDate(): Date;
+    complete(): void;
+    fail(error: A_Error): void;
+    destroy(): Promise<void> | void;
+    open(): Promise<void>;
+    send(): Promise<void>;
+    propagate<T extends Record<string, any>>(name: string, data?: T): Promise<void>;
+    fromNew(newEntity: A_FrameChannelStream_Init<T>): void;
+    fromJSON(serialized: A_FrameChannelStream_Serialized<T>): void;
+    toJSON(): A_FrameChannelStream_Serialized<T>;
+}
+
+export { A_FrameBrowserChannel, A_FrameChannelError, A_FrameChannelEvent, A_FrameChannelRequest, A_FrameChannelSocket, A_FrameChannelSocketStatusNames, A_FrameChannelSocket_Init, A_FrameChannelSocket_Serialized, A_FrameChannelStream, A_FrameChannelStreamStatusNames, A_FrameChannelStream_Init, A_FrameChannelStream_Serialized };

package/dist/browser/channel.mjs

@@ -1,3 +1,2 @@
-import {b as b$3,a as a$2}from'./chunk-YQJFTBGV.mjs';import'./chunk-K4MZY4ME.mjs';import {c,b as b$2}from'./chunk-AYN7KUQT.mjs';import {b,a as a$1}from'./chunk-ZVCTU2DN.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-VDVJWU5T.mjs';import {a,b as b$1}from'./chunk-DMGQW3AO.mjs';import {A_Feature,A_Inject,A_Caller,A_Error,A_Fragment,A_Component,A_Scope,A_Context,A_Entity}from'@adaas/a-concept';var m={Request:"_A_FRAME_REQUEST",Socket:"_A_FRAME_SOCKET"};var A={Connecting:"connecting",Open:"open",Closed:"closed"},f={onEvent:"_A_FRAME_CHANNEL_SOCKET_ON_EVENT",onError:"_A_FRAME_CHANNEL_SOCKET_ON_ERROR",onOpen:"_A_FRAME_CHANNEL_SOCKET_ON_OPEN",onClose:"_A_FRAME_CHANNEL_SOCKET_ON_CLOSE"};var i=class extends A_Fragment{constructor(e,s,a){super({name:"a-frame-channel-request"});this.method=e;this.path=s;this.body=a;}complete(e){this._response=e;}fail(e){this._error=e;}get response(){return this._response}get error(){return this._error}};var n=class extends A_Error{};n.InvalidRequest="InvalidRequest",n.Timeout="Timeout",n.RequestFailed="RequestFailed";var E=class extends A_Fragment{get A_FRAME_FILE_EXTENSION(){return ".aframe"}get A_FRAME_NAMESPACES_BIN(){return `__namespaces${this.A_FRAME_FILE_EXTENSION}`}get A_FRAME_SYNC(){return process.env.A_FRAME_SYNC!=="false"}get A_FRAME_TOKEN(){return process.env.A_FRAME_TOKEN||""}get A_FRAME_SERVER_URL(){return process.env.A_FRAME_SERVER_URL||"http://localhost:3663"}get A_FRAME_SERVER_API_KEY(){return process.env.A_FRAME_SERVER_API_KEY||""}get A_FRAME_STORAGE_DIR(){return process.env.A_FRAME_STORAGE_DIR||".aframestr"}get A_FRAME_VERSION(){return a$2||"0.0.1"}};var F={Init:"_A_FRAME_DYNAMIC_SESSION_INIT",Question:"_A_FRAME_DYNAMIC_SESSION_QUESTION",Answer:"_A_FRAME_DYNAMIC_SESSION_ANSWER",Destroy:"_A_FRAME_DYNAMIC_SESSION_DESTROY"};var S=class extends A_Entity{static get concept(){return "a-frame"}get scope(){return this._scope||(this._scope=A_Context.allocate(this,new A_Scope({name:`${this.aseid.id}-scope`}))),this._scope}get currentTurn(){return this._currentTurn}get initDate(){return new Date(this._initDate)}static onQuestion(){}static onAnswer(){}fromNew(t){this._turnsCount=t.turnsCount||5,this._currentTurn=0,this._initDate=new Date().toISOString();}fromJSON(t){this._turnsCount=t.turnsCount,this._currentTurn=t.currentTurn,this._initDate=t.initDate;}async init(){await this.call(F.Init);}async destroy(t){await this.call(F.Destroy,t);}async question(){this._currentTurn++,await this.call(F.Question);}async answer(){await this.call(F.Answer);}toJSON(){return {...super.toJSON(),turnsCount:this._turnsCount,currentTurn:this._currentTurn,initDate:this._initDate}}};var R=class extends A_Fragment{constructor(e={}){super({name:"a-frame-dynamic-structure-operation-context"});this._meta=new Map;this._meta.set("params",e);}get params(){return this._meta.get("params")}get(e){return this._meta.get(e)}set(e,s){this._meta.set(e,s);}};var d=class extends A_Component{async generate(t){let e=new i("POST","/api/completions",{prompt:t,max_tokens:512}),s=new A_Scope({name:"A_FrameChannel.generate",fragments:[e]}).inherit(A_Context.scope(this));try{return await this.call(m.Request,s),s.destroy(),e}catch(a){throw s.destroy(),new n({title:n.RequestFailed,description:`Failed to generate completion: ${a instanceof Error?a.message:String(a)}`})}}async embed(t){let e=new i("POST","/api/embeddings",{input:t}),s=new A_Scope({name:"A_FrameChannel.embed",fragments:[e]}).inherit(A_Context.scope(this));try{return await this.call(m.Request,s),s.destroy(),e}catch(a){throw s.destroy(),new n({title:n.RequestFailed,description:`Failed to embed input: ${a instanceof Error?a.message:String(a)}`})}}async getCredentials(){let t=new i("GET","/api/credentials/me"),e=new A_Scope({name:"A_FrameChannel.getCredentials",fragments:[t]}).inherit(A_Context.scope(this));try{return await this.call(m.Request,e),e.destroy(),t}catch(s){throw e.destroy(),new n({title:n.RequestFailed,description:`Failed to get credentials: ${s instanceof Error?s.message:String(s)}`})}}async ping(){let t=new i("GET","/health"),e=new A_Scope({name:"A_FrameChannel.ping",fragments:[t]}).inherit(A_Context.scope(this));try{return await this.call(m.Request,e),e.destroy(),t}catch{return e.destroy(),t}}async embedDefinition(t,e){let s=new i("POST","/api/v1/definition/embed",{definition:t.toJSON()}),a=new A_Scope({name:"A_FrameChannel.embedDefinition",fragments:[s]}).inherit(A_Context.scope(this));try{await this.call(m.Request,a),a.destroy();let r=s.response;if(!r.data||!r.data[0]||!r.data[0].embedding)throw new n({title:n.InvalidRequest,description:`Invalid embedding response for definition "${t.name}"`});let _=new Float32Array(r.data[0].embedding);t.hydrateFromEmbedding(_,{model:r.model,dimensions:r.meta.dimensions,inputCount:r.meta.input_count,aFrameServerVersion:r.meta.server_version,aFrameVersion:e.A_FRAME_VERSION,credentialId:r.meta.credential_id,date:r.date});}catch(r){throw new n({title:n.RequestFailed,description:`Failed to embed definition "${t.name}": ${r instanceof Error?r.message:String(r)}`})}}async embedNamespace(t,e){let s=new i("POST","/api/v1/namespace/embed",{namespace:t.toJSON()}),a=new A_Scope({name:"A_FrameChannel.embedNamespace",fragments:[s]}).inherit(A_Context.scope(this));try{await this.call(m.Request,a),a.destroy();let r=s.response;if(!r.data||!r.data[0]||!r.data[0].embedding)throw new n({title:n.InvalidRequest,description:`Invalid embedding response for namespace "${t.name}"`});let _=new Float32Array(r.data[0].embedding);t.hydrateFromEmbedding(_,{model:r.model,dimensions:r.meta.dimensions,inputCount:r.meta.input_count,aFrameServerVersion:r.meta.server_version,aFrameVersion:e.A_FRAME_VERSION,credentialId:r.meta.credential_id,date:r.date});}catch(r){throw new n({title:n.RequestFailed,description:`Failed to embed namespace "${t.name}": ${r instanceof Error?r.message:String(r)}`})}}async generateDynamicStructure(t,e,s){}};a([A_Feature.Extend({name:a$1.Embed,scope:[b]}),b$1(0,A_Inject(A_Caller)),b$1(1,A_Inject(E))],d.prototype,"embedDefinition",1),a([A_Feature.Extend({name:b$2.Embed,scope:[c]}),b$1(0,A_Inject(A_Caller)),b$1(1,A_Inject(E))],d.prototype,"embedNamespace",1),a([b$1(0,A_Inject(A_Caller)),b$1(1,A_Inject(S)),b$1(2,A_Inject(R))],d.prototype,"generateDynamicStructure",1);var C=class extends d{async request(t,e){let s=`${e.A_FRAME_SERVER_URL}${t.path}`,a=new AbortController,r=setTimeout(()=>{a.abort(),t.fail(new n({title:n.Timeout,description:`Request to ${t.path} timed out after 15 seconds`}));},15e3);try{let _=await fetch(s,{method:t.method,headers:{"Content-Type":"application/json",Authorization:`Bearer ${e.A_FRAME_SERVER_API_KEY}`},body:t.body!==void 0?JSON.stringify(t.body):void 0,signal:a.signal});t.complete(await _.json());}catch{t.fail(new n({title:n.RequestFailed,description:`Request to ${t.path} failed or timed out`}));}finally{clearTimeout(r);}}};a([A_Feature.Extend({name:m.Request,scope:[d]}),b$1(0,A_Inject(i)),b$1(1,A_Inject(b$3))],C.prototype,"request",1);var g=class extends A_Fragment{constructor(t,e){super({name:"a-frame-channel-event-"+t}),this._data=e,this._eventName=t;}get name(){return this._eventName}get data(){return this._data}};var N=class extends A_Entity{constructor(){super(...arguments);this._sendFn=null;}static onEvent(e){let s=(e||"all")+f.onEvent;return (a,r,_)=>A_Feature.Extend({name:s,scope:[a.constructor]})(a,r,_)}get scope(){return this._scope||(this._scope=A_Context.allocate(this,new A_Scope({name:`${this.aseid.id}-scope`}))),this._scope}get method(){return this._method}get path(){return this._path}get body(){return this._body}get status(){return this._status}get error(){return this._error}get initDate(){return new Date(this._initDate)}attachSendFn(e){this._sendFn=e,this._status=A.Open;}send(e){if(!this._sendFn||this._status!==A.Open)throw new n({title:n.InvalidRequest,description:`Cannot send event "${e.name}": WebSocket is not open (status: ${this._status})`});this._sendFn(JSON.stringify({type:e.name,data:e.data}));}complete(){this._sendFn=null,this._status=A.Closed;}fail(e){this._sendFn=null,this._status=A.Closed,this._error=e;}destroy(){this.scope.destroy();}async propagate(e,s){let a=new g(e,s),r=new A_Scope({name:"A_FrameChannelSocket.propagate",fragments:[a]}).inherit(A_Context.scope(this));try{let _=(e||"all")+f.onEvent;await this.call(_,r),r.destroy();}catch{r.destroy();}}fromNew(e){this._method=e.method,this._path=e.path,this._body=e.body,this._status=A.Connecting,this._initDate=new Date().toISOString();}fromJSON(e){this._method=e.method,this._path=e.path,this._body=e.body,this._status=e.status,this._initDate=e.initDate;}toJSON(){return {...super.toJSON(),initDate:this._initDate,status:this._status,error:this._error?this._error.toJSON():void 0,method:this._method,path:this._path,body:this._body}}};
-export{C as A_FrameBrowserChannel,N as A_FrameChannelSocket};//# sourceMappingURL=channel.mjs.map
+export{a as A_FrameBrowserChannel}from'./chunk-KFMVTZ7T.mjs';import'./chunk-RWQSCROK.mjs';import {e,d,g as g$1,c as c$1,b}from'./chunk-XR7FVA5M.mjs';export{g as A_FrameChannelError,f as A_FrameChannelRequest,e as A_FrameChannelSocketFeatures,d as A_FrameChannelSocketStatuses,c as A_FrameChannelStreamFeatures,b as A_FrameChannelStreamStatuses,a as A_FrameFeatures}from'./chunk-XR7FVA5M.mjs';import'./chunk-2RNFZSBL.mjs';import'./chunk-UULJJ5C5.mjs';import'./chunk-6WAOMX7M.mjs';import'./chunk-K4MZY4ME.mjs';import'./chunk-CT67Y46H.mjs';import'./chunk-6NPQURSO.mjs';import'./chunk-TQPC5MYM.mjs';import'./chunk-BIBPE2GT.mjs';import'./chunk-H6OZP4ZV.mjs';import'./chunk-WXCQCHAX.mjs';import'./chunk-46LRNZRG.mjs';import'./chunk-G7MKGKG5.mjs';import'./chunk-DMGQW3AO.mjs';import {A_Fragment,A_Entity,A_Feature,A_Context,A_Scope}from'@adaas/a-concept';var a=class extends A_Fragment{constructor(e,t){super({name:"a-frame-channel-event-"+e}),this._data=t,this._eventName=e;}get name(){return this._eventName}get data(){return this._data}};var c=class extends A_Entity{constructor(){super(...arguments);this._sendFn=null;}static onEvent(t){let s=(t||"all")+e.onEvent;return (r,n,h)=>A_Feature.Extend({name:s,scope:[r.constructor]})(r,n,h)}get scope(){return this._scope||(this._scope=A_Context.allocate(this,new A_Scope({name:`${this.aseid.id}-scope`}))),this._scope}get method(){return this._method}get path(){return this._path}get body(){return this._body}get status(){return this._status}get error(){return this._error}get initDate(){return new Date(this._initDate)}attachSendFn(t){this._sendFn=t,this._status=d.Open;}send(t){if(!this._sendFn||this._status!==d.Open)throw new g$1({title:g$1.InvalidRequest,description:`Cannot send event "${t.name}": WebSocket is not open (status: ${this._status})`});this._sendFn(JSON.stringify({type:t.name,data:t.data}));}complete(){this._sendFn=null,this._status=d.Closed;}fail(t){this._sendFn=null,this._status=d.Closed,this._error=t;}destroy(){this.scope.destroy();}async propagate(t,s){let r=new a(t,s),n=new A_Scope({name:"A_FrameChannelSocket.propagate",fragments:[r]}).inherit(A_Context.scope(this));try{let h=(t||"all")+e.onEvent;await this.call(h,n),n.destroy();}catch{n.destroy();}}fromNew(t){this._method=t.method,this._path=t.path,this._body=t.body,this._status=d.Connecting,this._initDate=new Date().toISOString();}fromJSON(t){this._method=t.method,this._path=t.path,this._body=t.body,this._status=t.status,this._initDate=t.initDate;}toJSON(){return {...super.toJSON(),initDate:this._initDate,status:this._status,error:this._error?this._error.toJSON():void 0,method:this._method,path:this._path,body:this._body}}};var g=class extends A_Entity{static onEvent(e){let t=(e||"all")+c$1.onEvent;return (s,r,n)=>A_Feature.Extend({name:t,scope:[s.constructor]})(s,r,n)}get scope(){return this._scope||(this._scope=A_Context.allocate(this,new A_Scope({name:`${this.aseid.id}-scope`}))),this._scope}get method(){return this._method}get path(){return this._path}get body(){return this._body}get status(){return this._status}get error(){return this._error}get initDate(){return new Date(this._initDate)}complete(){this._status=b.Closed;}fail(e){this._status=b.Closed,this._error=e;}destroy(){this.scope.destroy();}async open(){await this.call(c$1.open);}async send(){await this.call(c$1.send);}async propagate(e,t){let s=new a(e,t),r=new A_Scope({name:"A_FrameChannelStream.propagate",fragments:[s]}).inherit(this.scope);try{let n=(e||"all")+c$1.onEvent;await this.call(n,r),r.destroy();}catch{r.destroy();}}fromNew(e){this.aseid=this.generateASEID(),this._method=e.method,this._path=e.path,this._body=e.body,this._initDate=new Date().toISOString();}fromJSON(e){this._method=e.method,this._path=e.path,this._body=e.body,this._initDate=e.initDate;}toJSON(){return {...super.toJSON(),initDate:this._initDate,status:this._status,error:this._error?this._error.toJSON():void 0,method:this._method,path:this._path,body:this._body}}};export{a as A_FrameChannelEvent,c as A_FrameChannelSocket,g as A_FrameChannelStream};//# sourceMappingURL=channel.mjs.map
 //# sourceMappingURL=channel.mjs.map