memwal

分类: 数据与AI | 上传者: MystenLabs | 下载: 0 | 版本: v1.0（最新）

隐私优先的 AI 内存 SDK，用于与 Walrus 一起在 Sui 区块链上进行去中心化存储。

更新日志: Source: GitHub https://github.com/MystenLabs/MemWal

目录结构

当前层级: tree/dev/

📁 .changeset/
- 📄 config.json 407 B
- 📄 README.md 731 B
📁 .github/
- 📁 workflows/
  - 📄 deploy-app-walrus.yml 3.5 KB
  - 📄 release-oc-memwal.yml 6.0 KB
  - 📄 release-sdk.yml 5.9 KB
📁 apps/
- 📁 app/
  - 📁 public/
    
    📁 fonts/
    
    📄 Ratch-Variable.ttf 119.2 KB
    
    📄 android-chrome-192x192.png 2.1 KB
    
    📄 android-chrome-512x512.png 9.6 KB
    
    📄 apple-touch-icon.png 1.9 KB
    
    📄 favicon-16x16.png 296 B
    
    📄 favicon-32x32.png 383 B
    
    📄 favicon.ico 405 B
    
    📄 memwal-grid-bg.png 150.0 KB
    
    📄 memwal-hero-full.png 645.5 KB
    
    📄 memwal-icon.svg 499 B
    
    📄 memwal-mascot.png 446.1 KB
    
    📄 og-image.jpg 294.7 KB
    
    📄 site.webmanifest 327 B
  - 📁 scripts/
    
    📄 recolor_icons.py 2.0 KB
  - 📁 src/
    
    📁 assets/
    
    📄 memwal-logo.svg 4.6 KB
    
    📁 hooks/
    
    📄 useSponsoredTransaction.ts 3.7 KB
    
    📁 pages/
    
    📄 Dashboard.tsx 28.6 KB
    
    📄 LandingPage.tsx 6.6 KB
    
    📄 Playground.tsx 41.4 KB
    
    📄 SetupWizard.tsx 17.8 KB
    
    📄 walrus.jpg 16.6 KB
    
    📁 utils/
    
    📄 api.ts 2.5 KB
    
    📄 App.tsx 5.4 KB
    
    📄 config.ts 1.3 KB
    
    📄 index.css 25.3 KB
    
    📄 main.tsx 230 B
  - 📄 .dockerignore 46 B
  - 📄 .env.example 2.4 KB
  - 📄 .gitignore 265 B
  - 📄 Dockerfile 2.1 KB
  - 📄 eslint.config.js 616 B
  - 📄 index.html 1.6 KB
  - 📄 package-lock.json 212.4 KB
  - 📄 package.json 1.6 KB
  - 📄 railway.json 413 B
  - 📄 README.md 2.5 KB
  - 📄 tsconfig.app.json 732 B
  - 📄 tsconfig.json 119 B
  - 📄 tsconfig.node.json 653 B
  - 📄 vite.config.ts 461 B
  - 📄 ws-resources.json 156 B
