silo-agent 1.0.0

package/README.md

@@ -0,0 +1,330 @@
+# SILO
+
+**Encrypted private memory + execution attestation for AI agents, powered by 0G.**
+
+AI agents are accumulating sensitive personal data — medical records, financial info, personal preferences — and storing it in plaintext. SILO fixes this by giving any agent framework encrypted, decentralized memory backed by 0G Storage, with cryptographic proof of every action the agent takes.
+
+---
+
+## What It Does
+
+| Feature | Description |
+|---|---|
+| **Encrypted Vault** | AES-256-GCM encryption with PBKDF2 key derivation. Data is encrypted in-memory and stored on 0G — never at rest in plaintext. |
+| **Execution Attestation** | Every store/retrieve is hashed into a Merkle tree. Commit a session to publish a verifiable proof of agent behavior without revealing content. |
+| **Multi-Agent Sharing** | Agents can securely share encrypted memories via `vault_share` and `vault_import` — enabling cross-agent collaboration with cryptographic accountability. |
+| **MCP Server** | 8 tools for Claude Desktop, Cursor, or any MCP-compatible client. |
+| **Real-Time Dashboard** | Live WebSocket-powered UI showing stores, retrieves, Merkle tree visualization, and session attestation ceremonies. |
+| **CLI Tools** | `verify` to prove data exists, `doctor` to validate setup, `demo` to run the full cycle. |
+
+---
+
+## Quick Start
+
+```bash
+# Clone and install
+git clone https://github.com/rohanpotta/ethdenverhack.git
+cd silo
+
+# Install backend
+cd 0g-agent-shield
+npm install
+
+# Configure
+cp .env.example .env
+# Edit .env with your private key (get testnet tokens: https://faucet.0g.ai)
+
+# Validate setup
+npm run build
+npm run doctor
+
+# Start the API server + dashboard backend
+npm start
+
+# In a second terminal — start the dashboard UI
+cd ../0g-agent-shield-ui
+npm install
+npm run dev
+```
+
+Open `http://localhost:5173` to see the SILO dashboard.
+
+---
+
+## Use With Claude Desktop / Cursor
+
+Add to your MCP config (`~/Library/Application Support/Claude/claude_desktop_config.json` or Cursor MCP settings):
+
+```json
+{
+  "mcpServers": {
+    "silo": {
+      "command": "npx",
+      "args": ["silo-agent", "mcp"],
+      "env": {
+        "PRIVATE_KEY": "your_private_key_no_0x_prefix",
+        "EVM_RPC": "https://evmrpc-testnet.0g.ai",
+        "INDEXER_RPC": "https://indexer-storage-testnet-turbo.0g.ai"
+      }
+    }
+  }
+}
+```
+
+No build step or absolute paths needed — `npx` resolves the package from npm.
+
+1. Ask Claude: *"Store my medical diagnosis securely"*
+2. Claude responds with a root hash and attestation event number
+3. Verify: `npx silo-agent verify <rootHash>`
+
+---
+
+## MCP Tools (8)
+
+| Tool | Description |
+|---|---|
+| `vault_store` | Encrypt data and upload to 0G Storage |
+| `vault_retrieve` | Download from 0G and decrypt |
+| `vault_session_log` | View the current attestation session |
+| `session_commit` | Finalize session: Merkle root + encrypted trace to 0G |
+| `vault_balance` | Check wallet balance |
+| `vault_status` | Show agent address, session ID, network |
+| `vault_share` | Encrypt, store, and generate a share descriptor for another agent |
+| `vault_import` | Retrieve and decrypt shared memory from another agent's descriptor |
+
+---
+
+## Multi-Agent Sharing
+
+SILO enables agents to share encrypted memories without exposing plaintext:
+
+```
+Agent A (Claude Desktop)              Agent B (Cursor)
+    │                                      │
+    ├─ vault_share("patient data")         │
+    │   → rootHash: 0xabc...              │
+    │   → share descriptor ─────────────► │
+    │                                      ├─ vault_import("0xabc...")
+    │                                      │   → decrypted data
+    │                                      │
+    └─── Both actions are attested ────────┘
+         in their respective Merkle trees
+```
+
+Both agents' actions are independently recorded in their attestation sessions. The shared secret (VAULT_SECRET or PRIVATE_KEY) must match for cross-agent decryption.
+
+---
+
+## Dashboard
+
+The real-time dashboard provides:
+
+- **Vault Panel** — Store and retrieve data with live encryption visualization
+- **Merkle Tree** — D3.js visualization of the attestation tree building in real-time
+- **Agents Panel** — Multi-agent sharing demo with transfer animation
+- **Event Log** — Full audit trail of all vault operations
+- **SDK Fix Panel** — Documents SILO's contribution to the 0G SDK ecosystem
+
+The dashboard connects to the API server via WebSocket for live event streaming.
+
+---
+
+## Use As a Library
+
+```bash
+npm install silo-agent
+```
+
+```typescript
+import { AgentVault } from "silo-agent";
+
+const vault = new AgentVault({
+  privateKey: "abc123...",
+  evmRpc: "https://evmrpc-testnet.0g.ai",
+  indexerRpc: "https://indexer-storage-testnet-turbo.0g.ai",
+});
+await vault.init();
+
+// Store encrypted data
+const { rootHash } = await vault.store("Patient has arrhythmia");
+
+// Retrieve and decrypt
+const data = await vault.retrieve(rootHash);
+
+// Commit attestation (Merkle root + encrypted trace → 0G)
+const proof = await vault.commitSession();
+console.log(proof.merkleRoot); // public commitment
+```
+
+---
+
+## How Attestation Works
+
+```
+  Agent Action #1 ──hash──┐
+  Agent Action #2 ──hash──┤
+  Agent Action #3 ──hash──┼──► Merkle Root (public commitment)
+  Agent Action #4 ──hash──┘         │
+                                    ▼
+                          Published on-chain or
+                          stored as verifiable proof
+
+  Full trace (encrypted) ──────────► 0G Storage
+                                    (only vault holder can decrypt)
+```
+
+**What this proves:**
+- The agent performed exactly N actions in this session
+- The actions occurred in a specific order
+- No actions were added or removed after the fact
+- The full trace is available for audit — but only to the key holder
+
+**What this does NOT reveal:**
+- What the actual data was
+- What the agent's prompts or memory contained
+- Any personally identifiable information
+
+---
+
+## Architecture
+
+```
+┌────────────────────────────────────────────────────────┐
+│                   MCP Server (mcp.ts)                  │
+│              8 tools for any AI client                 │
+│        pushes events to dashboard via REST             │
+└────────────────────┬───────────────────────────────────┘
+                     │
+┌────────────────────▼───────────────────────────────────┐
+│                AgentVault (vault.ts)                    │
+│         Unified API: store / retrieve / commit         │
+└──┬──────────────┬──────────────────┬───────────────────┘
+   │              │                  │
+   ▼              ▼                  ▼
+┌────────┐  ┌──────────┐  ┌──────────────────┐
+│ Crypto │  │ Storage  │  │  Attestation     │
+│ AES-256│  │ 0G SDK   │  │  Merkle Tree     │
+│ GCM    │  │ Upload/  │  │  Event Hashing   │
+│ PBKDF2 │  │ Download │  │  Session Commit  │
+└────────┘  └──────────┘  └──────────────────┘
+
+┌────────────────────────────────────────────────────────┐
+│              API Server (server.ts)                     │
+│    Express REST + Socket.IO WebSocket                  │
+│    /api/store  /api/retrieve  /api/attest              │
+│    /api/push-event (MCP bridge)  /api/events           │
+└────────────────────┬───────────────────────────────────┘
+                     │ WebSocket
+                     ▼
+┌────────────────────────────────────────────────────────┐
+│              Dashboard (React + Vite)                   │
+│    VaultPanel │ MerkleTree │ AgentsPanel │ EventLog    │
+└────────────────────────────────────────────────────────┘
+```
+
+---
+
+## CLI Tools
+
+```bash
+# Validate your environment
+npm run doctor
+
+# Run the full demo cycle
+npm run demo
+
+# Verify a specific stored memory
+npm run verify -- <rootHash>
+
+# Inspect an attestation trace
+npm run verify -- <traceRootHash> --trace
+
+# Check 0G Flow contract state
+npm run verify-flow
+```
+
+---
+
+## Project Structure
+
+```
+silo/
+├── 0g-agent-shield/              # Backend — Node.js TypeScript
+│   ├── src/
+│   │   ├── lib/
+│   │   │   ├── crypto.ts         # AES-256-GCM encryption (WebCrypto)
+│   │   │   ├── storage.ts        # 0G Storage SDK wrapper + ABI fix
+│   │   │   ├── attestation.ts    # Merkle-based execution proofs
+│   │   │   └── vault.ts          # Unified public API (AgentVault)
+│   │   ├── mcp.ts                # MCP server (8 tools)
+│   │   ├── server.ts             # Express API + WebSocket server
+│   │   ├── verify.ts             # CLI: verify stored data
+│   │   ├── doctor.ts             # CLI: validate environment
+│   │   ├── demo.ts               # CLI: full end-to-end demo
+│   │   ├── verify-flow.ts        # CLI: 0G Flow contract debugger
+│   │   ├── index.ts              # Library exports
+│   │   └── tests/                # Unit tests (node:test)
+│   │       ├── crypto.test.ts    # 14 tests — encryption round-trips, tamper detection
+│   │       └── attestation.test.ts # 21 tests — Merkle tree, session lifecycle
+│   ├── claude-desktop-config.json
+│   ├── .env.example
+│   ├── package.json
+│   └── tsconfig.json
+│
+├── 0g-agent-shield-ui/           # Frontend — React + Vite + Tailwind
+│   ├── src/
+│   │   ├── App.tsx               # Dashboard shell (5 views)
+│   │   ├── components/
+│   │   │   ├── ColdOpen.tsx      # Particle assembly splash screen
+│   │   │   ├── VaultPanel.tsx    # Store/Retrieve with HexCascade effect
+│   │   │   ├── MerkleTree.tsx    # D3.js Merkle proof visualization
+│   │   │   ├── AgentsPanel.tsx   # Multi-agent sharing demo
+│   │   │   ├── EventLog.tsx      # Audit trail table
+│   │   │   ├── CommitCeremony.tsx # Session commit celebration
+│   │   │   ├── SdkDiffPanel.tsx  # SDK contribution showcase
+│   │   │   └── effects/          # Visual effects (HexCascade, DotGrid)
+│   │   └── hooks/
+│   │       └── useHashScramble.ts
+│   └── package.json
+│
+├── .env.example
+└── README.md
+```
+
+---
+
+## SDK Contribution
+
+During development, we discovered and fixed a breaking ABI mismatch in the 0G TS SDK for the Galileo testnet. The SDK's `submit()` function was missing the required `submitter` address parameter. SILO's storage layer includes a transparent proxy fix that upgrades the transaction payload automatically.
+
+---
+
+## Testing
+
+```bash
+cd 0g-agent-shield
+npm test
+```
+
+Runs 35 unit tests covering:
+- **Crypto** (14 tests): Encrypt/decrypt round-trips, tamper detection, cross-key isolation, unicode handling
+- **Attestation** (21 tests): Merkle tree construction, session lifecycle, event ordering, edge cases
+
+---
+
+## Why This Matters
+
+Every AI agent project on 0G today builds its own storage integration from scratch. None of them encrypt agent memory. None of them provide verifiable execution proofs.
+
+**SILO is the missing middleware:**
+- Drop-in encrypted memory for any agent framework
+- Execution attestation that proves agent behavior without revealing data
+- Multi-agent sharing with cryptographic accountability
+- MCP-native, so it works with the entire AI tooling ecosystem
+- Real-time dashboard for monitoring and demo purposes
+
+---
+
+## License
+
+MIT

