@adaas/a-frame 0.0.22 → 0.1.1

package/dist/browser/A-FrameDynamicStructure.entity-DaBgSRCR.d.mts

@@ -0,0 +1,188 @@
+import { A_TYPES__Entity_Serialized, A_Fragment, A_TYPES__Ctor, A_Component, A_Container, A_Entity } from '@adaas/a-concept';
+
+type A_FrameDynamicPatch_Init = {
+    version: number;
+    timestamp: number;
+    reason: string;
+    encoded: string;
+    delta: number;
+};
+type A_FrameDynamicPatch_Serialized = {
+    version: number;
+    timestamp: number;
+    reason: string;
+    encoded: string;
+    delta: number;
+} & A_TYPES__Entity_Serialized;
+
+declare const A_FrameDynamicStructureFeatures: {
+    readonly Load: "_A_FRAME_DYNAMIC_STRUCTURE_LOAD";
+    readonly Update: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATE";
+    readonly Generate: "_A_FRAME_DYNAMIC_STRUCTURE_GENERATE";
+};
+declare const A_FrameDynamicStructureEvents: {
+    readonly Updated: "_A_FRAME_DYNAMIC_STRUCTURE_UPDATED";
+};
+
+declare class A_FrameDynamicStructureOperation<_InputParams = any> extends A_Fragment {
+    protected _meta: Map<string, any>;
+    constructor(params?: _InputParams);
+    get params(): _InputParams;
+    get(key: string): any;
+    set(key: string, value: any): void;
+}
+
+type DynamicStructureDefaultBasesNames = 'A_Component' | 'A_Container' | 'A_Fragment';
+type BaseClassName = DynamicStructureDefaultBasesNames | A_TYPES__Ctor<A_Component | A_Fragment | A_Container>;
+type A_FrameDynamicStructure_Init = {
+    /** The goal / initial prompt driving structure generation */
+    prompt: string;
+    /** Which model to use for content generation */
+    model: string;
+    /** Only include components whose base class is in this list (empty = allow all) */
+    includeBases?: Array<BaseClassName | A_TYPES__Ctor<A_Component | A_Fragment | A_Container>>;
+    /** Exclude components whose base class is in this list */
+    excludeBases?: Array<string | A_TYPES__Ctor<A_Component | A_Fragment | A_Container>>;
+    /** Explicit list of component names to enable (subset of registry) */
+    enabledComponents?: Array<string | A_TYPES__Ctor<A_Component | A_Fragment | A_Container>>;
+    /** Rendering context hint passed to content generator */
+    context?: string;
+    /** Free-form hint about required prop types (forwarded to content generator) */
+    metaHint?: string;
+};
+type A_FrameDynamicStructure_Serialized = {
+    name: string;
+    description?: string;
+    metadata?: Record<string, any>;
+    history: Array<A_FrameDynamicPatch_Serialized>;
+} & A_TYPES__Entity_Serialized;
+type A_FrameDynamicStructureListener = (context: A_FrameDynamicStructureOperation) => void;
+type A_FrameDynamicStructureResolvedComponent<P extends Record<string, any> = Record<string, any>> = {
+    component: string;
+    score: number;
+    meta: P;
+};
+type A_FrameDynamicStructureFeatureNames = typeof A_FrameDynamicStructureFeatures[keyof typeof A_FrameDynamicStructureFeatures];
+type A_FrameDynamicStructureEventNames = typeof A_FrameDynamicStructureEvents[keyof typeof A_FrameDynamicStructureEvents];
+type A_FrameDynamicStructureDefinitionEntity = {
+    /**
+     * The prompt is the text that describes the element (component, container, fragment or entity) that is needed in the structure based on input prompt
+     *
+     *
+     * e.g. "A component that allows to search for something", "A container that runs a web server", "A fragment that stores user settings", "An entity that represents a user session", etc.
+     *
+     * [!] Note, prompt should also contain the name of the element if it's possible, to make it easier to understand and use in the structure generation.
+     */
+    prompt: string;
+    /**
+     * The string set of params that is necessary to the particular element (component, container, fragment or entity) that is needed in the structure based on input prompt.
+     * Those parameters should be presented in the string manner and then mapped to the actual params in the structure generation process, to make it easier to understand and use in the structure generation.
+     *
+     * e.g. "props: {query: string, resultsCount: number}", "constructorParams: {port: number}", "state: {isLoggedIn: boolean}", "ASEID", etc. or simply text: "Stores user with id=12345 and name=John Doe" if it's hard to define the params in a structured way.
+     *
+     * [!] Params are applicable only for stateful components like Fragment, or Entity. Since components are stateless they can only rely on params in their methods received by @A_Inject(SomeFragment) someFragment: SomeFragment, where SomeFragment has state defined by params. And also for containers, since they can have constructor params and also rely on params of their components and fragments.
+     *
+     *
+     */
+    params?: string;
+};
+type A_FrameDynamicStructureDefinition = {
+    /**
+     * A set of containers that the structure is needed based on input prompt
+     *
+     * Where container is an instance of inherited class from A_Container that should be running independently and may have own components, fragments and entities.
+     *
+     * e.g. HTTPServerContainer, WebWorker, AppContainer, etc.
+     *
+     * [!] Note: should be presented only if initial query allows to have a container, and should be included only if necessary.
+     *
+     */
+    containers: Array<A_FrameDynamicStructureDefinitionEntity & {
+        components: Array<A_FrameDynamicStructureDefinitionEntity>;
+        fragments: Array<A_FrameDynamicStructureDefinitionEntity>;
+        entities: Array<A_FrameDynamicStructureDefinitionEntity>;
+    }>;
+    /**
+     * A set of components that the structure is needed based on input prompt
+     *
+     * Where Component is a constructor class from A_Component that allows to define something that is stateless, has methods and features and can be injected as a dependency in other components, fragments or containers.
+     *
+     * e.g. SearchComponent, SettingsComponent, ButtonComponent, SectionComponent, etc.
+     *
+     * [!] Note: should be presented only if initial query allows to have a component, and should be included only if necessary.
+     */
+    components: Array<A_FrameDynamicStructureDefinitionEntity>;
+    /**
+     * A set of Context Fragments that the structure is needed based on input prompt
+     *
+     * Where Fragment is an instance of inherited class from A_Fragment that allows to define something that has state and can be injected as a dependency in other components, fragments or containers.
+     *
+     * e.g.  Settings, State, Store, etc.
+     *
+     * [!] Note: should be presented only if initial query allows to have a fragment, and should be included only if necessary.
+     */
+    fragments: Array<A_FrameDynamicStructureDefinitionEntity>;
+    /**
+     * A set of Entities that the structure is needed based on input prompt
+     *
+     * Where Entity is a A_Entity or a constructor of A_Entity that allows to define something that has ID(ASEID) and can be injected as a dependency in other components, fragments or containers.
+     *
+     * e.g.  Session, User, Conversation, etc.
+     *
+     * [!] Note: should be presented only if initial query allows to have an entity, and should be included only if necessary.
+     */
+    entities: Array<A_FrameDynamicStructureDefinitionEntity>;
+};
+
+declare class A_FrameDynamicPatch extends A_Entity<A_FrameDynamicPatch_Init, A_FrameDynamicPatch_Serialized> {
+    static get concept(): string;
+    version: number;
+    timestamp: number;
+    reason: string;
+    encoded: string;
+    delta: number;
+    fromNew(options: A_FrameDynamicPatch_Init): void;
+    toJSON(): A_FrameDynamicPatch_Serialized;
+}
+
+declare class A_FrameDynamicStructure extends A_Entity<A_FrameDynamicStructure_Init, A_FrameDynamicStructure_Serialized> {
+    static get concept(): string;
+    prompt: string;
+    createdAt: number;
+    private model;
+    private context;
+    private metaHint;
+    private includeBases;
+    private excludeBases;
+    private enabledComponents;
+    private _components;
+    private _history;
+    private _version;
+    private listeners;
+    fromNew(options: A_FrameDynamicStructure_Init): void;
+    /** The current resolved component list (output of the last generate or patch). */
+    get components(): ReadonlyArray<A_FrameDynamicStructureResolvedComponent>;
+    /** Immutable patch history. */
+    get history(): ReadonlyArray<A_FrameDynamicPatch>;
+    /** Current schema version (increments with each patch). */
+    get version(): number;
+    /**
+     * Run the full generation pipeline:
+     *   content generation → structure mapping → encode → patch
+     *
+     * @returns The resolved component list.
+     */
+    generate(): Promise<void>;
+    patch(prompt: string): Promise<void>;
+    /**
+     * Restore the component list to a specific version from history.
+     * Creates a new patch entry so the revert itself is tracked.
+     */
+    revertTo(version: number): this;
+    toJSON(): A_FrameDynamicStructure_Serialized;
+    subscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void;
+    unsubscribe(feature: A_FrameDynamicStructureEventNames, listener: A_FrameDynamicStructureListener): void;
+    emit(stage: A_FrameDynamicStructureEventNames, context: any): void;
+}
+
+export { A_FrameDynamicStructure as A, type BaseClassName as B, type DynamicStructureDefaultBasesNames as D, type A_FrameDynamicStructureDefinition as a, type A_FrameDynamicStructureDefinitionEntity as b, type A_FrameDynamicStructureEventNames as c, A_FrameDynamicStructureEvents as d, type A_FrameDynamicStructureFeatureNames as e, A_FrameDynamicStructureFeatures as f, type A_FrameDynamicStructureListener as g, type A_FrameDynamicStructureResolvedComponent as h, type A_FrameDynamicStructure_Init as i, type A_FrameDynamicStructure_Serialized as j, A_FrameDynamicStructureOperation as k };