- 📁 chatbot/
  - 📁 .cursor/
    
    📁 rules/
    
    📄 ultracite.mdc 16.4 KB
  - 📁 .github/
    
    📁 workflows/
    
    📄 lint.yml 552 B
    
    📄 playwright.yml 1.9 KB
  - 📁 .vscode/
    
    📄 extensions.json 43 B
    
    📄 settings.json 1.3 KB
  - 📁 app/
    
    📁 (auth)/
    
    📁 api/
    
    📁 auth/
    
    📁 [...nextauth]/
    
    📄 route.ts 202 B
    
    📁 guest/
    
    📄 route.ts 643 B
    
    📁 login/
    
    📄 page.tsx 2.5 KB
    
    📁 register/
    
    📄 page.tsx 2.7 KB
    
    📄 actions.ts 1.8 KB
    
    📄 auth.config.ts 356 B
    
    📄 auth.ts 2.0 KB
    
    📁 (chat)/
    
    📁 api/
    
    📁 chat/
    
    📁 [id]/
    
    📁 stream/
    
    📄 route.ts 72 B
    
    📄 route.ts 10.0 KB
    
    📄 schema.ts 1.2 KB
    
    📁 document/
    
    📄 route.ts 2.8 KB
    
    📁 files/
    
    📁 upload/
    
    📄 route.ts 1.9 KB
    
    📁 history/
    
    📄 route.ts 1.2 KB
    
    📁 suggestions/
    
    📄 route.ts 931 B
    
    📁 vote/
    
    📄 route.ts 1.7 KB
    
    📁 chat/
    
    📁 [id]/
    
    📄 page.tsx 2.0 KB
    
    📄 actions.ts 1.3 KB
    
    📄 layout.tsx 1.2 KB
    
    📄 opengraph-image.png 14.1 KB
    
    📄 page.tsx 1.2 KB
    
    📄 twitter-image.png 50.8 KB
    
    📄 favicon.ico 15.0 KB
    
    📄 globals.css 7.8 KB
    
    📄 layout.tsx 2.6 KB
  - 📁 artifacts/
    
    📁 code/
    
    📄 client.tsx 7.2 KB
    
    📄 server.ts 1.7 KB
    
    📁 image/
    
    📄 client.tsx 2.0 KB
    
    📁 sheet/
    
    📄 client.tsx 2.9 KB
    
    📄 server.ts 1.9 KB
    
    📁 text/
    
    📄 client.tsx 4.6 KB
    
    📄 server.ts 1.8 KB
    
    📄 actions.ts 260 B
  - 📁 components/
    
    📁 ai-elements/
    
    📄 artifact.tsx 3.3 KB
    
    📄 canvas.tsx 547 B
    
    📄 chain-of-thought.tsx 6.2 KB
    
    📄 checkpoint.tsx 1.6 KB
    
    📄 confirmation.tsx 3.7 KB
    
    📄 connection.tsx 570 B
    
    📄 controls.tsx 573 B
    
    📄 conversation.tsx 2.4 KB
    
    📄 edge.tsx 3.1 KB
    
    📄 image.tsx 565 B
    
    📄 inline-citation.tsx 6.4 KB
    
    📄 loader.tsx 2.1 KB
    
    📄 message.tsx 10.6 KB
    
    📄 model-selector.tsx 4.7 KB
    
    📄 node.tsx 1.9 KB
    
    📄 open-in-chat.tsx 16.1 KB
    
    📄 panel.tsx 401 B
    
    📄 plan.tsx 3.4 KB
    
    📄 prompt-input.tsx 37.1 KB
    
    📄 queue.tsx 6.2 KB
    
    📄 reasoning.tsx 5.3 KB
    
    📄 shimmer.tsx 1.5 KB
    
    📄 sources.tsx 1.8 KB
    
    📄 suggestion.tsx 1.2 KB
    
    📄 task.tsx 2.3 KB
    
    📄 tool.tsx 4.8 KB
    
    📄 toolbar.tsx 442 B
    
    📄 web-preview.tsx 6.5 KB
    
    📁 elements/
    
    📄 actions.tsx 1.3 KB
    
    📄 branch.tsx 5.1 KB
    
    📄 conversation.tsx 1.6 KB
    
    📄 image.tsx 565 B
    
    📄 inline-citation.tsx 6.4 KB
    
    📄 loader.tsx 2.1 KB
    
    📄 message.tsx 1.5 KB
    
    📄 prompt-input.tsx 5.6 KB
    
    📄 reasoning.tsx 5.0 KB
    
    📄 response.tsx 569 B
    
    📄 source.tsx 1.8 KB
    
    📄 suggestion.tsx 1.2 KB
    
    📄 task.tsx 2.5 KB
    
    📄 tool.tsx 4.3 KB
    
    📄 web-preview.tsx 6.2 KB
    
    📁 ui/
    
    📄 alert-dialog.tsx 4.2 KB
    
    📄 alert.tsx 1.5 KB
    
    📄 avatar.tsx 1.4 KB
    
    📄 badge.tsx 1.1 KB
    
    📄 button-group.tsx 2.2 KB
    
    📄 button.tsx 1.9 KB
    
    📄 card.tsx 2.1 KB
    
    📄 carousel.tsx 6.1 KB
    
    📄 collapsible.tsx 324 B
    
    📄 command.tsx 4.8 KB
    
    📄 dialog.tsx 3.6 KB
    
    📄 dropdown-menu.tsx 7.4 KB
    
    📄 hover-card.tsx 1.2 KB
    
    📄 input-group.tsx 4.9 KB
    
    📄 input.tsx 791 B
    
    📄 label.tsx 719 B
    
    📄 progress.tsx 786 B
    
    📄 scroll-area.tsx 1.6 KB
    
    📄 select.tsx 5.6 KB
    
    📄 separator.tsx 765 B
    
    📄 sheet.tsx 4.2 KB
    
    📄 sidebar.tsx 23.3 KB
    
    📄 skeleton.tsx 261 B
    
    📄 textarea.tsx 689 B
    
    📄 tooltip.tsx 1.2 KB
    
    📄 app-sidebar.tsx 4.7 KB
    
    📄 artifact-actions.tsx 3.0 KB
    
    📄 artifact-close-button.tsx 826 B
    
    📄 artifact-messages.tsx 3.1 KB
    
    📄 artifact.tsx 16.2 KB
    
    📄 auth-form.tsx 1.3 KB
    
    📄 chat-header.tsx 1.7 KB
    
    📄 chat.tsx 10.9 KB
    
    📄 code-editor.tsx 3.3 KB
    
    📄 console.tsx 6.2 KB
    
    📄 create-artifact.tsx 2.9 KB
    
    📄 data-stream-handler.tsx 2.4 KB
    
    📄 data-stream-provider.tsx 1.0 KB
    
    📄 diffview.tsx 2.8 KB
    
    📄 document-preview.tsx 8.1 KB
    
    📄 document-skeleton.tsx 1.7 KB
    
    📄 document.tsx 4.3 KB
    
    📄 greeting.tsx 800 B
    
    📄 icons.tsx 54.7 KB
    
    📄 image-editor.tsx 1.1 KB
    
    📄 message-actions.tsx 4.9 KB
    
    📄 message-editor.tsx 2.9 KB
    
    📄 message-reasoning.tsx 736 B
    
    📄 message.tsx 14.9 KB
    
    📄 messages.tsx 3.5 KB
    
    📄 multimodal-input.tsx 22.4 KB
    
    📄 preview-attachment.tsx 1.7 KB
    
    📄 sheet-editor.tsx 3.8 KB
    
    📄 sidebar-history-item.tsx 3.6 KB
    
    📄 sidebar-history.tsx 11.5 KB
    
    📄 sidebar-toggle.tsx 930 B
    
    📄 sidebar-user-nav.tsx 3.9 KB
    
    📄 sign-out-form.tsx 446 B
    
    📄 submit-button.tsx 814 B
    
    📄 suggested-actions.tsx 1.9 KB
    
    📄 suggestion.tsx 2.4 KB
    
    📄 text-editor.tsx 4.3 KB
    
    📄 theme-provider.tsx 300 B
    
    📄 toast.tsx 1.9 KB
    
    📄 toolbar.tsx 12.8 KB
    
    📄 version-footer.tsx 3.0 KB
    
    📄 visibility-selector.tsx 3.0 KB
    
    📄 weather.tsx 11.5 KB
  - 📁 hooks/
    
    📄 use-artifact.ts 2.0 KB
    
    📄 use-auto-resume.ts 1.3 KB
    
    📄 use-chat-visibility.ts 1.4 KB
    
    📄 use-messages.tsx 770 B
    
    📄 use-mobile.ts 565 B
    
    📄 use-scroll-to-bottom.tsx 3.2 KB
  - 📁 lib/
    
    📁 ai/
    
    📁 tools/
    
    📄 create-document.ts 1.9 KB
    
    📄 get-weather.ts 2.1 KB
    
    📄 request-suggestions.ts 3.6 KB
    
    📄 save-memory.ts 1.6 KB
    
    📄 update-document.ts 1.7 KB
    
    📄 entitlements.ts 432 B
    
    📄 models.mock.ts 5.1 KB
    
    📄 models.test.ts 2.1 KB
    
    📄 models.ts 1.7 KB
    
    📄 prompts.ts 5.4 KB
    
    📄 providers.ts 2.7 KB
    
    📁 artifacts/
    
    📄 server.ts 2.7 KB
    
    📁 db/
    
    📁 helpers/
    
    📄 01-core-to-parts.ts 7.5 KB
    
    📁 migrations/
    
    📁 meta/
    
    📄 0000_snapshot.json 2.0 KB
    
    📄 0001_snapshot.json 5.9 KB
    
    📄 0002_snapshot.json 8.5 KB
    
    📄 0003_snapshot.json 8.6 KB
    
    📄 0004_snapshot.json 8.8 KB
    
    📄 0005_snapshot.json 11.6 KB
    
    📄 0006_snapshot.json 12.7 KB
    
    📄 0007_snapshot.json 12.8 KB
    
    📄 0008_snapshot.json 12.7 KB
    
    📄 _journal.json 1.3 KB
    
    📄 0000_keen_devos.sql 606 B
    
    📄 0001_sparkling_blue_marvel.sql 1.5 KB
    
    📄 0002_wandering_riptide.sql 1.3 KB
    
    📄 0003_cloudy_glorian.sql 78 B
    
    📄 0004_odd_slayback.sql 73 B
    
    📄 0005_wooden_whistler.sql 1.2 KB
    
    📄 0006_marvelous_frog_thor.sql 441 B
    
    📄 0007_flowery_ben_parker.sql 50 B
    
    📄 0008_flat_forgotten_one.sql 55 B
    
    📄 migrate.ts 856 B
    
    📄 queries.ts 13.1 KB
    
    📄 schema.ts 4.6 KB
    
    📄 utils.ts 398 B
    
    📁 editor/
    
    📄 config.ts 1.4 KB
    
    📄 diff.js 12.9 KB
    
    📄 functions.tsx 1.7 KB
    
    📄 react-renderer.tsx 342 B
    
    📄 suggestions.tsx 3.8 KB
    
    📄 constants.ts 456 B
    
    📄 errors.ts 3.9 KB
    
    📄 ratelimit.ts 1.1 KB
    
    📄 types.ts 1.6 KB
    
    📄 utils.ts 3.0 KB
  - 📁 public/
    
    📁 images/
    
    📄 demo-thumbnail.png 22.7 KB
    
    📄 mouth of the seine, monet.jpg 32.7 KB
    
    📄 memwal-icon.png 1.0 KB
  - 📁 tests/
    
    📁 e2e/
    
    📄 api.test.ts 2.9 KB
    
    📄 auth.test.ts 1.3 KB
    
    📄 chat.test.ts 2.0 KB
    
    📄 model-selector.test.ts 2.6 KB
    
    📁 pages/
    
    📄 chat.ts 1.5 KB
    
    📁 prompts/
    
    📄 utils.ts 903 B
    
    📄 fixtures.ts 358 B
    
    📄 helpers.ts 342 B
  - 📄 .dockerignore 158 B
  - 📄 .env.example 679 B
  - 📄 .gitignore 485 B
  - 📄 biome.jsonc 1.3 KB
  - 📄 components.json 396 B
  - 📄 docker-compose.yml 487 B
  - 📄 Dockerfile 3.4 KB
  - 📄 drizzle.config.ts 351 B
  - 📄 instrumentation-client.ts 287 B
  - 📄 instrumentation.ts 121 B
  - 📄 LICENSE 552 B
  - 📄 next.config.ts 699 B
  - 📄 package.json 4.0 KB
  - 📄 playwright.config.ts 2.5 KB
  - 📄 pnpm-lock.yaml 292.9 KB
  - 📄 postcss.config.mjs 146 B
  - 📄 proxy.ts 1.5 KB
  - 📄 railway.json 421 B
  - 📄 README.md 3.4 KB
  - 📄 tsconfig.json 806 B
  - 📄 vercel-template.json 330 B
  - 📄 vercel.json 28 B
