@soulcraft/brainy 3.13.0 → 3.14.0

package/dist/types/augmentations.d.ts

@@ -37,7 +37,29 @@ import type { BrainyAugmentation as BA, BaseAugmentation as BaseA, AugmentationC
 export type BrainyAugmentation = BA;
 export type BaseAugmentation = BaseA;
 export type AugmentationContext = AC;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Augmentation types are now unified under BrainyAugmentation interface
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { AugmentationType } from '@soulcraft/brainy/types/augmentations'
+ * if (augmentation.type === AugmentationType.SENSE) { ... }
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ * // Use the unified BrainyAugmentation interface directly
+ */
 export declare enum AugmentationType {
     SENSE = "sense",
     CONDUIT = "conduit",
@@ -49,23 +71,139 @@ export declare enum AugmentationType {
     WEBSOCKET = "webSocket",
     SYNAPSE = "synapse"
 }
+/**
+ * @deprecated Use BrainyAugmentation interface directly instead of namespace types
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { BrainyAugmentations } from '@soulcraft/brainy/types/augmentations'
+ * class MyAugmentation implements BrainyAugmentations.ISenseAugmentation { ... }
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ * class MyAugmentation implements BrainyAugmentation { ... }
+ */
 export declare namespace BrainyAugmentations {
+    /** @deprecated Use BrainyAugmentation instead */
     type ISenseAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type IConduitAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type ICognitionAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type IMemoryAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type IPerceptionAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type IDialogAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type IActivationAugmentation = BrainyAugmentation;
+    /** @deprecated Use BrainyAugmentation instead */
     type ISynapseAugmentation = BrainyAugmentation;
 }
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { ISenseAugmentation } from '@soulcraft/brainy/types/augmentations'
+ * class MySense implements ISenseAugmentation { ... }
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ * class MySense implements BrainyAugmentation { ... }
+ */
 export type ISenseAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IConduitAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IConduitAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { ICognitionAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type ICognitionAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IMemoryAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IMemoryAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IPerceptionAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IPerceptionAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IDialogAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IDialogAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IActivationAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type IActivationAugmentation = BrainyAugmentation;
+/**
+ * @deprecated Use BrainyAugmentation from '../augmentations/brainyAugmentation.js' instead
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { ISynapseAugmentation } from '@soulcraft/brainy/types/augmentations'
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ */
 export type ISynapseAugmentation = BrainyAugmentation;
+/**
+ * @deprecated WebSocket support is now built into BrainyAugmentation interface
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { IWebSocketSupport } from '@soulcraft/brainy/types/augmentations'
+ * class MyAugmentation implements IWebSocketSupport { ... }
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ * class MyAugmentation implements BrainyAugmentation {
+ *   // WebSocket functionality is now part of the unified interface
+ * }
+ */
 export interface IWebSocketSupport {
 }

package/dist/types/augmentations.js

@@ -4,6 +4,18 @@
  * This file contains only the minimal types needed for augmentations.
  * The main augmentation interfaces are now in augmentations/brainyAugmentation.ts
  */
+/**
+ * @deprecated Augmentation types are now unified under BrainyAugmentation interface
+ *
+ * @example
+ * // ❌ Old way (v2.x):
+ * import { AugmentationType } from '@soulcraft/brainy/types/augmentations'
+ * if (augmentation.type === AugmentationType.SENSE) { ... }
+ *
+ * // ✅ New way (v3.x):
+ * import { BrainyAugmentation } from '@soulcraft/brainy'
+ * // Use the unified BrainyAugmentation interface directly
+ */
 export var AugmentationType;
 (function (AugmentationType) {
     AugmentationType["SENSE"] = "sense";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.13.0",
+  "version": "3.14.0",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",