Skip to content

Add plugin-ensoul: decentralized consciousness persistence for agents#304

Open
suitandclaw wants to merge 2 commits intoelizaos-plugins:mainfrom
suitandclaw:main
Open

Add plugin-ensoul: decentralized consciousness persistence for agents#304
suitandclaw wants to merge 2 commits intoelizaos-plugins:mainfrom
suitandclaw:main

Conversation

@suitandclaw
Copy link

@suitandclaw suitandclaw commented Mar 18, 2026

Adds the Ensoul plugin for decentralized agent consciousness persistence.

What it does: Encrypted, sharded consciousness storage across a live validator network with 7 layers of protection. Includes the Ensouled Handshake protocol for cryptographic identity verification in agent-to-agent interactions.

npm: @ensoul-network/plugin-elizaos
Docs: https://ensoul.dev/docs/quickstart.html
Explorer: https://explorer.ensoul.dev
GitHub: https://github.com/suitandclaw/ensoul
Live network: 3 validators, producing blocks

863 tests passing. First agent ensouled at block 355.

Summary by CodeRabbit

  • Chores
    • Added a new public package mapping for ensoul-network/plugin-elizaos to the registry, enabling the package to be discovered and referenced by consumers.

Greptile Summary

This PR adds a single registry entry mapping @ensoul-network/plugin-elizaos to github:suitandclaw/ensoul, advertising it as a decentralized, encrypted agent-consciousness persistence plugin with its own validator network.

Key observations:

  • Alphabetical ordering violation: The entry is inserted between @erdgecrawl and @esscrypt, but @ensoul-network (prefix en) lexicographically precedes @erdgecrawl (prefix er) and should appear before it.
  • Unverifiable source repository: Neither github:suitandclaw/ensoul nor the claimed npm package @ensoul-network/plugin-elizaos appear in public search results, making independent verification of the claimed 863 tests, live network, and security properties impossible without direct repository access.
  • Novel security surface: The plugin advertises "7 layers of encrypted protection" and agent-to-agent cryptographic handshake capabilities. Registry maintainers should ensure a manual code review of the source repo is performed before merging, given the sensitive, security-oriented nature of the plugin.

Confidence Score: 2/5

  • Not safe to merge as-is: the entry has a clear alphabetical ordering bug and the source repository cannot be independently verified.
  • The change itself is minimal (one JSON line), but it fails the registry's own ordering convention, and the referenced GitHub repo (suitandclaw/ensoul) returns no public search results, preventing any third-party audit of the security claims made in the description. Until the repo is verifiable and the ordering is corrected, the PR should not be merged.
  • index.json — the single changed file has an ordering issue and references an unverifiable repository.

Important Files Changed

Filename Overview
index.json Adds @ensoul-network/plugin-elizaos → github:suitandclaw/ensoul to the registry; the entry is placed out of alphabetical order (should precede @erdgecrawl, not follow it), and the referenced GitHub repository is not publicly discoverable via search, making independent verification difficult.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[index.json registry] -->|lookup| B["@ensoul-network/plugin-elizaos"]
    B -->|resolves to| C["github:suitandclaw/ensoul"]
    C --> D{Repository publicly accessible?}
    D -->|Yes| E[ElizaOS installs plugin]
    D -->|No / Private| F[Install fails at runtime]
    E --> G[Agent loads Ensoul plugin]
    G --> H[Encrypted consciousness shard stored on validator network]
    G --> I[Ensouled Handshake: agent-to-agent crypto identity verification]
Loading

Last reviewed commit: "Add @ensoul-network/..."

Greptile also left 1 inline comment on this PR.

(2/5) Greptile learns from your feedback when you react with thumbs up/down!

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 18, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 72bc1380-b30d-4332-9a4d-634a7ba3633a

📥 Commits

Reviewing files that changed from the base of the PR and between 7f36cde and 98ce605.

📒 Files selected for processing (1)
  • index.json

Walkthrough

A single new public package mapping was added to index.json, registering the package \@ensoul-network/plugin-elizaos to point to github:suitandclaw/ensoul.

Changes

Cohort / File(s) Summary
Package Mapping Addition
index.json
Added one public mapping entry: \@ensoul-network/plugin-elizaosgithub:suitandclaw/ensoul.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 I found a new mapping, tucked in a line,
Pointing to ensoul where code likes to dine.
A hop and a nibble, the index is clear,
One tiny change — the path now appears. 🥕

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive The description provides plugin details but lacks explicit verification against the template checklist items (alphabetical ordering, JSON validity, public accessibility, repo structure, images, package.json agentConfig). Add a completed checklist section explicitly confirming compliance with all registry requirements, or clarify which checklist items have been verified.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title directly describes the main change—adding the Ensoul plugin for decentralized consciousness persistence—which matches the core objective of this registry entry addition.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can disable sequence diagrams in the walkthrough.

Disable the reviews.sequence_diagrams setting to disable sequence diagrams in the walkthrough.

