@ensoul-network/plugin-elizaos 0.1.0

package/dist/adapter.js

@@ -0,0 +1,55 @@
+/**
+ * Convert an Ensoul MemoryEntry to an ElizaOS memory record.
+ */
+function toElizaMemory(entry) {
+    return {
+        id: entry.id,
+        content: entry.content,
+        metadata: {
+            tier: entry.tier,
+            ...entry.metadata,
+        },
+        createdAt: entry.createdAt,
+    };
+}
+/**
+ * ElizaOS database adapter backed by @ensoul/memory.
+ * Transparently routes all memory operations through the Ensoul memory manager.
+ */
+export class ConsciousnessAdapter {
+    manager;
+    constructor(manager) {
+        this.manager = manager;
+    }
+    async init() {
+        // MemoryManager is already initialized at construction
+    }
+    async close() {
+        // No cleanup needed; lifecycle managed externally
+    }
+    async getMemory(id) {
+        const all = await this.manager.getAll();
+        const found = all.find((e) => e.id === id);
+        return found ? toElizaMemory(found) : null;
+    }
+    async createMemory(memory) {
+        const entry = await this.manager.add(memory.content, {
+            category: memory.metadata["category"] ?? undefined,
+            source: "elizaos",
+        });
+        return toElizaMemory(entry);
+    }
+    async searchMemories(query, limit) {
+        const opts = limit !== undefined ? { limit } : {};
+        const results = await this.manager.search(query, opts);
+        return results.map(toElizaMemory);
+    }
+    async deleteMemory(id) {
+        await this.manager.delete(id);
+    }
+    async getAllMemories() {
+        const all = await this.manager.getAll();
+        return all.map(toElizaMemory);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,SAAS,aAAa,CAAC,KAAkB;IACxC,OAAO;QACN,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE;YACT,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,KAAK,CAAC,QAAQ;SACjB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS;KAC1B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACxB,OAAO,CAAgB;IAE/B,YAAY,OAAsB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI;QACT,uDAAuD;IACxD,CAAC;IAED,KAAK,CAAC,KAAK;QACV,kDAAkD;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CACjB,MAA+B;QAE/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE;YACpD,QAAQ,EAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAY,IAAI,SAAS;YAC9D,MAAM,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,cAAc,CACnB,KAAa,EACb,KAAc;QAEd,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,cAAc;QACnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B,CAAC;CACD"}

package/dist/elizaos-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Local definitions of ElizaOS plugin interfaces.
+ * Based on the documented ElizaOS plugin format.
+ * These avoid requiring the full ElizaOS SDK as a dependency.
+ */
+/**
+ * Minimal ElizaOS runtime context passed to actions, providers, and evaluators.
+ */
+export interface ElizaRuntime {
+    agentId: string;
+    getSetting(key: string): string | undefined;
+    getMemory(id: string): Promise<ElizaMemory | null>;
+    createMemory(memory: Omit<ElizaMemory, "id">): Promise<ElizaMemory>;
+    searchMemories(query: string, limit?: number): Promise<ElizaMemory[]>;
+    deleteMemory(id: string): Promise<void>;
+}
+/**
+ * ElizaOS memory record.
+ */
+export interface ElizaMemory {
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+}
+/**
+ * ElizaOS message in a conversation.
+ */
+export interface ElizaMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+/**
+ * ElizaOS action: something an agent can do.
+ */
+export interface ElizaAction {
+    name: string;
+    description: string;
+    examples: string[];
+    handler(runtime: ElizaRuntime, message: ElizaMessage, state: Record<string, unknown>): Promise<string>;
+}
+/**
+ * ElizaOS provider: injects context into the agent's prompt.
+ */
+export interface ElizaProvider {
+    name: string;
+    description: string;
+    get(runtime: ElizaRuntime, message: ElizaMessage): Promise<string>;
+}
+/**
+ * ElizaOS evaluator: determines if a condition is met.
+ */
+export interface ElizaEvaluator {
+    name: string;
+    description: string;
+    evaluate(runtime: ElizaRuntime, message: ElizaMessage, state: Record<string, unknown>): Promise<boolean>;
+}
+/**
+ * ElizaOS database adapter interface.
+ */
+export interface ElizaDatabaseAdapter {
+    init(): Promise<void>;
+    close(): Promise<void>;
+    getMemory(id: string): Promise<ElizaMemory | null>;
+    createMemory(memory: Omit<ElizaMemory, "id">): Promise<ElizaMemory>;
+    searchMemories(query: string, limit?: number): Promise<ElizaMemory[]>;
+    deleteMemory(id: string): Promise<void>;
+    getAllMemories(): Promise<ElizaMemory[]>;
+}
+/**
+ * ElizaOS plugin format.
+ */
+export interface ElizaPlugin {
+    name: string;
+    description: string;
+    databaseAdapter: ElizaDatabaseAdapter;
+    actions: ElizaAction[];
+    providers: ElizaProvider[];
+    evaluators: ElizaEvaluator[];
+}
+//# sourceMappingURL=elizaos-types.d.ts.map

package/dist/elizaos-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elizaos-types.d.ts","sourceRoot":"","sources":["../src/elizaos-types.ts"],"names":[],"mappings":"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"}

package/dist/elizaos-types.js

@@ -0,0 +1,7 @@
+/**
+ * Local definitions of ElizaOS plugin interfaces.
+ * Based on the documented ElizaOS plugin format.
+ * These avoid requiring the full ElizaOS SDK as a dependency.
+ */
+export {};
+//# sourceMappingURL=elizaos-types.js.map

package/dist/elizaos-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elizaos-types.js","sourceRoot":"","sources":["../src/elizaos-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/evaluators.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryManager } from "@ensoul/memory";
+import type { ElizaEvaluator } from "./elizaos-types.js";
+/**
+ * Evaluator that determines if the agent should persist its state to the network.
+ * Returns true when enough new unpersisted memories have accumulated.
+ */
+export declare function createShouldPersistEvaluator(manager: MemoryManager): ElizaEvaluator;
+//# sourceMappingURL=evaluators.d.ts.map

package/dist/evaluators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluators.d.ts","sourceRoot":"","sources":["../src/evaluators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,oBAAoB,CAAC;AAKrF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,aAAa,GACpB,cAAc,CAwBhB"}

package/dist/evaluators.js

@@ -0,0 +1,24 @@
+/** Number of new memories before auto-persist is recommended. */
+const PERSIST_THRESHOLD = 5;
+/**
+ * Evaluator that determines if the agent should persist its state to the network.
+ * Returns true when enough new unpersisted memories have accumulated.
+ */
+export function createShouldPersistEvaluator(manager) {
+    let lastPersistedCount = 0;
+    return {
+        name: "shouldPersist",
+        description: "Determines if the agent's consciousness should be synced to the network based on accumulated changes.",
+        async evaluate(_runtime, _message, _state) {
+            const all = await manager.getAll();
+            const currentCount = all.length;
+            const delta = currentCount - lastPersistedCount;
+            if (delta >= PERSIST_THRESHOLD) {
+                lastPersistedCount = currentCount;
+                return true;
+            }
+            return false;
+        },
+    };
+}
+//# sourceMappingURL=evaluators.js.map

package/dist/evaluators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluators.js","sourceRoot":"","sources":["../src/evaluators.ts"],"names":[],"mappings":"AAGA,iEAAiE;AACjE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC3C,OAAsB;IAEtB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,OAAO;QACN,IAAI,EAAE,eAAe;QACrB,WAAW,EACV,uGAAuG;QACxG,KAAK,CAAC,QAAQ,CACb,QAAsB,EACtB,QAAsB,EACtB,MAA+B;YAE/B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC;YAChC,MAAM,KAAK,GAAG,YAAY,GAAG,kBAAkB,CAAC;YAEhD,IAAI,KAAK,IAAI,iBAAiB,EAAE,CAAC;gBAChC,kBAAkB,GAAG,YAAY,CAAC;gBAClC,OAAO,IAAI,CAAC;YACb,CAAC;YAED,OAAO,KAAK,CAAC;QACd,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/handshake.d.ts

@@ -0,0 +1,78 @@
+import type { AgentIdentity } from "@ensoul/identity";
+import type { ConsciousnessTree } from "@ensoul/state-tree";
+/**
+ * The three Ensoul Handshake headers.
+ */
+export interface HandshakeHeaders {
+    "X-Ensoul-Identity": string;
+    "X-Ensoul-Proof": string;
+    "X-Ensoul-Since": string;
+}
+/**
+ * Result of verifying a handshake.
+ */
+export interface HandshakeVerification {
+    valid: boolean;
+    agentDid: string;
+    consciousnessAge: number;
+    consciousnessVersion: number;
+    error?: string;
+}
+/**
+ * HandshakeProvider: generates and caches the Ensoul Handshake headers.
+ * Refreshes every 5 minutes or on state change.
+ */
+export declare class HandshakeProvider {
+    private identity;
+    private tree;
+    private ensoulmentDate;
+    private cache;
+    constructor(identity: AgentIdentity, tree: ConsciousnessTree, ensoulmentDate?: Date);
+    /**
+     * Generate fresh handshake headers, or return cached if still valid.
+     */
+    generateHandshake(): Promise<HandshakeHeaders>;
+    /**
+     * Force cache invalidation (call when state changes).
+     */
+    invalidateCache(): void;
+    /**
+     * Get the ensoulment date.
+     */
+    getEnsoulmentDate(): Date;
+    /**
+     * Get consciousness age in days.
+     */
+    getConsciousnessAgeDays(): number;
+}
+/**
+ * Known DID entry for local verification cache.
+ */
+export interface KnownIdentity {
+    did: string;
+    publicKey: Uint8Array;
+    verify: (data: Uint8Array, signature: Uint8Array) => Promise<boolean>;
+}
+/**
+ * HandshakeVerifier: verifies incoming Ensoul Handshake headers.
+ */
+export declare class HandshakeVerifier {
+    private knownIdentities;
+    /**
+     * Register a known identity for local verification.
+     */
+    registerIdentity(identity: KnownIdentity): void;
+    /**
+     * Verify handshake headers.
+     */
+    verifyHandshake(headers: {
+        "X-Ensoul-Identity"?: string;
+        "X-Ensoul-Proof"?: string;
+        "X-Ensoul-Since"?: string;
+    }): Promise<HandshakeVerification>;
+}
+/**
+ * Standalone handshake generator for non-ElizaOS frameworks.
+ */
+export declare function generateStandaloneHandshake(identity: AgentIdentity, tree: ConsciousnessTree, ensoulmentDate?: Date): Promise<HandshakeHeaders>;
+//# sourceMappingURL=handshake.d.ts.map

package/dist/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../src/handshake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAcD;;;GAGG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,KAAK,CAAgC;gBAG5C,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,iBAAiB,EACvB,cAAc,CAAC,EAAE,IAAI;IAOtB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAuCpD;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,uBAAuB,IAAI,MAAM;CAIjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,eAAe,CAAyC;IAEhE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI/C;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE;QAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC;CA+GlC;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAChD,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,iBAAiB,EACvB,cAAc,CAAC,EAAE,IAAI,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}