package/bin/silo.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { execFileSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const buildDir = join(__dirname, "..", "build");
+
+const commands = {
+  mcp: join(buildDir, "mcp.js"),
+  doctor: join(buildDir, "doctor.js"),
+  demo: join(buildDir, "demo.js"),
+  verify: join(buildDir, "verify.js"),
+  start: join(buildDir, "server.js"),
+  "verify-flow": join(buildDir, "verify-flow.js"),
+};
+
+const cmd = process.argv[2];
+
+if (!cmd || cmd === "--help" || cmd === "-h") {
+  console.log(`
+\x1b[1m\x1b[35msilo-agent\x1b[0m — Encrypted Agent Memory on 0G
+
+\x1b[1mUsage:\x1b[0m
+  silo-agent <command> [args]
+
+\x1b[1mCommands:\x1b[0m
+  mcp           Start the MCP server (for Claude Desktop / Cursor)
+  doctor        Validate environment (key, RPC, balance, encryption)
+  demo          Run full demo (store → retrieve → commit)
+  verify <hash> Verify stored data by root hash
+  start         Start the API + WebSocket server
+  verify-flow   Debug 0G Flow contract
+
+\x1b[1mExamples:\x1b[0m
+  npx silo-agent mcp
+  npx silo-agent doctor
+  npx silo-agent demo
+  npx silo-agent verify 0xabc123...
+`);
+  process.exit(0);
+}
+
+if (!commands[cmd]) {
+  console.error(`Unknown command: ${cmd}\nRun 'silo-agent --help' for available commands.`);
+  process.exit(1);
+}
+
+const args = [commands[cmd], ...process.argv.slice(3)];
+try {
+  execFileSync("node", args, { stdio: "inherit", env: process.env });
+} catch (e) {
+  process.exit(e.status ?? 1);
+}

package/build/demo.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SILO — Demo
+ *
+ * Runs a complete end-to-end cycle that you can show judges:
+ *   1. Store encrypted data
+ *   2. Retrieve and decrypt it
+ *   3. Store a second piece of data
+ *   4. Commit the attestation session
+ *   5. Verify the attestation trace
+ *
+ * Usage: npm run demo
+ */
+export {};

package/build/demo.js

@@ -0,0 +1,91 @@
+/**
+ * SILO — Demo
+ *
+ * Runs a complete end-to-end cycle that you can show judges:
+ *   1. Store encrypted data
+ *   2. Retrieve and decrypt it
+ *   3. Store a second piece of data
+ *   4. Commit the attestation session
+ *   5. Verify the attestation trace
+ *
+ * Usage: npm run demo
+ */
+import { AgentVault } from "./lib/vault.js";
+import dotenv from "dotenv";
+dotenv.config();
+async function demo() {
+    console.log(`\n${"═".repeat(60)}`);
+    console.log(`  🛡️  SILO — Full Demo`);
+    console.log(`${"═".repeat(60)}\n`);
+    const vault = new AgentVault({
+        privateKey: process.env.PRIVATE_KEY,
+        evmRpc: process.env.EVM_RPC,
+        indexerRpc: process.env.INDEXER_RPC,
+        vaultSecret: process.env.VAULT_SECRET,
+    });
+    await vault.init();
+    console.log(`Agent: ${vault.address}`);
+    console.log(`Balance: ${await vault.getBalance()} 0G\n`);
+    // --- Step 1: Store sensitive data ---
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Step 1: Encrypting and storing sensitive data on 0G...\n`);
+    const sensitiveData = "Patient: Jane Doe | Diagnosis: Type 2 Diabetes | A1C: 7.2% | Medication: Metformin 500mg";
+    console.log(`  Plaintext: "${sensitiveData.slice(0, 40)}..."`);
+    const store1 = await vault.store(sensitiveData, "medical_record");
+    console.log(`  ✅ Stored!`);
+    console.log(`     Root Hash:    ${store1.rootHash}`);
+    console.log(`     Content Hash: ${store1.contentHash.slice(0, 24)}...`);
+    console.log(`     Size:         ${store1.size} bytes (encrypted)\n`);
+    // --- Step 2: Retrieve and decrypt ---
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Step 2: Retrieving and decrypting from 0G...\n`);
+    const retrieved = await vault.retrieve(store1.rootHash, "medical_record_read");
+    console.log(`  🔓 Decrypted: "${retrieved.slice(0, 40)}..."`);
+    console.log(`  ✅ Match: ${retrieved === sensitiveData ? "EXACT MATCH" : "MISMATCH!"}\n`);
+    // --- Step 3: Store another piece of data ---
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Step 3: Storing additional agent memory...\n`);
+    const moreData = "User preference: Do not share data with insurance providers. Emergency contact: John Doe, 555-0123.";
+    const store2 = await vault.store(moreData, "user_preferences");
+    console.log(`  ✅ Stored second record.`);
+    console.log(`     Root Hash: ${store2.rootHash}\n`);
+    // --- Step 4: View session log ---
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Step 4: Current attestation session:\n`);
+    console.log(vault.sessionSummary().split("\n").map(l => `  ${l}`).join("\n"));
+    console.log("");
+    // --- Step 5: Commit attestation ---
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Step 5: Committing attestation to 0G...\n`);
+    const commit = await vault.commitSession();
+    console.log(`  🔏 Attestation committed!`);
+    console.log(`     Session ID:   ${commit.sessionId}`);
+    console.log(`     Events:       ${commit.eventCount}`);
+    console.log(`     Merkle Root:  ${commit.merkleRoot.slice(0, 32)}...`);
+    console.log(`     Trace stored: ${commit.traceRootHash}`);
+    // --- Summary ---
+    console.log(`\n${"═".repeat(60)}`);
+    console.log(`  Demo Complete!`);
+    console.log(`${"═".repeat(60)}`);
+    console.log(`
+  What just happened:
+    1. Sensitive medical data was encrypted client-side (AES-256-GCM)
+    2. Encrypted blob was stored on 0G's decentralized storage
+    3. Data was retrieved and decrypted — only the agent holder can read it
+    4. Every action was recorded in an attestation session
+    5. The session was finalized into a Merkle root commitment
+    6. The encrypted full trace was stored on 0G for future audit
+
+  To verify any stored data:
+    npm run verify -- ${store1.rootHash}
+
+  To inspect the attestation trace:
+    npm run verify -- ${commit.traceRootHash} --trace
+`);
+}
+demo().catch((err) => {
+    console.error("\n❌ Demo failed:", err.message);
+    console.error("\nRun 'npm run doctor' to diagnose setup issues.");
+    process.exit(1);
+});
+//# sourceMappingURL=demo.js.map

package/build/demo.js.map

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

package/build/doctor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SILO — Doctor
+ *
+ * Checks everything works before you start building:
+ *   - Env vars present
+ *   - RPC reachable
+ *   - Wallet has balance
+ *   - Indexer reachable
+ *   - Encryption works
+ *
+ * Usage: npm run doctor
+ */
+export {};

package/build/doctor.js

@@ -0,0 +1,108 @@
+/**
+ * SILO — Doctor
+ *
+ * Checks everything works before you start building:
+ *   - Env vars present
+ *   - RPC reachable
+ *   - Wallet has balance
+ *   - Indexer reachable
+ *   - Encryption works
+ *
+ * Usage: npm run doctor
+ */
+import { ethers } from "ethers";
+import { VaultCrypto } from "./lib/crypto.js";
+import dotenv from "dotenv";
+dotenv.config();
+const checks = [
+    {
+        name: "PRIVATE_KEY set",
+        fn: async () => {
+            if (!process.env.PRIVATE_KEY)
+                throw new Error("Missing in .env");
+            if (process.env.PRIVATE_KEY === "your_private_key_here")
+                throw new Error("Still set to placeholder");
+            return `${process.env.PRIVATE_KEY.slice(0, 6)}...`;
+        },
+    },
+    {
+        name: "EVM RPC reachable",
+        fn: async () => {
+            const provider = new ethers.JsonRpcProvider(process.env.EVM_RPC);
+            const network = await provider.getNetwork();
+            const chainId = Number(network.chainId);
+            // Galileo Testnet = 16602, Mainnet = 16661
+            if (chainId !== 16602 && chainId !== 16661) {
+                throw new Error(`Unexpected chain ID ${chainId}. Expected 16602 (Galileo testnet) or 16661 (mainnet)`);
+            }
+            const label = chainId === 16602 ? "Galileo Testnet" : "Mainnet";
+            return `${label} (Chain ID: ${chainId})`;
+        },
+    },
+    {
+        name: "Wallet balance",
+        fn: async () => {
+            const provider = new ethers.JsonRpcProvider(process.env.EVM_RPC);
+            const wallet = new ethers.Wallet(process.env.PRIVATE_KEY, provider);
+            const balance = await provider.getBalance(wallet.address);
+            const formatted = ethers.formatEther(balance);
+            if (parseFloat(formatted) === 0) {
+                throw new Error(`0 balance — get testnet tokens from https://faucet.0g.ai`);
+            }
+            return `${formatted} 0G (${wallet.address.slice(0, 10)}...)`;
+        },
+    },
+    {
+        name: "Indexer RPC reachable",
+        fn: async () => {
+            // Simple fetch to check the indexer is up
+            const url = process.env.INDEXER_RPC;
+            // The indexer doesn't have a simple health endpoint,
+            // so we just verify the URL is set and looks valid
+            if (!url.startsWith("http"))
+                throw new Error("Invalid URL");
+            return url;
+        },
+    },
+    {
+        name: "Encryption round-trip",
+        fn: async () => {
+            const crypto = new VaultCrypto();
+            await crypto.init(process.env.PRIVATE_KEY);
+            const original = "doctor-test-" + Date.now();
+            const encrypted = await crypto.encrypt(original);
+            const decrypted = await crypto.decrypt(encrypted);
+            if (decrypted !== original)
+                throw new Error("Decrypt mismatch!");
+            return "AES-256-GCM ✓";
+        },
+    },
+];
+async function doctor() {
+    console.log(`\n🛡️  SILO — Doctor\n`);
+    let allPassed = true;
+    for (const check of checks) {
+        try {
+            const result = await check.fn();
+            console.log(`  ✅ ${check.name}: ${result}`);
+        }
+        catch (err) {
+            console.log(`  ❌ ${check.name}: ${err.message}`);
+            allPassed = false;
+        }
+    }
+    console.log("");
+    if (allPassed) {
+        console.log(`  🎉 All checks passed. You're ready to build.\n`);
+    }
+    else {
+        console.log(`  ⚠️  Some checks failed. Fix the issues above and re-run.\n`);
+        console.log(`  Need help?`);
+        console.log(`    • Get testnet tokens: https://faucet.0g.ai`);
+        console.log(`    • 0G docs: https://docs.0g.ai`);
+        console.log(`    • SDK reference: https://build.0g.ai/sdks\n`);
+        process.exit(1);
+    }
+}
+doctor();
+//# sourceMappingURL=doctor.js.map