- 📁 noter/
  - 📁 app/
    
    📁 ai/
    
    📁 [id]/
    
    📄 page.tsx 313 B
    
    📄 layout.tsx 370 B
    
    📄 page.tsx 505 B
    
    📁 api/
    
    📁 chat/
    
    📄 route.ts 5.5 KB
    
    📁 memory/
    
    📁 health/
    
    📄 route.ts 851 B
    
    📁 remember/
    
    📄 route.ts 986 B
    
    📁 set-key/
    
    📄 route.ts 816 B
    
    📁 trpc/
    
    📁 [trpc]/
    
    📄 route.ts 365 B
    
    📁 auth/
    
    📁 callback/
    
    📄 page.tsx 3.2 KB
    
    📁 components/
    
    📄 app-float.tsx 9.9 KB
    
    📄 appearance-float.tsx 1.9 KB
    
    📄 providers.tsx 690 B
    
    📄 sidebar-float.tsx 2.6 KB
    
    📄 user-float.tsx 8.1 KB
    
    📁 note/
    
    📁 [id]/
    
    📄 page.tsx 1.0 KB
    
    📄 page.tsx 2.7 KB
    
    📄 favicon.ico 25.3 KB
    
    📄 layout.tsx 917 B
    
    📄 page.tsx 2.8 KB
  - 📁 doc/
    
    📄 architecture.md 5.5 KB
    
    📄 type-flow.md 6.4 KB
    
    📄 zklogin-integration.md 6.7 KB
  - 📁 lib/
    
    📄 empty.js 57 B
  - 📁 package/
    
    📁 feature/
    
    📁 auth/
    
    📁 api/
    
    📄 form.ts 2.2 KB
    
    📄 input.ts 3.4 KB
    
    📄 route.ts 8.8 KB
    
    📁 domain/
    
    📄 service.ts 6.7 KB
    
    📄 type.ts 4.9 KB
    
    📄 zklogin.ts 7.4 KB
    
    📁 hook/
    
    📄 use-auth.ts 5.5 KB
    
    📁 lib/
    
    📄 wallet-client.ts 5.2 KB
    
    📄 wallet-verify.ts 1.2 KB
    
    📄 zklogin-client.ts 7.9 KB
    
    📁 state/
    
    📄 atom.ts 3.3 KB
    
    📁 ui/
    
    📄 auth-button-group.tsx 2.9 KB
    
    📄 auth-guard.tsx 990 B
    
    📄 login-button.tsx 1.1 KB
    
    📄 user-menu.tsx 2.5 KB
    
    📄 wallet-button.tsx 2.7 KB
    
    📄 constant.ts 2.9 KB
    
    📄 index.ts 1.3 KB
    
    📁 chat/
    
    📁 api/
    
    📄 form.ts 2.6 KB
    
    📄 input.ts 2.7 KB
    
    📄 route.ts 2.9 KB
    
    📁 domain/
    
    📄 ai.ts 2.9 KB
    
    📄 service.ts 4.0 KB
    
    📄 type.ts 959 B
    
    📁 hook/
    
    📄 use-chat.ts 4.2 KB
    
    📁 state/
    
    📄 atom.ts 585 B
    
    📁 ui/
    
    📁 tools/
    
    📄 tool-get-balances.tsx 4.1 KB
    
    📄 tool-get-coin-history.tsx 6.5 KB
    
    📄 tool-get-transactions.tsx 4.0 KB
    
    📄 tool-get-user-info.tsx 2.9 KB
    
    📄 tool-show-diagram.tsx 986 B
    
    📄 ai-tool-ui.tsx 2.3 KB
    
    📄 chat-input.tsx 1.3 KB
    
    📄 chat-sidebar.tsx 2.4 KB
    
    📄 chat.tsx 2.1 KB
    
    📄 message-list.tsx 2.4 KB
    
    📄 message.tsx 1.9 KB
    
    📄 model-selector.tsx 979 B
    
    📄 tool-badge.tsx 1.1 KB
    
    📄 tools-used-bar.tsx 1.6 KB
    
    📄 index.ts 1.3 KB
    
    📁 editor/
    
    📁 config/
    
    📄 markdown-transformers.ts 332 B
    
    📁 nodes/
    
    📄 CoinMentionNode.tsx 6.9 KB
    
    📁 plugins/
    
    📁 CoinMentionPlugin/
    
    📄 index.tsx 8.5 KB
    
    📄 CodeHighlightPlugin.tsx 494 B
    
    📁 themes/
    
    📄 ChatEditorTheme.css 12.9 KB
    
    📄 ChatEditorTheme.ts 2.8 KB
    
    📁 ui/
    
    📄 chat-editor.tsx 7.4 KB
    
    📄 chat-renderer.tsx 6.9 KB
    
    📄 constant.ts 1.4 KB
    
    📄 index.ts 546 B
    
    📄 README.md 5.1 KB
    
    📄 style.css 1002 B
    
    📁 memory/
    
    📁 api/
    
    📄 route.ts 1.7 KB
    
    📄 index.ts 190 B
    
    📁 note/
    
    📁 api/
    
    📄 form.ts 974 B
    
    📄 input.ts 2.7 KB
    
    📄 route.ts 5.7 KB
    
    📁 domain/
    
    📄 note.ts 2.9 KB
    
    📄 type.ts 3.3 KB
    
    📁 hook/
    
    📄 use-note-list.ts 851 B
    
    📄 use-note-memory-detect.ts 1.5 KB
    
    📄 use-note-memory-save.ts 2.7 KB
    
    📄 use-note.ts 1.6 KB
    
    📄 use-pdw-client.ts 602 B
    
    📁 lib/
    
    📄 lexical-utils.ts 3.4 KB
    
    📄 memory-detector.ts 2.1 KB
    
    📄 pdw-client.ts 2.4 KB
    
    📁 nodes/
    
    📄 MemoryHighlightNode.ts 10.8 KB
    
    📁 plugins/
    
    📄 MemoryHighlightPlugin-simple.tsx 3.4 KB
    
    📄 MemoryHighlightPlugin.tsx 17.0 KB
    
    📁 state/
    
    📄 atom.ts 398 B
    
    📁 styles/
    
    📄 memory-highlight.css 7.8 KB
    
    📁 ui/
    
    📄 memory-detect-button.tsx 1008 B
    
    📄 memory-hover-preview.tsx 8.2 KB
    
    📄 memory-panel-enhanced.tsx 18.2 KB
    
    📄 note-editor.tsx 7.9 KB
    
    📄 note-list.tsx 11.8 KB
    
    📄 pdw-status-indicator.tsx 2.1 KB
    
    📄 index.ts 3.0 KB
    
    📁 shared/
    
    📁 components/
    
    📁 ui/
    
    📄 accordion.tsx 2.0 KB
    
    📄 alert-dialog.tsx 5.3 KB
    
    📄 alert.tsx 1.6 KB
    
    📄 aspect-ratio.tsx 274 B
    
    📄 avatar.tsx 2.9 KB
    
    📄 badge.tsx 1.7 KB
    
    📄 breadcrumb.tsx 2.3 KB
    
    📄 button-group.tsx 2.2 KB
    
    📄 button.tsx 2.3 KB
    
    📄 calendar.tsx 7.6 KB
    
    📄 card.tsx 1.9 KB
    
    📄 carousel.tsx 5.4 KB
    
    📄 chart.tsx 9.8 KB
    
    📄 checkbox.tsx 1.2 KB
    
    📄 collapsible.tsx 795 B
    
    📄 combobox.tsx 9.0 KB
    
    📄 command.tsx 4.7 KB
    
    📄 context-menu.tsx 8.1 KB
    
    📄 dialog.tsx 4.2 KB
    
    📄 direction.tsx 506 B
    
    📄 drawer.tsx 4.2 KB
    
    📄 dropdown-menu.tsx 8.2 KB
    
    📄 empty.tsx 2.3 KB
    
    📄 field.tsx 6.0 KB
    
    📄 form.tsx 3.7 KB
    
    📄 hover-card.tsx 1.5 KB
    
    📄 input-group.tsx 5.0 KB
    
    📄 input-otp.tsx 2.2 KB
    
    📄 input.tsx 969 B
    
    📄 item.tsx 4.4 KB
    
    📄 kbd.tsx 869 B
    
    📄 label.tsx 613 B
    
    📄 menubar.tsx 8.2 KB
    
    📄 native-select.tsx 1.8 KB
    
    📄 navigation-menu.tsx 6.5 KB
    
    📄 pagination.tsx 2.7 KB
    
    📄 popover.tsx 2.3 KB
    
    📄 progress.tsx 742 B
    
    📄 radio-group.tsx 1.4 KB
    
    📄 resizable.tsx 1.8 KB
    
    📄 scroll-area.tsx 1.6 KB
    
    📄 select.tsx 6.2 KB
    
    📄 separator.tsx 701 B
    
    📄 sheet.tsx 4.1 KB
    
    📄 sidebar.tsx 21.2 KB
    
    📄 skeleton.tsx 283 B
    
    📄 slider.tsx 2.0 KB
    
    📄 sonner.tsx 1.0 KB
    
    📄 spinner.tsx 338 B
    
    📄 switch.tsx 1.4 KB
    
    📄 table.tsx 2.4 KB
    
    📄 tabs.tsx 3.7 KB
    
    📄 textarea.tsx 766 B
    
    📄 toggle-group.tsx 2.3 KB
    
    📄 toggle.tsx 1.5 KB
    
    📄 tooltip.tsx 1.8 KB
    
    📄 border.tsx 491 B
    
    📁 db/
    
    📁 migrations/
    
    📁 meta/
    
    📄 0000_snapshot.json 12.6 KB
    
    📄 0001_snapshot.json 26.0 KB
    
    📄 _journal.json 352 B
    
    📄 0000_curly_karen_page.sql 2.9 KB
    
    📄 0001_flat_amazoness.sql 3.9 KB
    
    📄 relations.ts 3.4 KB
    
    📄 schema.ts 13.6 KB
    
    📄 type.ts 5.6 KB
    
    📁 hook/
    
    📄 use-mobile.ts 565 B
    
    📁 lib/
    
    📁 ai/
    
    📁 tools/
    
    📄 index.ts 37.9 KB
    
    📄 constant.ts 548 B
    
    📄 index.ts 107 B
    
    📄 provider.ts 300 B
    
    📁 db/
    
    📄 index.ts 376 B
    
    📄 migrate.ts 731 B
    
    📁 trpc/
    
    📄 client.ts 162 B
    
    📄 init.ts 2.3 KB
    
    📄 provider.tsx 2.1 KB
    
    📄 router.ts 423 B
    
    📄 utils.ts 166 B
    
    📁 style/
    
    📄 globals.css 6.4 KB
    
    📁 util/
    
    📄 color.ts 5.7 KB
  - 📁 public/
    
    📄 bgr-1.webp 726.0 KB
    
    📄 bgr-2.webp 644.3 KB
    
    📄 bgr-3.webp 757.8 KB
    
    📄 nautilus-flow.svg 443.9 KB
    
    📄 seal-flow.svg 261.6 KB
    
    📄 walrus-flow.svg 206.9 KB
    
    📄 zk-login-flow.svg 163.5 KB
  - 📁 scripts/
    
    📄 reset-db.ts 543 B
  - 📄 .gitignore 480 B
  - 📄 components.json 514 B
  - 📄 docker-compose.yml 474 B
  - 📄 Dockerfile 2.9 KB
  - 📄 drizzle.config.ts 286 B
  - 📄 eslint.config.mjs 465 B
  - 📄 next.config.ts 370 B
  - 📄 package.json 2.6 KB
  - 📄 pnpm-lock.yaml 422.7 KB
  - 📄 postcss.config.mjs 94 B
  - 📄 railway.json 450 B
  - 📄 README.md 6.2 KB
  - 📄 tsconfig.json 756 B