package/dist/browser/A-FrameLogger.component.env-browser-BIPAP4oQ.d.mts

@@ -0,0 +1,112 @@
+import { A_Component } from '@adaas/a-concept';
+
+/**
+ * Public API surface for A_FrameLogger — shared between node and browser.
+ */
+type A_FrameLogLevelType = 'debug' | 'info' | 'success' | 'warn' | 'error';
+interface A_FrameLogEntry {
+    level: A_FrameLogLevelType;
+    message: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Handle returned by `logger.progress()`. Calling code drives the bar by
+ * `tick()`-ing once per processed item, then `succeed()` or `fail()` at the end.
+ */
+interface A_FrameProgressBar {
+    /** Advance by one and optionally update the trailing label */
+    tick(label?: string): void;
+    /** Mark the bar complete (even if not all items ticked) */
+    succeed(label?: string): void;
+    /** Mark the bar failed at current position */
+    fail(label?: string): void;
+    /** Set the absolute current value (for non-monotonic progress) */
+    update(current: number, label?: string): void;
+}
+/**
+ * Constructor / runtime configuration. All fields optional — sensible defaults
+ * are applied so `new A_FrameLogger()` always works.
+ */
+interface A_FrameLoggerConfig {
+    /** Minimum level to emit. Levels below are silently dropped. Default: 'debug'. */
+    level?: A_FrameLogLevelType;
+    /** Override TTY detection (Node only). Default: auto-detect via process.stdout.isTTY. */
+    color?: boolean;
+    /** Optional prefix prepended to every line, e.g. "[a-frame]" */
+    prefix?: string;
+}
+interface IA_FrameLogger {
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    success(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+    section(title: string): void;
+    divider(): void;
+    progress(label: string, total: number): A_FrameProgressBar;
+    increment(key: string, by?: number): void;
+    set(key: string, value: number): void;
+    get(key: string): number;
+    resetTimer(): void;
+    elapsed(): string;
+    summary(title?: string): void;
+}
+
+/**
+ * Abstract base for `A_FrameLogger` — environment-agnostic state and behaviour.
+ *
+ * Concrete subclasses (`A-FrameLogger.component.env-node` and
+ * `A-FrameLogger.component.env-browser`) implement `write()` and `progress()`
+ * since each runtime renders to a different surface (TTY vs DevTools console).
+ */
+declare abstract class A_FrameLoggerBase extends A_Component implements IA_FrameLogger {
+    protected level: A_FrameLogLevelType;
+    protected prefix: string;
+    protected counters: Map<string, number>;
+    protected startTime: number;
+    constructor(config?: A_FrameLoggerConfig);
+    /** Render a fully-built log entry to the runtime-specific output. */
+    protected abstract write(entry: A_FrameLogEntry): void;
+    /** Create a runtime-specific progress bar. */
+    abstract progress(label: string, total: number): A_FrameProgressBar;
+    setLevel(level: A_FrameLogLevelType): void;
+    /** Returns true when the entry passes the current level filter. */
+    protected shouldEmit(level: A_FrameLogLevelType): boolean;
+    private emit;
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    success(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    /** Default implementation that subclasses may override for nicer headings. */
+    section(title: string): void;
+    divider(): void;
+    increment(key: string, by?: number): void;
+    set(key: string, value: number): void;
+    get(key: string): number;
+    resetTimer(): void;
+    elapsed(): string;
+    /**
+     * Print a left-aligned table of all counters plus elapsed time.
+     * Concrete subclasses can override for richer rendering.
+     */
+    summary(title?: string): void;
+}
+
+/**
+ * A_FrameLogger — Browser environment.
+ *
+ * Renders to the DevTools console using `%c` CSS styling. Progress is shown
+ * via throttled console lines (no in-place redraw available in the browser).
+ */
+declare class A_FrameLogger extends A_FrameLoggerBase {
+    constructor(config?: A_FrameLoggerConfig);
+    protected write(entry: A_FrameLogEntry): void;
+    section(title: string): void;
+    divider(): void;
+    summary(title?: string): void;
+    progress(label: string, total: number): A_FrameProgressBar;
+}
+
+export { type A_FrameLogLevelType as A, type IA_FrameLogger as I, type A_FrameLogEntry as a, A_FrameLogger as b, A_FrameLoggerBase as c, type A_FrameLoggerConfig as d, type A_FrameProgressBar as e };

package/dist/browser/A-FrameNamespace.entity-rCm1AavP.d.mts

@@ -0,0 +1,125 @@
+import { A_TYPES__Entity_Serialized, A_Entity, A_Scope } from '@adaas/a-concept';
+import { A_FrameVector } from './vector.mjs';
+
+type A_FrameNamespace_Init = {
+    /** Unique identifier / slug for the namespace (e.g. "math", "finance/options") */
+    name: string;
+    description?: string;
+    metadata?: Record<string, any>;
+};
+type A_FrameNamespace_Serialized = {
+    hash: string;
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    embedding?: Float32Array;
+    embeddedAt: number;
+    embeddingModel?: string;
+    credentialId?: string;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+} & A_TYPES__Entity_Serialized;
+type A_FrameNamespace_Record = {
+    /** SHA-256 hex of the namespace name — acts as stable identity key */
+    hash: string;
+    /** Namespace name / slug */
+    name: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    embedding: Float32Array;
+    embeddedAt: number;
+    /** 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_FrameNamespace_EmbeddingMeta = {
+    model?: string;
+    date: string;
+    dimensions: number;
+    inputCount: number;
+    credentialId?: string | null;
+    aFrameVersion?: string;
+    aFrameServerVersion?: string;
+};
+type A_FrameNamespace_SearchResult = {
+    name: string;
+    score: number;
+    hash: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+};
+
+declare class A_FrameNamespace extends A_Entity<A_FrameNamespace_Init, A_FrameNamespace_Serialized> {
+    static get concept(): string;
+    protected _name: string;
+    protected _hash: string;
+    protected _description?: string;
+    protected _metadata?: Record<string, any>;
+    protected _vector?: A_FrameVector;
+    protected _embeddedAt?: number;
+    protected _embeddingModel?: string;
+    protected _credentialId?: string;
+    protected _aFrameVersion?: string;
+    protected _aFrameServerVersion?: string;
+    get id(): string;
+    get name(): string;
+    get hash(): string;
+    get description(): string | undefined;
+    get metadata(): Record<string, any>;
+    get vector(): A_FrameVector | undefined;
+    get embedding(): Float32Array | null;
+    get aFrameServerVersion(): string | undefined;
+    get aFrameVersion(): string | undefined;
+    get isEmbed(): boolean;
+    /**
+      * 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.
+      *
+      * @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_FrameNamespaceFeatures.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_FrameNamespaceFeatures.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_FrameNamespace, 'name' | 'description' | 'metadata'>>): void;
+    /**
+     * Generates an embedding vector for the namespace using the A_FrameNamespaceFeatures.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_FrameNamespace_Init): void;
+    fromJSON(serialized: A_FrameNamespace_Serialized): void;
+    toJSON(): A_FrameNamespace_Serialized;
+    hydrateFromRecord(record: A_FrameNamespace_Record): void;
+    hydrateFromEmbedding(embedding: Float32Array, meta?: A_FrameNamespace_EmbeddingMeta): void;
+    /**
+     * Build the text string sent to the embedding model.
+     * Uses name + description so the vector captures semantic intent.
+     */
+    toString(): string;
+}
+
+export { A_FrameNamespace as A, type A_FrameNamespace_EmbeddingMeta as a, type A_FrameNamespace_Init as b, type A_FrameNamespace_Record as c, type A_FrameNamespace_SearchResult as d, type A_FrameNamespace_Serialized as e };

package/dist/browser/bundle.d.mts

@@ -0,0 +1,8 @@
+export { A as A_FrameBundle } from './A-FrameBundle.types-DaaUvViw.mjs';
+
+/** Current bundle format revision. Bumped on incompatible structural changes. */
+declare const A_FRAME_BUNDLE_VERSION = 1;
+/** Default file name when none is provided to the CLI. */
+declare const A_FRAME_BUNDLE_DEFAULT_FILENAME = "a-frame-bundle.json";
+
+export { A_FRAME_BUNDLE_DEFAULT_FILENAME, A_FRAME_BUNDLE_VERSION };

package/dist/browser/bundle.mjs

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

package/dist/browser/bundle.mjs.map

@@ -0,0 +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"]}

package/dist/browser/channel.d.mts

@@ -0,0 +1,165 @@
+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 './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>;
+}
+
+/**
+ * A_FrameChannel — Browser environment
+ *
+ * HTTP client for the embed-server API.
+ * Configuration must be provided explicitly via configure() since there is
+ * no process.env in the browser.
+ *
+ * At build time, generate .bin index files in Node. In the browser, load them
+ * 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>;
+}
+
+declare class A_FrameChannelEvent<T extends Record<string, any> = any> extends A_Fragment {
+    protected _data?: T;
+    protected _eventName: string;
+    constructor(name: string, data?: T);
+    get name(): string;
+    get data(): T | undefined;
+}
+
+/**
+ * A_FrameChannelSocket — bidirectional WebSocket session entity.
+ *
+ * Lifecycle:
+ *   1. Instantiate with `new A_FrameChannelSocket({ method: 'GET', path: '/ws/...' })`.
+ *   2. Register event handlers via `@A_FrameChannelSocket.onEvent('type')` on a subclass.
+ *   3. Pass the instance to `A_FrameChannel.connect(socket)` which performs the
+ *      WebSocket handshake and sets the internal send capability.
+ *   4. While the connection is open, call `socket.send(event)` to push frames to
+ *      the server.  Incoming frames are dispatched via `propagate()`.
+ *   5. The socket transitions to Closed when the server sends a close frame or the
+ *      underlying transport ends.
+ */
+declare class A_FrameChannelSocket<T extends Record<string, any> = Record<string, any>> extends A_Entity<A_FrameChannelSocket_Init<T>, A_FrameChannelSocket_Serialized<T>> {
+    /**
+     * Registers a method as a handler for a specific WebSocket event type sent
+     * by the server.  Mirrors `A_FrameChannelStream.onEvent()`.
+     *
+     * Usage (inside a subclass):
+     *   @A_FrameChannelSocket.onEvent('my_event')
+     *   async onMyEvent(@A_Inject(A_FrameChannelEvent) event: A_FrameChannelEvent) { ... }
+     *
+     * Omit the name (or use `'all'`) to receive every event type.
+     */
+    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_FrameChannelSocketStatusNames;
+    protected _initDate: string;
+    protected _sendFn: ((data: string) => void) | null;
+    /** Scope allocated for the lifetime of this socket session. */
+    get scope(): A_Scope;
+    get method(): string;
+    get path(): string;
+    get body(): T | undefined;
+    get status(): A_FrameChannelSocketStatusNames;
+    get error(): A_Error | undefined;
+    get initDate(): Date;
+    /**
+     * Called by the connect feature immediately after a successful handshake.
+     * Transitions status Connecting → Open and stores the send callback.
+     */
+    attachSendFn(fn: (data: string) => void): void;
+    /**
+     * Send an event to the server over the open WebSocket connection.
+     *
+     * The event is serialised as `{ type, data }`, matching the shape the server
+     * uses for events it pushes to the client — keeping both directions symmetric.
+     *
+     * @throws {A_FrameChannelError} if the socket is not open.
+     */
+    send(event: A_FrameChannelEvent): void;
+    complete(): void;
+    fail(error: A_Error): void;
+    destroy(): Promise<void> | void;
+    /**
+     * Dispatch an incoming server event to all registered `@onEvent` handlers.
+     * Mirrors `A_FrameChannelStream.propagate()`.
+     */
+    propagate<D extends Record<string, any>>(name: string, data?: D): Promise<void>;
+    fromNew(newEntity: A_FrameChannelSocket_Init<T>): void;
+    fromJSON(serialized: A_FrameChannelSocket_Serialized<T>): void;
+    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 };

package/dist/browser/channel.mjs

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