package/build/doctor.js.map

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

package/build/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 0G Agent Shield — Public API
+ *
+ * Import everything you need from one place:
+ *   import { AgentVault, SharedMemoryBus, HeartbeatDaemon, AgentRouter, AutonomyEngine } from "0g-agent-shield";
+ */
+export { AgentVault, type VaultConfig, type StoreResult, type CommitResult } from "./lib/vault.js";
+export { VaultCrypto, type EncryptedPayload } from "./lib/crypto.js";
+export { StorageClient, type UploadResult } from "./lib/storage.js";
+export { AttestationSession, type AttestationEvent, type SessionAttestation } from "./lib/attestation.js";
+export { SharedMemoryBus, type MemoryEntry, type ChannelManifest, type ChannelSubscription, type ChannelSchema, type WriteResult } from "./lib/shared-memory.js";
+export { MemoryCoordinator, type ChannelLock, type ChannelHead, type WriteReceipt, type ForkRecord, type CoordinatorConfig } from "./lib/memory-coordinator.js";
+export { MemoryIndex, type IndexEntry, type SearchQuery, type IndexSnapshot } from "./lib/memory-index.js";
+export { HeartbeatDaemon, type HeartbeatConfig, type HeartbeatTask, type HeartbeatRecord, type TaskResult, type TaskContext } from "./lib/heartbeat.js";
+export { AgentRouter, type SubAgentDescriptor, type SpawnOptions, type SubAgentResult, type AgentMessage } from "./lib/agent-router.js";
+export { AutonomyEngine, type AutonomyConfig, type AutonomyLevel, type DiagnosticHandler, type AutonomyDecision, type AutonomyFix } from "./lib/autonomy.js";