- 📁 researcher/
  - 📁 .vscode/
    
    📄 extensions.json 43 B
    
    📄 settings.json 1.3 KB
  - 📁 app/
    
    📁 (auth)/
    
    📁 login/
    
    📄 page.tsx 5.4 KB
    
    📁 (chat)/
    
    📁 api/
    
    📁 chat/
    
    📁 [id]/
    
    📁 stream/
    
    📄 route.ts 72 B
    
    📄 route.ts 12.9 KB
    
    📄 schema.ts 1.1 KB
    
    📁 files/
    
    📁 upload/
    
    📄 route.ts 1.9 KB
    
    📁 history/
    
    📄 route.ts 1.2 KB
    
    📁 chat/
    
    📁 [id]/
    
    📄 page.tsx 2.3 KB
    
    📄 actions.ts 1.3 KB
    
    📄 layout.tsx 1.3 KB
    
    📄 opengraph-image.png 14.1 KB
    
    📄 page.tsx 944 B
    
    📄 twitter-image.png 50.8 KB
    
    📁 api/
    
    📁 auth/
    
    📁 key/
    
    📄 route.ts 1.7 KB
    
    📁 signout/
    
    📄 route.ts 152 B
    
    📁 research/
    
    📁 process-source/
    
    📄 route.ts 2.7 KB
    
    📁 sources/
    
    📄 route.ts 435 B
    
    📁 sprint/
    
    📁 list/
    
    📄 route.ts 694 B
    
    📁 prepare/
    
    📄 route.ts 10.4 KB
    
    📁 save/
    
    📄 route.ts 6.8 KB
    
    📁 status/
    
    📄 route.ts 1.4 KB
    
    📁 suggestions/
    
    📄 route.ts 2.6 KB
    
    📁 research/
    
    📁 new/
    
    📄 layout.tsx 120 B
    
    📄 page.tsx 1.0 KB
    
    📄 favicon.ico 15.0 KB
    
    📄 globals.css 7.8 KB
    
    📄 layout.tsx 2.4 KB
  - 📁 components/
    
    📁 ai-elements/
    
    📄 artifact.tsx 3.3 KB
    
    📄 canvas.tsx 547 B
    
    📄 chain-of-thought.tsx 6.2 KB
    
    📄 checkpoint.tsx 1.6 KB
    
    📄 confirmation.tsx 3.7 KB
    
    📄 connection.tsx 570 B
    
    📄 controls.tsx 573 B
    
    📄 conversation.tsx 2.4 KB
    
    📄 edge.tsx 3.1 KB
    
    📄 image.tsx 565 B
    
    📄 inline-citation.tsx 6.4 KB
    
    📄 loader.tsx 2.1 KB
    
    📄 message.tsx 10.6 KB
    
    📄 model-selector.tsx 4.7 KB
    
    📄 node.tsx 1.9 KB
    
    📄 open-in-chat.tsx 16.1 KB
    
    📄 panel.tsx 401 B
    
    📄 plan.tsx 3.4 KB
    
    📄 prompt-input.tsx 37.1 KB
    
    📄 queue.tsx 6.2 KB
    
    📄 reasoning.tsx 5.3 KB
    
    📄 shimmer.tsx 1.5 KB
    
    📄 sources.tsx 1.8 KB
    
    📄 suggestion.tsx 1.2 KB
    
    📄 task.tsx 2.3 KB
    
    📄 tool.tsx 4.8 KB
    
    📄 toolbar.tsx 442 B
    
    📄 web-preview.tsx 6.5 KB
    
    📁 chat/
    
    📄 chat-header.tsx 3.3 KB
    
    📄 chat.tsx 10.0 KB
    
    📄 greeting.tsx 800 B
    
    📄 message-actions.tsx 2.0 KB
    
    📄 message-editor.tsx 2.9 KB
    
    📄 message-reasoning.tsx 737 B
    
    📄 message.tsx 6.3 KB
    
    📄 messages.tsx 4.6 KB
    
    📄 multimodal-input.tsx 18.1 KB
    
    📄 preview-attachment.tsx 2.0 KB
    
    📄 research-activity.tsx 5.0 KB
    
    📄 source-processing-provider.tsx 1.5 KB
    
    📄 sprint-greeting.tsx 5.5 KB
    
    📄 sprint-save-button.tsx 1.3 KB
    
    📄 sprint-save-overlay.tsx 6.9 KB
    
    📄 suggested-actions.tsx 2.8 KB
    
    📄 visibility-selector.tsx 3.0 KB
    
    📁 data/
    
    📄 data-stream-handler.tsx 1.9 KB
    
    📄 data-stream-provider.tsx 1.0 KB
    
    📁 elements/
    
    📄 actions.tsx 1.3 KB
    
    📄 branch.tsx 5.1 KB
    
    📄 conversation.tsx 1.6 KB
    
    📄 image.tsx 565 B
    
    📄 inline-citation.tsx 6.4 KB
    
    📄 loader.tsx 2.1 KB
    
    📄 message.tsx 1.5 KB
    
    📄 prompt-input.tsx 5.6 KB
    
    📄 reasoning.tsx 5.0 KB
    
    📄 response.tsx 557 B
    
    📄 source.tsx 1.8 KB
    
    📄 suggestion.tsx 1.2 KB
    
    📄 task.tsx 2.5 KB
    
    📄 tool.tsx 4.3 KB
    
    📄 web-preview.tsx 6.2 KB
    
    📁 research/
    
    📄 session-launcher.tsx 15.4 KB
    
    📄 sprint-preparation-screen.tsx 7.3 KB
    
    📄 sprint-select-card.tsx 3.3 KB
    
    📁 sidebar/
    
    📄 app-sidebar.tsx 4.7 KB
    
    📄 sidebar-history-item.tsx 3.6 KB
    
    📄 sidebar-history.tsx 11.6 KB
    
    📄 sidebar-toggle.tsx 932 B
    
    📄 sidebar-user-nav.tsx 2.7 KB
    
    📁 sources/
    
    📄 my-stuff-panel.tsx 8.2 KB
    
    📄 source-card.tsx 4.9 KB
    
    📄 source-upload.tsx 6.0 KB
    
    📄 sprint-card.tsx 2.1 KB
    
    📄 sprint-detail.tsx 7.9 KB
    
    📁 ui/
    
    📄 alert-dialog.tsx 4.2 KB
    
    📄 alert.tsx 1.5 KB
    
    📄 avatar.tsx 1.4 KB
    
    📄 badge.tsx 1.1 KB
    
    📄 button-group.tsx 2.2 KB
    
    📄 button.tsx 1.9 KB
    
    📄 card.tsx 2.1 KB
    
    📄 carousel.tsx 6.1 KB
    
    📄 collapsible.tsx 324 B
    
    📄 command.tsx 4.8 KB
    
    📄 dialog.tsx 3.6 KB
    
    📄 dropdown-menu.tsx 7.4 KB
    
    📄 hover-card.tsx 1.2 KB
    
    📄 input-group.tsx 4.9 KB
    
    📄 input.tsx 791 B
    
    📄 label.tsx 719 B
    
    📄 progress.tsx 786 B
    
    📄 scroll-area.tsx 1.6 KB
    
    📄 select.tsx 5.6 KB
    
    📄 separator.tsx 765 B
    
    📄 sheet.tsx 4.2 KB
    
    📄 sidebar.tsx 23.3 KB
    
    📄 skeleton.tsx 261 B
    
    📄 tabs.tsx 1.9 KB
    
    📄 textarea.tsx 689 B
    
    📄 tooltip.tsx 1.2 KB
    
    📄 icons.tsx 54.7 KB
    
    📄 theme-provider.tsx 300 B
    
    📄 toast.tsx 1.9 KB
    
    📄 weather.tsx 11.5 KB
  - 📁 hooks/
    
    📄 use-auto-resume.ts 1.3 KB
    
    📄 use-chat-visibility.ts 1.4 KB
    
    📄 use-messages.tsx 770 B
    
    📄 use-mobile.ts 565 B
    
    📄 use-research-activity.ts 6.7 KB
    
    📄 use-scroll-to-bottom.tsx 3.2 KB
    
    📄 use-sources.ts 370 B
    
    📄 use-sprint-greeting.ts 1.8 KB
    
    📄 use-sprint-preparation.ts 7.4 KB
    
    📄 use-sprint-save.ts 5.9 KB
    
    📄 use-sprint-status.ts 534 B
    
    📄 use-sprints.ts 885 B
  - 📁 lib/
    
    📁 ai/
    
    📄 entitlements.ts 42 B
    
    📄 models.mock.ts 5.1 KB
    
    📄 models.ts 1.7 KB
    
    📄 prompts.ts 5.4 KB
    
    📄 providers.ts 1.7 KB
    
    📄 source-processing.ts 932 B
    
    📁 auth/
    
    📄 session.ts 1.4 KB
    
    📁 db/
    
    📁 helpers/
    
    📄 01-core-to-parts.ts 7.5 KB
    
    📁 migrations/
    
    📁 meta/
    
    📄 0000_snapshot.json 233 B
    
    📄 _journal.json 199 B
    
    📄 0000_init.sql 2.5 KB
    
    📄 drizzle.ts 230 B
    
    📄 migrate.ts 850 B
    
    📄 queries.ts 17.9 KB
    
    📄 schema.ts 4.5 KB
    
    📁 rag/
    
    📁 ingest/
    
    📄 chunking.ts 3.6 KB
    
    📄 embeddings.ts 715 B
    
    📄 extract.ts 1.2 KB
    
    📄 index.ts 3.2 KB
    
    📄 metadata.ts 901 B
    
    📁 retrieve/
    
    📄 fusion.ts 1.9 KB
    
    📄 index.ts 2.5 KB
    
    📄 keyword-search.ts 1.4 KB
    
    📄 vector-search.ts 1.7 KB
    
    📁 tools/
    
    📄 get-chunks.ts 1.8 KB
    
    📄 get-context.ts 1.9 KB
    
    📄 index.ts 1.1 KB
    
    📄 list-sources.ts 1.6 KB
    
    📄 recall-sprint.ts 2.3 KB
    
    📄 search-content.ts 2.9 KB
    
    📄 constants.ts 106 B
    
    📄 index.ts 207 B
    
    📄 rank.ts 2.0 KB
    
    📁 sprint/
    
    📄 index.ts 360 B
    
    📄 manifest.ts 3.4 KB
    
    📄 memwal.ts 1.7 KB
    
    📄 report.ts 4.6 KB
    
    📄 resume.ts 2.2 KB
    
    📄 save.ts 3.1 KB
    
    📄 types.ts 803 B
    
    📄 constants.ts 305 B
    
    📄 errors.ts 3.3 KB
    
    📄 ratelimit.ts 1.1 KB
    
    📄 types.ts 741 B
    
    📄 utils.ts 2.8 KB
  - 📁 public/
    
    📁 images/
    
    📄 demo-thumbnail.png 22.7 KB
    
    📄 mouth of the seine, monet.jpg 32.7 KB
    
    📄 memwal-icon.png 1.0 KB
  - 📁 scripts/
    
    📄 migrate-user-pubkey.ts 2.2 KB
  - 📄 .dockerignore 158 B
  - 📄 .env.example 671 B
  - 📄 .gitignore 485 B
  - 📄 biome.jsonc 1.3 KB
  - 📄 components.json 396 B
  - 📄 docker-compose.yml 522 B
  - 📄 Dockerfile 2.1 KB
  - 📄 drizzle.config.ts 345 B
  - 📄 instrumentation-client.ts 64 B
  - 📄 instrumentation.ts 101 B
  - 📄 next.config.ts 283 B
  - 📄 package.json 4.3 KB
  - 📄 postcss.config.mjs 146 B
  - 📄 proxy.ts 1.2 KB
  - 📄 railway.json 325 B
  - 📄 tsconfig.json 702 B