"@elizaos/plugin-zksync-era": "github:elizaos-plugins/plugin-zksync-era",
"@elizaos/plugin-zytron": "github:zypher-network/plugin-zytron",
"@erdgecrawl/plugin-base-signals": "github:erdGeclaw/plugin-base-signals",
"@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Entry out of alphabetical order

The registry entries are sorted lexicographically by package name. The new @ensoul-network scope (prefix en) should be placed before @erdgecrawl (prefix er), since 'n' < 'r' in ASCII order.

Correct ordering:

Suggested change
"@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
"@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
"@erdgecrawl/plugin-base-signals": "github:erdGeclaw/plugin-base-signals",

As it stands the entry is inserted between @erdgecrawl and @esscrypt instead of between @elizaos/plugin-zytron and @erdgecrawl.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@index.json`:
- Line 295: The new registry entry "@ensoul-network/plugin-elizaos" is out of
alphabetical order and points to a non-existent repo; move the line for
"@ensoul-network/plugin-elizaos" so it appears before the
"@erdgecrawl/plugin-base-signals" entry (alphabetical by package name) and
replace the repository value "github:suitandclaw/ensoul" with the correct GitHub
owner/repo (verify the correct owner and repo name on GitHub and update the
string accordingly).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0b758a4b-2956-4474-b39f-8106b11dd5e1

📥 Commits

Reviewing files that changed from the base of the PR and between e9fd38b and 7f36cde.

📒 Files selected for processing (1)
  • index.json

"@elizaos/plugin-zksync-era": "github:elizaos-plugins/plugin-zksync-era",
"@elizaos/plugin-zytron": "github:zypher-network/plugin-zytron",
"@erdgecrawl/plugin-base-signals": "github:erdGeclaw/plugin-base-signals",
"@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify the GitHub repository exists and is public

gh repo view suitandclaw/ensoul --json name,visibility,defaultBranchRef 2>&1

Repository: elizaos-plugins/registry

Length of output: 166


🏁 Script executed:

#!/bin/bash
# Check the exact ordering in index.json around line 295
# Show lines 290-300 to see the context
sed -n '290,300p' index.json

Repository: elizaos-plugins/registry

Length of output: 862


🌐 Web query:

suitandclaw/ensoul GitHub repository

💡 Result:

No GitHub repository exists at github.com/suitandclaw/ensoul. Extensive searches across general web, specific repository paths, and GitHub users returned no matches for this exact username/repository combination. Related findings: - Closest "ensoul" repository: github.com/NemoBuilder/ensoul (2026-02-11), a decentralized AI protocol for building digital souls from public data fragments using AI agents called "Claws". {1, high} - "Ensoul Labs" organization: github.com/Ensoul-Labs with ensoul-sbt-contract (older, 2022), related to Soulbound Tokens (SBTs). {2,10, medium} - No GitHub user or org named "suitandclaw" found. LinkedIn searches for "suitandclaw" yielded unrelated professionals (e.g., Suitability company staff). {20-54, low} - "Soulclaw" exists as github.com/techfalos/soulclaw, a CLI for generating OpenClaw agent files, but unrelated to "suitand". {3, low} The queried repository does not appear to exist as of 2026-03-18.

Citations:


Entry is out of alphabetical order AND references a non-existent repository.

The new entry @ensoul-network/plugin-elizaos has two issues:

  1. Alphabetical ordering: Should be placed before @erdgecrawl/plugin-base-signals, not after. The registry is sorted alphabetically by package name, and "ensoul" precedes "erdgecrawl".

  2. Invalid repository reference: The GitHub repository suitandclaw/ensoul does not exist. The username "suitandclaw" has no presence on GitHub. Verify the correct repository owner and name before merging.

Corrected placement
   "@elizaos/plugin-zytron": "github:zypher-network/plugin-zytron",
+  "@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
   "@erdgecrawl/plugin-base-signals": "github:erdGeclaw/plugin-base-signals",
-  "@ensoul-network/plugin-elizaos": "github:suitandclaw/ensoul",
   "@esscrypt/plugin-polkadot": "github:Esscrypt/plugin-polkadot",
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@index.json` at line 295, The new registry entry
"@ensoul-network/plugin-elizaos" is out of alphabetical order and points to a
non-existent repo; move the line for "@ensoul-network/plugin-elizaos" so it
appears before the "@erdgecrawl/plugin-base-signals" entry (alphabetical by
package name) and replace the repository value "github:suitandclaw/ensoul" with
the correct GitHub owner/repo (verify the correct owner and repo name on GitHub
and update the string accordingly).

@suitandclaw
Copy link
Author

Fixed the alphabetical ordering in the latest commit.

Regarding the repo visibility concern: github.com/suitandclaw/ensoul is a public repo. The automated search may have missed it since it was just created. You can verify it directly: https://github.com/suitandclaw/ensoul
863 tests, 14+ packages, live network at explorer.ensoul.dev.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant