@adaas/a-frame 0.1.1 → 0.1.2

package/dist/node/A-FrameDefinition.types-BA_pLGpo.d.ts

@@ -0,0 +1,232 @@
+import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Component, A_Container, A_Entity, A_Fragment, A_TYPES__Entity_Serialized } from '@adaas/a-concept';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-HDXcLGcS.js';
+
+type A_FrameOptions = {
+    namespace?: string;
+    description?: string;
+};
+type A_FrameDefineOptions<T extends Record<string, any> = Record<string, any>> = {
+    /**
+     * The description of the Method or Class to be indexed. Uses for the better explanation and retrieval strategy
+     */
+    description?: string;
+    /**
+     * Define Namespace to separate and group together related components, entities and containers.
+     *
+     * [!] Namespace is a hard separation between groups.
+     */
+    namespace?: string | A_FrameNamespace;
+    /***
+     * Optional parameters that can be used to store any additional information about the component, entity or container.
+     * This information can be used for the better retrieval strategy or for the better explanation of the component, entity or container.
+     */
+    metadata?: T;
+    /**
+     * Can add a custom way of explaining the component, entity or container, so it can be used in the better retrieval strategy.
+     */
+    examples?: string[];
+};
+type A_FrameMetaTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
+/**
+ * Indicates a type of Feature Define decorator
+ */
+type A_FrameDecoratorDescriptor = TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>;
+/**
+ * Describes a target where Feature Define decorator can be applied
+ *
+ * [!] The feature can be defined on Container, Entity, Component or Command
+ */
+type A_FrameDecoratorTarget = A_FrameMetaTarget | A_Component | A_Container | A_Entity | A_Fragment;
+/**
+ * Targets types that can be indexed
+ */
+declare enum A_FrameTargetType {
+    COMPONENT = "component",
+    ENTITY = "entity",
+    CONTAINER = "container",
+    FRAGMENT = "fragment",
+    METHOD = "method"
+}
+/**
+ * A type of Meta information stored by Index decorator
+ * This information is used by A-Context to build a proper index structure
+ */
+type A_FrameDecoratorMeta = {
+    /**
+     * Component name
+     */
+    name: string;
+    /**
+     * Component description
+     */
+    description?: string;
+    /**
+     * Type of the component
+     */
+    type: A_FrameTargetType;
+    /**
+     * Namespace for the component
+     */
+    namespace?: string | A_FrameNamespace;
+    /**
+     * Constructor reference
+     */
+    constructor: A_FrameDecoratorTarget;
+};
+/**
+ * Indicates a type of Feature Define decorator
+ */
+type A_FrameNamespaceDecoratorDescriptor = TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>;
+/**
+ * Describes a target where Feature Define decorator can be applied
+ *
+ * [!] The feature can be defined on Container, Entity, Component or Command
+ */
+type A_FrameNamespaceDecoratorTarget = A_Container | A_Entity | A_Component | A_Fragment | A_TYPES__Fragment_Constructor | A_TYPES__Component_Constructor | A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor;
+type A_FrameIndexMetaType = {
+    namespaces: string;
+    descriptions: string;
+    type: string;
+    name: string;
+    methods: Map<string, A_FrameIndexMetaMethodMeta>;
+};
+type A_FrameIndexMetaMethodMeta = {
+    name: string;
+    description?: string;
+    methodName: string;
+};
+type A_FrameNamespaceOptions = {
+    /**
+     * Must have UNIQUE name of the Namespace. This is used for the indexing and retrieval strategy. It should be descriptive and concise.
+     */
+    name: string;
+    /**
+     * The description of the Namespace to be indexed. Uses for the better explanation and retrieval strategy
+     */
+    description?: string;
+};
+
+/**
+ * Metadata statically extracted server-side from a definition's source code.
+ * Returned by POST /api/v1/definition/embed and stored on the entity so it
+ * can be persisted alongside the embedding vector.
+ */
+interface DefinitionExtractedMeta {
+    /** Class name found in source (e.g. "PaymentProcessor") */
+    className?: string;
+    /** Public method names (excludes constructor and `_private` conventions) */
+    methods: string[];
+    /** Class names injected via @A_Inject(ClassName) decorators */
+    injectDeps: string[];
+    /** Feature names from @A_Feature.Extend({ name: '...' }) decorators */
+    features: string[];
+    /** Number of embedding chunks the source was split into */
+    chunkCount: number;
+}
+type A_FrameDefinition_Init = {
+    /**
+     * Name of the Component/Fragment/Entity or method, provided automatically by the decorator.
+     */
+    name: string;
+    /**
+     * Information where this Definition relates to Container/Component/Fragment/Entity
+     */
+    dependency: string;
+    /**
+     * The Description that explains the purpose and functionality of the defined feature. This should provide enough context for someone to understand what the feature does and when to use it, without needing to read the source code.
+     */
+    description?: string;
+    /**
+     * An optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    namespace: A_FrameNamespace;
+    /**
+     * The source code or implementation details of the defined feature. For a component, this would be the component's code; for a method, it would be the method's implementation, etc.
+     */
+    source: string;
+    /**
+     * The type of the defined feature, indicating whether it's a component, entity, container, fragment, or method. This is used for categorization and search filtering in the index.
+     */
+    type: A_FrameTargetType;
+    /**
+     * Optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Optional embedding model override (e.g. `A_FRAME_MODELS.ANTARES`). When omitted the
+     * server defaults to the Antares model.  Pass a named model ID to request a specific
+     * backend without hard-coding the physical model name.
+     */
+    model?: string;
+};
+type A_FrameDefinition_Serialized = {
+    /**
+     * Name of the Component/Fragment/Entity or method, provided automatically by the decorator.
+     */
+    name: string;
+    /**
+     * Information where this Definition relates to Container/Component/Fragment/Entity
+     */
+    description?: string;
+    /**
+     * Namespace ID or name that this definition belongs to. This is used for grouping related definitions together in the index and can be used as a filter during search.
+     */
+    source?: string;
+    /**
+     * A state indicating the last status of embeddings applied
+     */
+    hash: string;
+    /**
+     * Type of the definition (component, entity, container, fragment or method)
+     */
+    type: A_FrameTargetType;
+    /**
+     * Optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Namespace ID or name that this definition belongs to. This is used for grouping related definitions together in the index and can be used as a filter during search.
+     */
+    namespace: string;
+    /**
+     * An Float32Array representing the embedding vector for this definition, if it has been generated and stored. This can be used for similarity search and retrieval in the index.
+     */
+    embedding?: Float32Array;
+    /**
+     * ISO timestamp string of when the embedding was generated. This can be used for cache invalidation or tracking when the data was last updated.
+     */
+    date: string;
+    /**
+     * Name of the model used in the request
+     */
+    model: 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 (embed-server) that produced the vector
+     */
+    aFrameServerVersion: string;
+    /**
+     * Structural metadata extracted server-side from the definition's source (methods, deps, features).
+     */
+    aFrameMeta?: DefinitionExtractedMeta;
+} & A_TYPES__Entity_Serialized;
+type A_FrameDefinition_EmbeddingMeta = {
+    model: string;
+    dimensions: number;
+    inputCount: number;
+    date: string;
+    credentialId: string;
+    aFrameVersion: string;
+    aFrameServerVersion: string;
+    /** Structural metadata extracted server-side from the source code */
+    aFrameMeta?: DefinitionExtractedMeta;
+};
+
+export { type A_FrameDefinition_EmbeddingMeta as A, type DefinitionExtractedMeta as D, type A_FrameDefinition_Init as a, type A_FrameDefinition_Serialized as b, A_FrameTargetType as c, type A_FrameDefineOptions as d, type A_FrameNamespaceOptions as e, type A_FrameDecoratorTarget as f, type A_FrameDecoratorDescriptor as g, type A_FrameDecoratorMeta as h, type A_FrameIndexMetaMethodMeta as i, type A_FrameIndexMetaType as j, type A_FrameMetaTarget as k, type A_FrameNamespaceDecoratorDescriptor as l, type A_FrameNamespaceDecoratorTarget as m, type A_FrameOptions as n };