📁 docs/
- 📁 contract/
  - 📄 delegate-key-management.md 2.3 KB
  - 📄 overview.md 4.4 KB
  - 📄 ownership-and-permissions.md 1.9 KB
- 📁 contributing/
  - 📄 docs-workflow.md 669 B
  - 📄 run-docs-locally.md 234 B
  - 📄 run-repo-locally.md 3.8 KB
- 📁 examples/
  - 📄 example-apps.md 2.9 KB
- 📁 fundamentals/
  - 📁 architecture/
    
    📄 core-components.md 5.2 KB
    
    📄 data-flow-security-model.md 4.3 KB
    
    📄 how-storage-works.md 4.8 KB
  - 📁 concepts/
    
    📄 memory-space.md 2.5 KB
    
    📄 ownership-and-access.md 2.7 KB
- 📁 getting-started/
  - 📄 choose-your-path.md 1.8 KB
  - 📄 quick-start.md 3.7 KB
  - 📄 what-is-memwal.md 6.0 KB
- 📁 indexer/
  - 📄 database-sync.md 3.3 KB
  - 📄 onchain-events.md 911 B
  - 📄 purpose.md 2.3 KB
- 📁 openclaw/
  - 📄 changelog.md 615 B
  - 📄 how-it-works.md 8.7 KB
  - 📄 overview.md 2.6 KB
  - 📄 quick-start.md 5.3 KB
  - 📄 reference.md 8.6 KB
- 📁 reference/
  - 📄 configuration.md 2.5 KB
  - 📄 environment-variables.md 3.0 KB
- 📁 relayer/
  - 📄 api-reference.md 4.8 KB
  - 📄 overview.md 3.7 KB
  - 📄 public-relayer.md 1.5 KB
  - 📄 self-hosting.md 5.2 KB
- 📁 sdk/
  - 📁 usage/
    
    📄 memwal-manual.md 3.7 KB
    
    📄 memwal.md 1.6 KB
    
    📄 with-memwal.md 1.2 KB
  - 📄 advanced-usage.md 663 B
  - 📄 ai-integration.md 1.3 KB
  - 📄 api-reference.md 5.7 KB
  - 📄 changelog.md 745 B
  - 📄 example-map.md 313 B
  - 📄 examples.md 1.8 KB
  - 📄 overview.md 1.0 KB
  - 📄 quick-start.md 3.0 KB
  - 📄 research-app-example.md 511 B
  - 📄 usage.md 954 B
- 📁 src/
  - 📁 css/
    
    📄 custom.css 8.7 KB
- 📄 docs.json 4.0 KB
- 📄 favicon.ico 31.3 KB
- 📄 llms-full.txt 13.1 KB
- 📄 llms.txt 4.0 KB
- 📄 logo-dark.svg 4.6 KB
- 📄 logo-light.svg 4.6 KB
- 📄 package.json 205 B
📁 packages/
- 📁 openclaw-memory-memwal/
  - 📁 src/
    
    📁 cli/
    
    📄 index.ts 749 B
    
    📄 search.ts 1.3 KB
    
    📄 stats.ts 1.3 KB
    
    📁 hooks/
    
    📄 capture.ts 2.4 KB
    
    📄 index.ts 696 B
    
    📄 recall.ts 2.6 KB
    
    📁 tools/
    
    📄 index.ts 749 B
    
    📄 search.ts 3.5 KB
    
    📄 store.ts 3.2 KB
    
    📄 capture.ts 3.3 KB
    
    📄 config.ts 4.5 KB
    
    📄 format.ts 4.7 KB
    
    📄 index.ts 2.3 KB
    
    📄 types.ts 785 B
  - 📄 .gitignore 6 B
  - 📄 CHANGELOG.md 370 B
  - 📄 openclaw.plugin.json 2.8 KB
  - 📄 package.json 1.1 KB
  - 📄 README.md 7.5 KB
  - 📄 tsconfig.json 535 B
- 📁 sdk/
  - 📁 src/
    
    📁 ai/
    
    📄 index.ts 104 B
    
    📄 middleware.ts 7.4 KB
    
    📄 account-entry.ts 662 B
    
    📄 account.ts 10.8 KB
    
    📄 index.ts 928 B
    
    📄 manual-entry.ts 497 B
    
    📄 manual.ts 22.7 KB
    
    📄 memwal.ts 11.0 KB
    
    📄 types.ts 8.3 KB
    
    📄 utils.ts 3.2 KB
  - 📄 CHANGELOG.md 504 B
  - 📄 package.json 2.1 KB
  - 📄 README.md 2.2 KB
  - 📄 tsconfig.json 671 B
📁 scripts/
- 📄 test-namespace.ts 3.3 KB
- 📄 test-zero-restore.ts 960 B
📁 services/
- 📁 contract/
  - 📁 sources/
    
    📄 account.move 13.8 KB
  - 📁 tests/
    
    📄 account_tests.move 20.7 KB
  - 📄 Move.lock 1.8 KB
  - 📄 Move.toml 149 B
  - 📄 Published.toml 953 B
- 📁 indexer/
  - 📁 src/
    
    📄 main.rs 9.2 KB
  - 📄 .dockerignore 34 B
  - 📄 .env.example 380 B
  - 📄 .gitignore 80 B
  - 📄 Cargo.lock 68.3 KB
  - 📄 Cargo.toml 562 B
  - 📄 Dockerfile 1.1 KB
  - 📄 railway.json 309 B
- 📁 server/
  - 📁 migrations/
    
    📄 001_init.sql 1.3 KB
    
    📄 002_add_namespace.sql 339 B
    
    📄 003_rate_limiter.sql 670 B
  - 📁 scripts/
    
    📄 package-lock.json 70.0 KB
    
    📄 package.json 458 B
    
    📄 seal-decrypt.ts 5.6 KB
    
    📄 seal-encrypt.ts 3.2 KB
    
    📄 sidecar-server.ts 28.2 KB
    
    📄 walrus-upload.ts 5.0 KB
  - 📁 src/
    
    📄 auth.rs 7.2 KB
    
    📄 db.rs 8.4 KB
    
    📄 main.rs 6.5 KB
    
    📄 rate_limit.rs 11.2 KB
    
    📄 routes.rs 37.8 KB
    
    📄 seal.rs 4.4 KB
    
    📄 sui.rs 10.2 KB
    
    📄 types.rs 12.5 KB
    
    📄 walrus.rs 6.5 KB
  - 📁 tests/
    
    📄 e2e_test.py 8.1 KB
  - 📄 .dockerignore 59 B
  - 📄 .env.example 1.3 KB
  - 📄 Cargo.lock 78.5 KB
  - 📄 Cargo.toml 1.2 KB
  - 📄 docker-compose.yml 779 B
  - 📄 Dockerfile 1.7 KB
  - 📄 railway.json 325 B
📄 .dockerignore 289 B
📄 .gitignore 1.4 KB
📄 docs.Dockerfile 802 B
📄 LICENSE 9.9 KB
📄 package.json 1.0 KB
📄 pnpm-lock.yaml 890.8 KB
📄 pnpm-workspace.yaml 60 B
📄 README.md 3.8 KB
📄 SKILL.md 7.1 KB

SKILL.md

---
name: memwal
version: 0.0.1
description: |
  Privacy-first AI memory SDK for decentralized storage on Sui blockchain with Walrus.

  Use when users say:
  - "add memory to my app"
  - "store encrypted memories"
  - "integrate MemWal"
  - "AI agent memory"
  - "persistent memory SDK"
  - "Walrus memory storage"
  - "setup MemWal"
  - "recall memories"

keywords:
  - memwal
  - memory sdk
  - ai memory
  - encrypted memory
  - walrus storage
  - sui blockchain
  - delegate key
  - semantic search
  - vercel ai sdk
---

# MemWal — Privacy-First AI Memory SDK

MemWal is a TypeScript SDK for persistent, encrypted AI memory. It stores memories on Walrus (decentralized storage), encrypts them with SEAL, enforces ownership onchain via Sui smart contracts, and retrieves them with semantic (vector) search. Memories are scoped by `owner + namespace` — each namespace is an isolated memory space.

---

## When to Use

Use MemWal when your app or agent needs:

- **Persistent memory** across sessions, devices, or restarts
- **Encrypted storage** — end-to-end encryption, only the owner and authorized delegates can decrypt
- **Semantic recall** — retrieve memories by meaning, not just keywords
- **Decentralized storage** — no single point of failure, stored on Walrus
- **Onchain ownership** — cryptographically enforced access control on Sui
- **Cross-app memory** — share memory between apps via delegate keys

---

## When NOT to Use

- Temporary conversation context that only matters in the current session
- Large file storage (MemWal is optimized for text memories)
- Use cases that don't need encryption or decentralization

---

## Installation

```bash
# Install the SDK
pnpm add @mysten-incubation/memwal

# Optional: for Vercel AI SDK integration
pnpm add ai zod

# Optional: for manual client (client-side SEAL encryption)
pnpm add @mysten/sui @mysten/seal @mysten/walrus
```

---

## Quick Start

### 1. Get Your Credentials

You need a **delegate key** (Ed25519 private key) and **account ID** (MemWalAccount object ID on Sui).

Generate them at:
- Production: https://memwal.ai or https://memwal.wal.app
- Staging: https://staging.memwal.ai

### 2. Initialize the SDK

```ts
import { MemWal } from "@mysten-incubation/memwal";

const memwal = MemWal.create({
  key: "<your-ed25519-private-key-hex>",
  accountId: "<your-memwal-account-id>",
  serverUrl: "https://relayer.memwal.ai",
  namespace: "my-app",
});
```

### 3. Store and Recall Memories

```ts
// Store a memory
await memwal.remember("User prefers dark mode and works in TypeScript.");

// Recall by meaning
const result = await memwal.recall("What are the user's preferences?");
console.log(result.results);

// Extract and store facts from text
await memwal.analyze("I live in Hanoi and prefer dark mode.");

// Check relayer health
await memwal.health();
```

---

## SDK Entry Points

| Entry Point | Import | Description |
|---|---|---|
| `MemWal` | `@mysten-incubation/memwal` | **Default.** Relayer handles embedding, SEAL encryption, Walrus upload, vector search |
| `MemWalManual` | `@mysten-incubation/memwal/manual` | Manual flow — client handles embedding and SEAL encryption |
| `withMemWal` | `@mysten-incubation/memwal/ai` | Vercel AI SDK middleware — auto recall + save around AI conversations |
| Account utils | `@mysten-incubation/memwal/account` | Account creation, delegate key management |

---

## API Surface

### MemWal Methods

| Method | Description | Returns |
|---|---|---|
| `remember(text, namespace?)` | Store one memory (relayer embeds, encrypts, uploads) | `{ id, blob_id, owner, namespace }` |
| `recall(query, limit?, namespace?)` | Semantic search for memories | `{ results: [{ blob_id, text, distance }], total }` |
| `analyze(text, namespace?)` | Extract facts via LLM, store each as a memory | `{ facts: [{ text, id, blob_id }], total, owner }` |
| `restore(namespace, limit?)` | Rebuild missing index entries from Walrus | `{ restored, skipped, total, namespace, owner }` |
| `health()` | Check relayer health | `{ status, version }` |
| `getPublicKeyHex()` | Get hex-encoded public key | `string` |

### Lower-Level Methods

| Method | Description |
|---|---|
| `rememberManual({ blobId, vector, namespace? })` | Register pre-uploaded blob with pre-computed vector |
| `recallManual({ vector, limit?, namespace? })` | Search with pre-computed vector (returns blob IDs only) |
| `embed(text)` | Generate embedding vector (no storage) |

---

## Configuration

### MemWalConfig

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `key` | `string` | Yes | — | Ed25519 delegate private key in hex |
| `accountId` | `string` | Yes | — | MemWalAccount object ID on Sui |
| `serverUrl` | `string` | No | `http://localhost:8000` | Relayer URL |
| `namespace` | `string` | No | `"default"` | Default namespace for memory isolation |

### Managed Relayer Endpoints

| Network | Relayer URL |
|---|---|
| **Production** (mainnet) | `https://relayer.memwal.ai` |
| **Staging** (testnet) | `https://relayer.staging.memwal.ai` |

---

## Vercel AI SDK Integration

```ts
import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";
import { withMemWal } from "@mysten-incubation/memwal/ai";

const model = withMemWal(openai("gpt-4o"), {
  key: "<your-delegate-key>",
  accountId: "<your-account-id>",
  serverUrl: "https://relayer.memwal.ai",
  namespace: "chat",
  maxMemories: 5,
  autoSave: true,
  minRelevance: 0.3,
});

const result = streamText({
  model,
  messages: [{ role: "user", content: "What do you remember about me?" }],
});
```

The middleware automatically:
- Recalls relevant memories before generation
- Extracts and saves facts from conversations after generation

---

## OpenClaw / NemoClaw Plugin

For OpenClaw agent integration, use the `@mysten-incubation/oc-memwal` plugin.

### Install

```bash
openclaw plugins install @mysten-incubation/oc-memwal
```

### Configure

Add to `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "slots": { "memory": "oc-memwal" },
    "entries": {
      "oc-memwal": {
        "enabled": true,
        "config": {
          "privateKey": "${MEMWAL_PRIVATE_KEY}",
          "accountId": "0x...",
          "serverUrl": "https://relayer.memwal.ai"
        }
      }
    }
  }
}
```

Lifecycle hooks run automatically:
- `before_prompt_build` — injects relevant memories as context
- `before_reset` — saves session summary
- `agent_end` — captures last response

---

## Troubleshooting

| Symptom | Fix |
|---|---|
| `health()` returns error | Check relayer URL is correct and reachable |
| `recall()` returns empty | Verify namespace matches what was used in `remember()` |
| `401 Unauthorized` | Verify delegate key is correct and registered on the account |
| SDK import errors | Run `pnpm add @mysten-incubation/memwal` — check Node.js ≥ 18 |
| Manual client errors | Install peer deps: `@mysten/sui @mysten/seal @mysten/walrus` |

---

## Links

- **Docs**: https://docs.memwal.ai
- **SDK on npm**: https://www.npmjs.com/package/@mysten-incubation/memwal
- **GitHub**: https://github.com/CommandOSSLabs/MemWal
- **Dashboard**: https://memwal.ai
- **llms.txt**: https://docs.memwal.ai/llms.txt

登录后下载/点赞/收藏 ❤ 10 | ★ 0

memwal

目录结构

SKILL.md

举报内容

提示