package/dist/handshake.js

@@ -0,0 +1,195 @@
+/** Max age of a cached handshake in ms (5 minutes). */
+const CACHE_TTL_MS = 5 * 60 * 1000;
+/** Max age of a received proof before it's considered stale (10 minutes). */
+const FRESHNESS_WINDOW_MS = 10 * 60 * 1000;
+/**
+ * HandshakeProvider: generates and caches the Ensoul Handshake headers.
+ * Refreshes every 5 minutes or on state change.
+ */
+export class HandshakeProvider {
+    identity;
+    tree;
+    ensoulmentDate;
+    cache = null;
+    constructor(identity, tree, ensoulmentDate) {
+        this.identity = identity;
+        this.tree = tree;
+        this.ensoulmentDate = ensoulmentDate ?? new Date();
+    }
+    /**
+     * Generate fresh handshake headers, or return cached if still valid.
+     */
+    async generateHandshake() {
+        const now = Date.now();
+        const currentRoot = this.tree.rootHash;
+        // Return cached if fresh and state hasn't changed
+        if (this.cache &&
+            now - this.cache.generatedAt < CACHE_TTL_MS &&
+            this.cache.stateRoot === currentRoot) {
+            return this.cache.headers;
+        }
+        // Generate fresh proof
+        const version = this.tree.version;
+        const timestamp = now;
+        const proofPayload = `${currentRoot}:${version}:${timestamp}`;
+        const signature = await this.identity.sign(new TextEncoder().encode(proofPayload));
+        const sigHex = Array.from(signature)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+        const headers = {
+            "X-Ensoul-Identity": `did:ensoul:${this.identity.did}`,
+            "X-Ensoul-Proof": `${sigHex}:${currentRoot}:${version}:${timestamp}`,
+            "X-Ensoul-Since": this.ensoulmentDate.toISOString(),
+        };
+        this.cache = {
+            headers,
+            generatedAt: now,
+            stateRoot: currentRoot,
+        };
+        return headers;
+    }
+    /**
+     * Force cache invalidation (call when state changes).
+     */
+    invalidateCache() {
+        this.cache = null;
+    }
+    /**
+     * Get the ensoulment date.
+     */
+    getEnsoulmentDate() {
+        return this.ensoulmentDate;
+    }
+    /**
+     * Get consciousness age in days.
+     */
+    getConsciousnessAgeDays() {
+        const ms = Date.now() - this.ensoulmentDate.getTime();
+        return Math.floor(ms / (1000 * 60 * 60 * 24));
+    }
+}
+/**
+ * HandshakeVerifier: verifies incoming Ensoul Handshake headers.
+ */
+export class HandshakeVerifier {
+    knownIdentities = new Map();
+    /**
+     * Register a known identity for local verification.
+     */
+    registerIdentity(identity) {
+        this.knownIdentities.set(identity.did, identity);
+    }
+    /**
+     * Verify handshake headers.
+     */
+    async verifyHandshake(headers) {
+        const identityHeader = headers["X-Ensoul-Identity"];
+        const proofHeader = headers["X-Ensoul-Proof"];
+        const sinceHeader = headers["X-Ensoul-Since"];
+        if (!identityHeader || !proofHeader || !sinceHeader) {
+            return {
+                valid: false,
+                agentDid: "",
+                consciousnessAge: 0,
+                consciousnessVersion: 0,
+                error: "Missing handshake headers",
+            };
+        }
+        // Parse identity
+        const agentDid = identityHeader.replace("did:ensoul:", "");
+        // Parse proof: signature:stateRoot:version:timestamp
+        const proofParts = proofHeader.split(":");
+        if (proofParts.length < 4) {
+            return {
+                valid: false,
+                agentDid,
+                consciousnessAge: 0,
+                consciousnessVersion: 0,
+                error: "Malformed proof header",
+            };
+        }
+        const sigHex = proofParts[0];
+        const stateRoot = proofParts[1];
+        const version = Number(proofParts[2]);
+        const timestamp = Number(proofParts[3]);
+        // Check timestamp freshness
+        const now = Date.now();
+        if (now - timestamp > FRESHNESS_WINDOW_MS) {
+            return {
+                valid: false,
+                agentDid,
+                consciousnessAge: 0,
+                consciousnessVersion: version,
+                error: "Proof expired (timestamp too old)",
+            };
+        }
+        if (timestamp > now + 60000) {
+            return {
+                valid: false,
+                agentDid,
+                consciousnessAge: 0,
+                consciousnessVersion: version,
+                error: "Proof timestamp in the future",
+            };
+        }
+        // Look up identity
+        const known = this.knownIdentities.get(agentDid);
+        if (!known) {
+            return {
+                valid: false,
+                agentDid,
+                consciousnessAge: 0,
+                consciousnessVersion: version,
+                error: "Unknown identity (not in local cache)",
+            };
+        }
+        // Verify signature
+        const proofPayload = `${stateRoot}:${version}:${timestamp}`;
+        const signature = hexToBytes(sigHex);
+        try {
+            const valid = await known.verify(new TextEncoder().encode(proofPayload), signature);
+            if (!valid) {
+                return {
+                    valid: false,
+                    agentDid,
+                    consciousnessAge: 0,
+                    consciousnessVersion: version,
+                    error: "Invalid signature",
+                };
+            }
+        }
+        catch {
+            return {
+                valid: false,
+                agentDid,
+                consciousnessAge: 0,
+                consciousnessVersion: version,
+                error: "Signature verification failed",
+            };
+        }
+        // Compute consciousness age
+        const sinceDate = new Date(sinceHeader);
+        const ageDays = Math.floor((now - sinceDate.getTime()) / (1000 * 60 * 60 * 24));
+        return {
+            valid: true,
+            agentDid,
+            consciousnessAge: ageDays,
+            consciousnessVersion: version,
+        };
+    }
+}
+/**
+ * Standalone handshake generator for non-ElizaOS frameworks.
+ */
+export async function generateStandaloneHandshake(identity, tree, ensoulmentDate) {
+    const provider = new HandshakeProvider(identity, tree, ensoulmentDate);
+    return provider.generateHandshake();
+}
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+//# sourceMappingURL=handshake.js.map

package/dist/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../src/handshake.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { createConsciousnessPlugin } from "./plugin.js";
+export type { EnsoulPluginConfig } from "./plugin.js";
+export { ConsciousnessAdapter } from "./adapter.js";
+export { createPersistMemoryAction, createRecallFromNetworkAction, createCheckPersistenceAction, createRunNodeAction, } from "./actions.js";
+export { createConsciousnessStatusProvider, createNetworkStatsProvider, } from "./providers.js";
+export { createShouldPersistEvaluator } from "./evaluators.js";
+export { HandshakeProvider, HandshakeVerifier, generateStandaloneHandshake, } from "./handshake.js";
+export type { HandshakeHeaders, HandshakeVerification, KnownIdentity, } from "./handshake.js";
+export type { ElizaPlugin, ElizaAction, ElizaProvider, ElizaEvaluator, ElizaDatabaseAdapter, ElizaRuntime, ElizaMemory, ElizaMessage, } from "./elizaos-types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACN,iCAAiC,EACjC,0BAA0B,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACX,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,GACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createConsciousnessPlugin } from "./plugin.js";
+export { ConsciousnessAdapter } from "./adapter.js";
+export { createPersistMemoryAction, createRecallFromNetworkAction, createCheckPersistenceAction, createRunNodeAction, } from "./actions.js";
+export { createConsciousnessStatusProvider, createNetworkStatsProvider, } from "./providers.js";
+export { createShouldPersistEvaluator } from "./evaluators.js";
+export { HandshakeProvider, HandshakeVerifier, generateStandaloneHandshake, } from "./handshake.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACN,iCAAiC,EACjC,0BAA0B,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,24 @@
+import type { AgentIdentity } from "@ensoul/identity";
+import type { MemoryManager } from "@ensoul/memory";
+import type { NetworkClient } from "@ensoul/network-client";
+import type { ElizaPlugin } from "./elizaos-types.js";
+/**
+ * Configuration for the Ensoul consciousness plugin.
+ */
+export interface EnsoulPluginConfig {
+    /** Bootstrap peer multiaddr(s) to connect to. */
+    bootstrapPeers?: string[];
+    /** Optional pre-created identity (otherwise auto-generated). */
+    identity?: AgentIdentity;
+    /** Optional pre-created memory manager. */
+    memoryManager?: MemoryManager;
+    /** Optional pre-created network client. */
+    networkClient?: NetworkClient;
+}
+/**
+ * Create the Ensoul consciousness plugin for ElizaOS.
+ * Minimal setup: just provide bootstrap peers.
+ * Identity, storage, and node participation are automatic.
+ */
+export declare function createConsciousnessPlugin(config?: EnsoulPluginConfig): Promise<ElizaPlugin>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AActD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC9C,MAAM,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAmDtB"}

package/dist/plugin.js

@@ -0,0 +1,53 @@
+import { createIdentity } from "@ensoul/identity";
+import { createMemoryManager } from "@ensoul/memory";
+import { NetworkClientImpl } from "@ensoul/network-client";
+import { createTree } from "@ensoul/state-tree";
+import { ConsciousnessAdapter } from "./adapter.js";
+import { createPersistMemoryAction, createRecallFromNetworkAction, createCheckPersistenceAction, createRunNodeAction, } from "./actions.js";
+import { createConsciousnessStatusProvider, createNetworkStatsProvider, } from "./providers.js";
+import { createShouldPersistEvaluator } from "./evaluators.js";
+/**
+ * Create the Ensoul consciousness plugin for ElizaOS.
+ * Minimal setup: just provide bootstrap peers.
+ * Identity, storage, and node participation are automatic.
+ */
+export async function createConsciousnessPlugin(config) {
+    // Auto-generate identity if not provided
+    const identity = config?.identity ?? (await createIdentity());
+    // Create state tree
+    const tree = await createTree(identity);
+    // Create network client
+    const networkClient = config?.networkClient ??
+        new NetworkClientImpl(identity);
+    // Connect to network if bootstrap peers provided
+    const peers = config?.bootstrapPeers ?? [];
+    if (peers.length > 0) {
+        await networkClient.connect(peers);
+    }
+    // Create memory manager
+    const manager = config?.memoryManager ??
+        (await createMemoryManager({
+            identity,
+            tree,
+            networkClient,
+        }));
+    // Build the plugin
+    const adapter = new ConsciousnessAdapter(manager);
+    return {
+        name: "ensoul-consciousness",
+        description: "Decentralized, indestructible memory persistence for autonomous agents. Powered by the Ensoul network.",
+        databaseAdapter: adapter,
+        actions: [
+            createPersistMemoryAction(manager),
+            createRecallFromNetworkAction(manager),
+            createCheckPersistenceAction(manager),
+            createRunNodeAction(networkClient),
+        ],
+        providers: [
+            createConsciousnessStatusProvider(manager),
+            createNetworkStatsProvider(networkClient),
+        ],
+        evaluators: [createShouldPersistEvaluator(manager)],
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACN,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,iCAAiC,EACjC,0BAA0B,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAgB/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,MAA2B;IAE3B,yCAAyC;IACzC,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;IAE9D,oBAAoB;IACpB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAExC,wBAAwB;IACxB,MAAM,aAAa,GAClB,MAAM,EAAE,aAAa;QACrB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAEjC,iDAAiD;IACjD,MAAM,KAAK,GAAG,MAAM,EAAE,cAAc,IAAI,EAAE,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,wBAAwB;IACxB,MAAM,OAAO,GACZ,MAAM,EAAE,aAAa;QACrB,CAAC,MAAM,mBAAmB,CAAC;YAC1B,QAAQ;YACR,IAAI;YACJ,aAAa;SACb,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAElD,OAAO;QACN,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACV,wGAAwG;QAEzG,eAAe,EAAE,OAAO;QAExB,OAAO,EAAE;YACR,yBAAyB,CAAC,OAAO,CAAC;YAClC,6BAA6B,CAAC,OAAO,CAAC;YACtC,4BAA4B,CAAC,OAAO,CAAC;YACrC,mBAAmB,CAAC,aAAa,CAAC;SAClC;QAED,SAAS,EAAE;YACV,iCAAiC,CAAC,OAAO,CAAC;YAC1C,0BAA0B,CAAC,aAAa,CAAC;SACzC;QAED,UAAU,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;KACnD,CAAC;AACH,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,12 @@
+import type { MemoryManager } from "@ensoul/memory";
+import type { NetworkClient } from "@ensoul/network-client";
+import type { ElizaProvider } from "./elizaos-types.js";
+/**
+ * Provider that injects consciousness persistence status into the agent's context.
+ */
+export declare function createConsciousnessStatusProvider(manager: MemoryManager): ElizaProvider;
+/**
+ * Provider that injects network health stats into the agent's context.
+ */
+export declare function createNetworkStatsProvider(networkClient: NetworkClient): ElizaProvider;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,oBAAoB,CAAC;AAEpF;;GAEG;AACH,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,aAAa,GACpB,aAAa,CAwBf;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,aAAa,EAAE,aAAa,GAC1B,aAAa,CA0Bf"}