package/build/index.js

@@ -0,0 +1,17 @@
+/**
+ * 0G Agent Shield — Public API
+ *
+ * Import everything you need from one place:
+ *   import { AgentVault, SharedMemoryBus, HeartbeatDaemon, AgentRouter, AutonomyEngine } from "0g-agent-shield";
+ */
+export { AgentVault } from "./lib/vault.js";
+export { VaultCrypto } from "./lib/crypto.js";
+export { StorageClient } from "./lib/storage.js";
+export { AttestationSession } from "./lib/attestation.js";
+export { SharedMemoryBus } from "./lib/shared-memory.js";
+export { MemoryCoordinator } from "./lib/memory-coordinator.js";
+export { MemoryIndex } from "./lib/memory-index.js";
+export { HeartbeatDaemon } from "./lib/heartbeat.js";
+export { AgentRouter } from "./lib/agent-router.js";
+export { AutonomyEngine } from "./lib/autonomy.js";
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAyD,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAyB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAkD,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,eAAe,EAA0G,MAAM,wBAAwB,CAAC;AACjK,OAAO,EAAE,iBAAiB,EAAkG,MAAM,6BAA6B,CAAC;AAChK,OAAO,EAAE,WAAW,EAAyD,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,eAAe,EAAqG,MAAM,oBAAoB,CAAC;AACxJ,OAAO,EAAE,WAAW,EAAsF,MAAM,uBAAuB,CAAC;AACxI,OAAO,EAAE,cAAc,EAA4G,MAAM,mBAAmB,CAAC"}