@cmdoss/memwal-sdk 0.6.2 → 0.7.0

package/src/client/namespaces/MemoryNamespace.ts

@@ -1132,4 +1132,141 @@ export class MemoryNamespace {
       throw new Error(`Failed to export memories: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
+
+  /**
+   * Index memories from a Quilt into the local HNSW index
+   *
+   * This allows Quilt batch-uploaded memories to be searchable via vector search.
+   * The method fetches memory packages from the Quilt and indexes each one.
+   *
+   * @param quiltId - The Quilt blob ID containing memory packages
+   * @param options - Indexing options
+   * @returns Result with number of memories indexed
+   *
+   * @example
+   * ```typescript
+   * // After uploading a batch via Quilt
+   * const result = await pdw.memory.indexFromQuilt('GTNhNTdWecbUVg3cZuC_VKlRSzJE3iQfBkojWUuwoh0');
+   * console.log(`Indexed ${result.indexed} memories from Quilt`);
+   * ```
+   */
+  async indexFromQuilt(
+    quiltId: string,
+    options?: { forceReindex?: boolean }
+  ): Promise<{
+    success: boolean;
+    total: number;
+    indexed: number;
+    skipped: number;
+    failed: number;
+    errors: string[];
+  }> {
+    const errors: string[] = [];
+    let indexed = 0;
+    let skipped = 0;
+    let failed = 0;
+
+    try {
+      console.log(`📦 Indexing memories from Quilt ${quiltId}...`);
+
+      // Check if index service is available
+      if (!this.services.memoryIndex) {
+        throw new Error('Memory index service not available');
+      }
+
+      // Check if quilt manager is available
+      if (!this.services.storage?.quiltBatchManager) {
+        throw new Error('Quilt batch manager not available');
+      }
+
+      // Fetch all memory packages from the Quilt
+      const packages = await this.services.storage.quiltBatchManager.getAllMemoryPackages(quiltId);
+      console.log(`   Found ${packages.length} memory packages in Quilt`);
+
+      // Index each memory
+      for (const pkg of packages) {
+        try {
+          const { identifier, memoryPackage, tags } = pkg;
+
+          // Skip if no embedding
+          if (!memoryPackage.embedding || memoryPackage.embedding.length === 0) {
+            console.warn(`   ⚠️ Skipping ${identifier}: no embedding`);
+            skipped++;
+            continue;
+          }
+
+          // Create a unique memory ID from identifier or use memoryId from metadata
+          const memoryId = memoryPackage.metadata?.memoryId as string ||
+            identifier.replace('.json', '').replace('memory-', '');
+
+          // Build metadata for indexing (satisfy MemoryMetadata interface)
+          const metadata = {
+            category: memoryPackage.metadata?.category || 'general',
+            importance: memoryPackage.metadata?.importance || 3,
+            topic: memoryPackage.metadata?.topic || '',
+            contentType: 'text',
+            contentSize: memoryPackage.content?.length || 0,
+            contentHash: '', // Not available from Quilt package
+            embeddingDimension: memoryPackage.embedding?.length || 0,
+            createdTimestamp: memoryPackage.timestamp,
+            customMetadata: {
+              quiltId,
+              identifier,
+              ...Object.fromEntries(
+                Object.entries(memoryPackage.metadata || {}).map(([k, v]) => [k, String(v)])
+              )
+            }
+          };
+
+          // Content is empty if encrypted, use placeholder
+          const content = memoryPackage.content || '[encrypted]';
+          const isEncrypted = memoryPackage.encrypted === true;
+
+          // Index the memory
+          await this.services.memoryIndex.indexMemory(
+            this.services.config.userAddress,
+            memoryId,
+            quiltId, // Use quiltId as blobId for retrieval reference
+            content,
+            metadata,
+            memoryPackage.embedding,
+            { isEncrypted }
+          );
+
+          indexed++;
+          console.log(`   ✅ Indexed ${identifier} (${indexed}/${packages.length})`);
+
+        } catch (pkgError) {
+          const errMsg = pkgError instanceof Error ? pkgError.message : String(pkgError);
+          errors.push(`${pkg.identifier}: ${errMsg}`);
+          failed++;
+          console.error(`   ❌ Failed to index ${pkg.identifier}:`, errMsg);
+        }
+      }
+
+      console.log(`\n📊 Quilt indexing complete:`);
+      console.log(`   Total: ${packages.length}, Indexed: ${indexed}, Skipped: ${skipped}, Failed: ${failed}`);
+
+      return {
+        success: failed === 0,
+        total: packages.length,
+        indexed,
+        skipped,
+        failed,
+        errors
+      };
+
+    } catch (error) {
+      const errMsg = error instanceof Error ? error.message : String(error);
+      console.error(`❌ Failed to index from Quilt: ${errMsg}`);
+      return {
+        success: false,
+        total: 0,
+        indexed,
+        skipped,
+        failed,
+        errors: [errMsg, ...errors]
+      };
+    }
+  }
 }

package/src/client/namespaces/consolidated/AINamespace.ts

@@ -76,12 +76,12 @@ export class AINamespace {
    *
    * @param text - Text to embed
    * @param options - Embedding options
-   * @returns Embedding vector (768 dimensions for Gemini)
+   * @returns Embedding vector (3072 dimensions for Gemini)
    *
    * @example
    * ```typescript
    * const vector = await pdw.ai.embed('My favorite color is blue');
-   * console.log(vector.length); // 768
+   * console.log(vector.length); // 3072
    * ```
    */
   async embed(text: string, options?: EmbedOptions): Promise<number[]> {

package/src/client/namespaces/consolidated/BlockchainNamespace.ts

@@ -165,7 +165,25 @@ class TxSubNamespace {
         }
 
         // Determine status from effects
-        const status = result.effects?.status?.status === 'success' ? 'success' : 'failure';
+        // dapp-kit may not return full effects structure unless custom execute is configured
+        // We check multiple indicators:
+        // 1. If effects.status.status explicitly says 'failure', it failed
+        // 2. If effects.status.status says 'success', it succeeded
+        // 3. If we have a digest but no effects status, assume success (tx was submitted and confirmed)
+        let status: 'success' | 'failure';
+        const effectsStatus = result.effects?.status?.status;
+
+        if (effectsStatus === 'failure') {
+          status = 'failure';
+        } else if (effectsStatus === 'success') {
+          status = 'success';
+        } else if (result.digest) {
+          // Has digest but no explicit status - DappKitSigner waits for confirmation
+          // If we reach here without error, the transaction was successful
+          status = 'success';
+        } else {
+          status = 'failure';
+        }
 
         return {
           digest: result.digest,
@@ -176,7 +194,7 @@ class TxSubNamespace {
           gasUsed: result.effects?.gasUsed?.computationCost
             ? Number(result.effects.gasUsed.computationCost)
             : undefined,
-          error: status === 'failure' ? result.effects?.status?.error : undefined,
+          error: status === 'failure' ? (result.effects?.status?.error || 'Transaction failed without digest') : undefined,
         };
       } catch (error) {
         console.error('Transaction execution failed:', error);

package/src/client/signers/DappKitSigner.ts

@@ -1,207 +1,207 @@
-/**
- * DappKit Signer Implementation
- *
- * Adapter for @mysten/dapp-kit hooks to work with SimplePDWClient.
- * Bridges dApp-kit's hook-based API with SDK's UnifiedSigner interface.
- *
- * @example
- * ```typescript
- * import { DappKitSigner, createSimplePDWClient } from '@cmdoss/memwal-sdk';
- * import { useCurrentAccount, useSignAndExecuteTransaction, useSuiClient } from '@mysten/dapp-kit';
- *
- * function MyComponent() {
- *   const account = useCurrentAccount();
- *   const client = useSuiClient();
- *   const { mutateAsync: signAndExecute } = useSignAndExecuteTransaction();
- *
- *   const signer = useMemo(() => {
- *     if (!account) return null;
- *     return new DappKitSigner({
- *       address: account.address,
- *       client,
- *       signAndExecuteTransaction: signAndExecute,
- *     });
- *   }, [account, client, signAndExecute]);
- *
- *   // Now use signer with SDK
- *   const pdw = await createSimplePDWClient({ signer, network: 'testnet' });
- * }
- * ```
- *
- * @module client/signers
- */
-
-import type { Transaction } from '@mysten/sui/transactions';
-import type { SuiClient } from '@mysten/sui/client';
-import type { Signer } from '@mysten/sui/cryptography';
-import type {
-  UnifiedSigner,
-  SignAndExecuteResult,
-  SignPersonalMessageResult
-} from './UnifiedSigner';
-
-/**
- * Function signature for dApp-kit's signAndExecuteTransaction
- * Compatible with useSignAndExecuteTransaction().mutateAsync
- */
-export interface DappKitSignAndExecuteFn {
-  (params: { transaction: Transaction }): Promise<{
-    digest: string;
-    effects?: any;
-    events?: any[];
-    objectChanges?: any[];
-  }>;
-}
-
-/**
- * Function signature for dApp-kit's signPersonalMessage
- * Compatible with useSignPersonalMessage().mutateAsync
- */
-export interface DappKitSignPersonalMessageFn {
-  (params: { message: Uint8Array }): Promise<{
-    signature: string;
-    bytes?: Uint8Array;
-  }>;
-}
-
-/**
- * Configuration for DappKitSigner
- */
-export interface DappKitSignerConfig {
-  /**
-   * User's Sui address (from useCurrentAccount().address)
-   */
-  address: string;
-
-  /**
-   * SuiClient instance (from useSuiClient())
-   */
-  client: SuiClient;
-
-  /**
-   * signAndExecuteTransaction function (from useSignAndExecuteTransaction().mutateAsync)
-   */
-  signAndExecuteTransaction: DappKitSignAndExecuteFn;
-
-  /**
-   * signPersonalMessage function (from useSignPersonalMessage().mutateAsync)
-   * Optional - only required for operations that need message signing
-   */
-  signPersonalMessage?: DappKitSignPersonalMessageFn;
-
-  /**
-   * Public key bytes (optional, from useCurrentAccount().publicKey)
-   */
-  publicKey?: Uint8Array;
-}
-
-/**
- * DappKitSigner - Adapter for @mysten/dapp-kit hooks
- *
- * Wraps dApp-kit's useSignAndExecuteTransaction and useSignPersonalMessage hooks
- * to provide a UnifiedSigner interface compatible with SDK managers.
- *
- * This adapter does NOT depend on React - it accepts function references
- * that can come from dApp-kit hooks or any other source with compatible signatures.
- */
-export class DappKitSigner implements UnifiedSigner {
-  private config: DappKitSignerConfig;
-
-  constructor(config: DappKitSignerConfig) {
-    if (!config.address) {
-      throw new Error('DappKitSigner requires an address');
-    }
-    if (!config.client) {
-      throw new Error('DappKitSigner requires a SuiClient');
-    }
-    if (!config.signAndExecuteTransaction) {
-      throw new Error('DappKitSigner requires signAndExecuteTransaction function');
-    }
-    this.config = config;
-  }
-
-  /**
-   * Sign and execute transaction using dApp-kit hook
-   *
-   * Wraps the dApp-kit signAndExecuteTransaction function and waits for
-   * transaction finalization to prevent gas coin version conflicts.
-   */
-  async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
-    const result = await this.config.signAndExecuteTransaction({ transaction });
-
-    // Wait for transaction to be finalized (important for gas coin versioning)
-    if (result.digest) {
-      try {
-        await this.config.client.waitForTransaction({ digest: result.digest });
-      } catch (waitError) {
-        console.warn('DappKitSigner: waitForTransaction failed:', waitError);
-        // Continue anyway - transaction was submitted
-      }
-    }
-
-    return {
-      digest: result.digest,
-      effects: result.effects,
-      events: result.events,
-      objectChanges: result.objectChanges,
-    };
-  }
-
-  /**
-   * Sign personal message using dApp-kit hook
-   *
-   * Required for SEAL encryption identity and other message signing operations.
-   */
-  async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
-    if (!this.config.signPersonalMessage) {
-      throw new Error(
-        'DappKitSigner: signPersonalMessage not configured. ' +
-        'Pass signPersonalMessage function from useSignPersonalMessage().mutateAsync'
-      );
-    }
-
-    const result = await this.config.signPersonalMessage({ message });
-
-    return {
-      signature: result.signature,
-      bytes: result.bytes || message,
-    };
-  }
-
-  /**
-   * Get Sui address
-   */
-  getAddress(): string {
-    return this.config.address;
-  }
-
-  /**
-   * Get public key (if available)
-   */
-  getPublicKey(): Uint8Array | null {
-    return this.config.publicKey || null;
-  }
-
-  /**
-   * Get underlying Signer
-   *
-   * Note: dApp-kit does not expose the underlying Signer for security reasons.
-   * Use KeypairSigner for backend/Node.js environments that need raw Signer access.
-   */
-  getSigner(): Signer {
-    throw new Error(
-      'DappKitSigner does not expose underlying Signer. ' +
-      'Browser wallets do not provide raw Signer access for security. ' +
-      'Use KeypairSigner for backend/Node.js environments.'
-    );
-  }
-
-  /**
-   * Get SuiClient
-   *
-   * Returns the SuiClient instance for managers that need to build transactions.
-   */
-  getClient(): SuiClient {
-    return this.config.client;
-  }
-}
+/**
+ * DappKit Signer Implementation
+ *
+ * Adapter for @mysten/dapp-kit hooks to work with SimplePDWClient.
+ * Bridges dApp-kit's hook-based API with SDK's UnifiedSigner interface.
+ *
+ * @example
+ * ```typescript
+ * import { DappKitSigner, createSimplePDWClient } from '@cmdoss/memwal-sdk';
+ * import { useCurrentAccount, useSignAndExecuteTransaction, useSuiClient } from '@mysten/dapp-kit';
+ *
+ * function MyComponent() {
+ *   const account = useCurrentAccount();
+ *   const client = useSuiClient();
+ *   const { mutateAsync: signAndExecute } = useSignAndExecuteTransaction();
+ *
+ *   const signer = useMemo(() => {
+ *     if (!account) return null;
+ *     return new DappKitSigner({
+ *       address: account.address,
+ *       client,
+ *       signAndExecuteTransaction: signAndExecute,
+ *     });
+ *   }, [account, client, signAndExecute]);
+ *
+ *   // Now use signer with SDK
+ *   const pdw = await createSimplePDWClient({ signer, network: 'testnet' });
+ * }
+ * ```
+ *
+ * @module client/signers
+ */
+
+import type { Transaction } from '@mysten/sui/transactions';
+import type { SuiClient } from '@mysten/sui/client';
+import type { Signer } from '@mysten/sui/cryptography';
+import type {
+  UnifiedSigner,
+  SignAndExecuteResult,
+  SignPersonalMessageResult
+} from './UnifiedSigner';
+
+/**
+ * Function signature for dApp-kit's signAndExecuteTransaction
+ * Compatible with useSignAndExecuteTransaction().mutateAsync
+ */
+export interface DappKitSignAndExecuteFn {
+  (params: { transaction: Transaction }): Promise<{
+    digest: string;
+    effects?: any;
+    events?: any[];
+    objectChanges?: any[];
+  }>;
+}
+
+/**
+ * Function signature for dApp-kit's signPersonalMessage
+ * Compatible with useSignPersonalMessage().mutateAsync
+ */
+export interface DappKitSignPersonalMessageFn {
+  (params: { message: Uint8Array }): Promise<{
+    signature: string;
+    bytes?: Uint8Array;
+  }>;
+}
+
+/**
+ * Configuration for DappKitSigner
+ */
+export interface DappKitSignerConfig {
+  /**
+   * User's Sui address (from useCurrentAccount().address)
+   */
+  address: string;
+
+  /**
+   * SuiClient instance (from useSuiClient())
+   */
+  client: SuiClient;
+
+  /**
+   * signAndExecuteTransaction function (from useSignAndExecuteTransaction().mutateAsync)
+   */
+  signAndExecuteTransaction: DappKitSignAndExecuteFn;
+
+  /**
+   * signPersonalMessage function (from useSignPersonalMessage().mutateAsync)
+   * Optional - only required for operations that need message signing
+   */
+  signPersonalMessage?: DappKitSignPersonalMessageFn;
+
+  /**
+   * Public key bytes (optional, from useCurrentAccount().publicKey)
+   */
+  publicKey?: Uint8Array;
+}
+
+/**
+ * DappKitSigner - Adapter for @mysten/dapp-kit hooks
+ *
+ * Wraps dApp-kit's useSignAndExecuteTransaction and useSignPersonalMessage hooks
+ * to provide a UnifiedSigner interface compatible with SDK managers.
+ *
+ * This adapter does NOT depend on React - it accepts function references
+ * that can come from dApp-kit hooks or any other source with compatible signatures.
+ */
+export class DappKitSigner implements UnifiedSigner {
+  private config: DappKitSignerConfig;
+
+  constructor(config: DappKitSignerConfig) {
+    if (!config.address) {
+      throw new Error('DappKitSigner requires an address');
+    }
+    if (!config.client) {
+      throw new Error('DappKitSigner requires a SuiClient');
+    }
+    if (!config.signAndExecuteTransaction) {
+      throw new Error('DappKitSigner requires signAndExecuteTransaction function');
+    }
+    this.config = config;
+  }
+
+  /**
+   * Sign and execute transaction using dApp-kit hook
+   *
+   * Wraps the dApp-kit signAndExecuteTransaction function and waits for
+   * transaction finalization to prevent gas coin version conflicts.
+   */
+  async signAndExecuteTransaction(transaction: Transaction): Promise<SignAndExecuteResult> {
+    const result = await this.config.signAndExecuteTransaction({ transaction });
+
+    // Wait for transaction to be finalized (important for gas coin versioning)
+    if (result.digest) {
+      try {
+        await this.config.client.waitForTransaction({ digest: result.digest });
+      } catch (waitError) {
+        console.warn('DappKitSigner: waitForTransaction failed:', waitError);
+        // Continue anyway - transaction was submitted
+      }
+    }
+
+    return {
+      digest: result.digest,
+      effects: result.effects,
+      events: result.events,
+      objectChanges: result.objectChanges,
+    };
+  }
+
+  /**
+   * Sign personal message using dApp-kit hook
+   *
+   * Required for SEAL encryption identity and other message signing operations.
+   */
+  async signPersonalMessage(message: Uint8Array): Promise<SignPersonalMessageResult> {
+    if (!this.config.signPersonalMessage) {
+      throw new Error(
+        'DappKitSigner: signPersonalMessage not configured. ' +
+        'Pass signPersonalMessage function from useSignPersonalMessage().mutateAsync'
+      );
+    }
+
+    const result = await this.config.signPersonalMessage({ message });
+
+    return {
+      signature: result.signature,
+      bytes: result.bytes || message,
+    };
+  }
+
+  /**
+   * Get Sui address
+   */
+  getAddress(): string {
+    return this.config.address;
+  }
+
+  /**
+   * Get public key (if available)
+   */
+  getPublicKey(): Uint8Array | null {
+    return this.config.publicKey || null;
+  }
+
+  /**
+   * Get underlying Signer
+   *
+   * Note: dApp-kit does not expose the underlying Signer for security reasons.
+   * Use KeypairSigner for backend/Node.js environments that need raw Signer access.
+   */
+  getSigner(): Signer {
+    throw new Error(
+      'DappKitSigner does not expose underlying Signer. ' +
+      'Browser wallets do not provide raw Signer access for security. ' +
+      'Use KeypairSigner for backend/Node.js environments.'
+    );
+  }
+
+  /**
+   * Get SuiClient
+   *
+   * Returns the SuiClient instance for managers that need to build transactions.
+   */
+  getClient(): SuiClient {
+    return this.config.client;
+  }
+}

package/src/core/types/index.ts

@@ -232,7 +232,7 @@ export interface VectorEmbedding {
 
 export interface EmbeddingOptions {
   model?: string;
-  dimension?: number; // Default 768 for Gemini
+  dimension?: number; // Default 3072 for Gemini
   normalize?: boolean;
   batchSize?: number; // For batch processing
 }

package/src/generated/pdw/deps/sui/object.ts

@@ -1,13 +1,13 @@
-/**************************************************************
- * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
- **************************************************************/
-
-
-/** Sui object identifiers */
-
-import { MoveStruct } from '../../../utils/index.js';
-import { bcs } from '@mysten/sui/bcs';
-const $moduleName = '0x2::object';
-export const UID = new MoveStruct({ name: `${$moduleName}::UID`, fields: {
-        id: bcs.Address
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+
+
+/** Sui object identifiers */
+
+import { MoveStruct } from '../../../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+const $moduleName = '0x2::object';
+export const UID = new MoveStruct({ name: `${$moduleName}::UID`, fields: {
+        id: bcs.Address
     } });