@soulcraft/brainy 3.36.0 → 3.36.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.36.1](https://github.com/soulcraftlabs/brainy/compare/v3.36.0...v3.36.1) (2025-10-10)
+
+- fix: resolve critical GCS storage bugs preventing production use (3cd0b9a)
+
+
 ### [3.36.0](https://github.com/soulcraftlabs/brainy/compare/v3.35.0...v3.36.0) (2025-10-10)
 
 #### 🚀 Always-Adaptive Caching with Enhanced Monitoring

package/dist/storage/adapters/gcsStorage.js

@@ -16,6 +16,10 @@ import { getGlobalBackpressure } from '../../utils/adaptiveBackpressure.js';
 import { getWriteBuffer } from '../../utils/writeBuffer.js';
 import { getCoalescer } from '../../utils/requestCoalescer.js';
 import { getShardIdFromUuid, getShardIdByIndex, TOTAL_SHARDS } from '../sharding.js';
+// GCS API limits
+// Maximum value for maxResults parameter in GCS API calls
+// Values above this cause "Invalid unsigned integer" errors
+const MAX_GCS_PAGE_SIZE = 5000;
 /**
  * Native Google Cloud Storage adapter for server environments
  * Uses the @google-cloud/storage library with Application Default Credentials
@@ -385,7 +389,8 @@ export class GcsStorage extends BaseStorage {
                 id: data.id,
                 vector: data.vector,
                 connections,
-                level: data.level || 0
+                level: data.level || 0,
+                metadata: data.metadata // CRITICAL: Include metadata for entity reconstruction
             };
             // Update cache
             this.nounCacheManager.set(id, node);
@@ -759,9 +764,12 @@ export class GcsStorage extends BaseStorage {
                 const shardId = getShardIdByIndex(shardIndex);
                 const shardPrefix = `${this.nounPrefix}${shardId}/`;
                 // List objects in this shard
+                // Cap maxResults to GCS API limit to prevent "Invalid unsigned integer" errors
+                const requestedPageSize = limit - nodes.length;
+                const cappedPageSize = Math.min(requestedPageSize, MAX_GCS_PAGE_SIZE);
                 const [files, , response] = await this.bucket.getFiles({
                     prefix: shardPrefix,
-                    maxResults: limit - nodes.length,
+                    maxResults: cappedPageSize,
                     pageToken: shardIndex === startShardIndex ? gcsPageToken : undefined
                 });
                 // Extract node IDs from file names
@@ -880,9 +888,11 @@ export class GcsStorage extends BaseStorage {
         const limit = options.limit || 100;
         try {
             // List verbs (simplified - not sharded yet in original implementation)
+            // Cap maxResults to GCS API limit to prevent "Invalid unsigned integer" errors
+            const cappedLimit = Math.min(limit, MAX_GCS_PAGE_SIZE);
             const [files, , response] = await this.bucket.getFiles({
                 prefix: this.verbPrefix,
-                maxResults: limit,
+                maxResults: cappedLimit,
                 pageToken: options.cursor
             });
             // If no files, return empty result
@@ -1039,7 +1049,7 @@ export class GcsStorage extends BaseStorage {
             // Get bucket metadata
             const [metadata] = await this.bucket.getMetadata();
             return {
-                type: 'gcs-native',
+                type: 'gcs',
                 used: 0, // GCS doesn't provide usage info easily
                 quota: null, // No quota in GCS
                 details: {
@@ -1053,7 +1063,7 @@ export class GcsStorage extends BaseStorage {
         catch (error) {
             this.logger.error('Failed to get storage status:', error);
             return {
-                type: 'gcs-native',
+                type: 'gcs',
                 used: 0,
                 quota: null
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.36.0",
+  "version": "3.36.1",
   "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",