package/dist/node/A-FrameDefinition.types-BT02yAhQ.d.mts

@@ -0,0 +1,232 @@
+import { A_TYPES__Container_Constructor, A_TYPES__Entity_Constructor, A_TYPES__Component_Constructor, A_TYPES__Fragment_Constructor, A_Component, A_Container, A_Entity, A_Fragment, A_TYPES__Entity_Serialized } from '@adaas/a-concept';
+import { A as A_FrameNamespace } from './A-FrameNamespace.entity-BDg1FUgo.mjs';
+
+type A_FrameOptions = {
+    namespace?: string;
+    description?: string;
+};
+type A_FrameDefineOptions<T extends Record<string, any> = Record<string, any>> = {
+    /**
+     * The description of the Method or Class to be indexed. Uses for the better explanation and retrieval strategy
+     */
+    description?: string;
+    /**
+     * Define Namespace to separate and group together related components, entities and containers.
+     *
+     * [!] Namespace is a hard separation between groups.
+     */
+    namespace?: string | A_FrameNamespace;
+    /***
+     * Optional parameters that can be used to store any additional information about the component, entity or container.
+     * This information can be used for the better retrieval strategy or for the better explanation of the component, entity or container.
+     */
+    metadata?: T;
+    /**
+     * Can add a custom way of explaining the component, entity or container, so it can be used in the better retrieval strategy.
+     */
+    examples?: string[];
+};
+type A_FrameMetaTarget = A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor | A_TYPES__Component_Constructor | A_TYPES__Fragment_Constructor;
+/**
+ * Indicates a type of Feature Define decorator
+ */
+type A_FrameDecoratorDescriptor = TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>;
+/**
+ * Describes a target where Feature Define decorator can be applied
+ *
+ * [!] The feature can be defined on Container, Entity, Component or Command
+ */
+type A_FrameDecoratorTarget = A_FrameMetaTarget | A_Component | A_Container | A_Entity | A_Fragment;
+/**
+ * Targets types that can be indexed
+ */
+declare enum A_FrameTargetType {
+    COMPONENT = "component",
+    ENTITY = "entity",
+    CONTAINER = "container",
+    FRAGMENT = "fragment",
+    METHOD = "method"
+}
+/**
+ * A type of Meta information stored by Index decorator
+ * This information is used by A-Context to build a proper index structure
+ */
+type A_FrameDecoratorMeta = {
+    /**
+     * Component name
+     */
+    name: string;
+    /**
+     * Component description
+     */
+    description?: string;
+    /**
+     * Type of the component
+     */
+    type: A_FrameTargetType;
+    /**
+     * Namespace for the component
+     */
+    namespace?: string | A_FrameNamespace;
+    /**
+     * Constructor reference
+     */
+    constructor: A_FrameDecoratorTarget;
+};
+/**
+ * Indicates a type of Feature Define decorator
+ */
+type A_FrameNamespaceDecoratorDescriptor = TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => any> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>> | TypedPropertyDescriptor<(...args: any[]) => Promise<any>>;
+/**
+ * Describes a target where Feature Define decorator can be applied
+ *
+ * [!] The feature can be defined on Container, Entity, Component or Command
+ */
+type A_FrameNamespaceDecoratorTarget = A_Container | A_Entity | A_Component | A_Fragment | A_TYPES__Fragment_Constructor | A_TYPES__Component_Constructor | A_TYPES__Container_Constructor | A_TYPES__Entity_Constructor;
+type A_FrameIndexMetaType = {
+    namespaces: string;
+    descriptions: string;
+    type: string;
+    name: string;
+    methods: Map<string, A_FrameIndexMetaMethodMeta>;
+};
+type A_FrameIndexMetaMethodMeta = {
+    name: string;
+    description?: string;
+    methodName: string;
+};
+type A_FrameNamespaceOptions = {
+    /**
+     * Must have UNIQUE name of the Namespace. This is used for the indexing and retrieval strategy. It should be descriptive and concise.
+     */
+    name: string;
+    /**
+     * The description of the Namespace to be indexed. Uses for the better explanation and retrieval strategy
+     */
+    description?: string;
+};
+
+/**
+ * Metadata statically extracted server-side from a definition's source code.
+ * Returned by POST /api/v1/definition/embed and stored on the entity so it
+ * can be persisted alongside the embedding vector.
+ */
+interface DefinitionExtractedMeta {
+    /** Class name found in source (e.g. "PaymentProcessor") */
+    className?: string;
+    /** Public method names (excludes constructor and `_private` conventions) */
+    methods: string[];
+    /** Class names injected via @A_Inject(ClassName) decorators */
+    injectDeps: string[];
+    /** Feature names from @A_Feature.Extend({ name: '...' }) decorators */
+    features: string[];
+    /** Number of embedding chunks the source was split into */
+    chunkCount: number;
+}
+type A_FrameDefinition_Init = {
+    /**
+     * Name of the Component/Fragment/Entity or method, provided automatically by the decorator.
+     */
+    name: string;
+    /**
+     * Information where this Definition relates to Container/Component/Fragment/Entity
+     */
+    dependency: string;
+    /**
+     * The Description that explains the purpose and functionality of the defined feature. This should provide enough context for someone to understand what the feature does and when to use it, without needing to read the source code.
+     */
+    description?: string;
+    /**
+     * An optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    namespace: A_FrameNamespace;
+    /**
+     * The source code or implementation details of the defined feature. For a component, this would be the component's code; for a method, it would be the method's implementation, etc.
+     */
+    source: string;
+    /**
+     * The type of the defined feature, indicating whether it's a component, entity, container, fragment, or method. This is used for categorization and search filtering in the index.
+     */
+    type: A_FrameTargetType;
+    /**
+     * Optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Optional embedding model override (e.g. `A_FRAME_MODELS.ANTARES`). When omitted the
+     * server defaults to the Antares model.  Pass a named model ID to request a specific
+     * backend without hard-coding the physical model name.
+     */
+    model?: string;
+};
+type A_FrameDefinition_Serialized = {
+    /**
+     * Name of the Component/Fragment/Entity or method, provided automatically by the decorator.
+     */
+    name: string;
+    /**
+     * Information where this Definition relates to Container/Component/Fragment/Entity
+     */
+    description?: string;
+    /**
+     * Namespace ID or name that this definition belongs to. This is used for grouping related definitions together in the index and can be used as a filter during search.
+     */
+    source?: string;
+    /**
+     * A state indicating the last status of embeddings applied
+     */
+    hash: string;
+    /**
+     * Type of the definition (component, entity, container, fragment or method)
+     */
+    type: A_FrameTargetType;
+    /**
+     * Optional metadata object that can contain any additional information about the defined feature. This can include things like parameter types for methods, expected props for components, or any other relevant details that don't fit into the description or source fields.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Namespace ID or name that this definition belongs to. This is used for grouping related definitions together in the index and can be used as a filter during search.
+     */
+    namespace: string;
+    /**
+     * An Float32Array representing the embedding vector for this definition, if it has been generated and stored. This can be used for similarity search and retrieval in the index.
+     */
+    embedding?: Float32Array;
+    /**
+     * ISO timestamp string of when the embedding was generated. This can be used for cache invalidation or tracking when the data was last updated.
+     */
+    date: string;
+    /**
+     * Name of the model used in the request
+     */
+    model: 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 (embed-server) that produced the vector
+     */
+    aFrameServerVersion: string;
+    /**
+     * Structural metadata extracted server-side from the definition's source (methods, deps, features).
+     */
+    aFrameMeta?: DefinitionExtractedMeta;
+} & A_TYPES__Entity_Serialized;
+type A_FrameDefinition_EmbeddingMeta = {
+    model: string;
+    dimensions: number;
+    inputCount: number;
+    date: string;
+    credentialId: string;
+    aFrameVersion: string;
+    aFrameServerVersion: string;
+    /** Structural metadata extracted server-side from the source code */
+    aFrameMeta?: DefinitionExtractedMeta;
+};
+
+export { type A_FrameDefinition_EmbeddingMeta as A, type DefinitionExtractedMeta as D, type A_FrameDefinition_Init as a, type A_FrameDefinition_Serialized as b, A_FrameTargetType as c, type A_FrameDefineOptions as d, type A_FrameNamespaceOptions as e, type A_FrameDecoratorTarget as f, type A_FrameDecoratorDescriptor as g, type A_FrameDecoratorMeta as h, type A_FrameIndexMetaMethodMeta as i, type A_FrameIndexMetaType as j, type A_FrameMetaTarget as k, type A_FrameNamespaceDecoratorDescriptor as l, type A_FrameNamespaceDecoratorTarget as m, type A_FrameOptions as n };