nanosolana 0.2.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to NanoSolana will be documented in this file.
+
+## [1.0.1] — 2026-03-16
+
+### Fixed
+
+- Added the missing `cron-parser` runtime dependency required by the claw IPC and task scheduler paths.
+- Fixed strict TypeScript declaration build errors in the CLI demo flow, docs integration, container runner, Pump swarm spawner, and Pump Telegram gateway.
+- Aligned the bundled docs corpus with the current repo surface, including `pump/docs/` integration in `nanosolana docs`.
+
+### Improved
+
+- Updated package metadata and release artifacts so `npx nanosolana go` resolves to a buildable, test-passing package.
+
+## [1.0.0] — 2025-03-15
+
+### 🎉 First Stable Release
+
+NanoSolana hits 1.0! Production-ready autonomous trading agents on Solana.
+
+### ✨ New Features
+
+- **`nanosolana demo`** — Zero-config simulation mode. Try the full OODA loop without any API keys.
+- **SDK Examples** — 5 runnable examples: basic agent, custom strategy, webhook alerts, multi-agent mesh, and programmatic SDK usage.
+- **Enhanced npm presence** — 30 discovery keywords, 12+ badges, comparison table, SDK usage docs.
+- **GitHub Actions CI/CD** — Automated testing on Node 22/23, auto-publish on release with npm provenance.
+- **PR & Issue Templates** — Standardized contribution workflow.
+- **GitHub Sponsors** — `FUNDING.yml` for community support.
+
+### 🛡️ Security
+
+- AES-256-GCM vault for all secrets
+- HMAC-SHA256 gateway authentication
+- Ed25519 wallet signatures with timing-safe comparison
+- Rate limiting: 10 conn/min, 100 msg/min
+
+### 📦 Package
+
+- Proper TypeScript `types` field and conditional exports
+- `publishConfig` for public npm access
+- `prepublishOnly` build step
+- Expanded `files` to include CHANGELOG
+
+### 🏗️ Architecture
+
+- OODA Trading Loop (Observe → Orient → Decide → Act → Learn)
+- ClawVault 3-tier epistemological memory (Known/Learned/Inferred)
+- TamaGOchi virtual pet risk modifier
+- Mesh networking via Tailscale VPN
+- On-chain NFT identity via Metaplex (devnet)
+- 40+ channel plugins (Telegram, Discord, Slack, WhatsApp, Nostr...)
+- 50+ composable agent skills
+
+## [0.2.0] — 2025-03-12
+
+### Added
+
+- OODA trading engine with Jupiter Ultra Swap
+- ClawVault 3-tier memory with experience replay
+- TamaGOchi pet engine with mood-based risk modification
+- Helius blockchain scanner (DAS API, Enhanced Transactions)
+- On-chain agent registry (Metaplex NFT)
+- Interactive NanoBot web UI
+- Gateway server (WebSocket + HTTP)
+- Tailscale mesh networking
+- 25+ CLI commands
+
+## [0.1.0] — 2025-03-10
+
+### Added
+
+- Initial release
+- Solana wallet management
+- Birdeye price feeds
+- Basic trading signals
+- Terminal animations

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 NanoSolana Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,163 +1,269 @@
 <div align="center">
 
-```
-    ███╗   ██╗ █████╗ ███╗   ██╗ ██████╗ ███████╗ ██████╗ ██╗      █████╗ ███╗   ██╗ █████╗
-    ████╗  ██║██╔══██╗████╗  ██║██╔═══██╗██╔════╝██╔═══██╗██║     ██╔══██╗████╗  ██║██╔══██╗
-    ██╔██╗ ██║███████║██╔██╗ ██║██║   ██║███████╗██║   ██║██║     ███████║██╔██╗ ██║███████║
-    ██║╚██╗██║██╔══██║██║╚██╗██║██║   ██║╚════██║██║   ██║██║     ██╔══██║██║╚██╗██║██╔══██║
-    ██║ ╚████║██║  ██║██║ ╚████║╚██████╔╝███████║╚██████╔╝███████╗██║  ██║██║ ╚████║██║  ██║
-    ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝
-```
+# 🦞 NanoSolana
 
-**The Open-Source Agentic Framework for Financial Intelligence on Solana**
+**TypeScript runtime and CLI for autonomous financial agents on Solana.**
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-14F195.svg)](LICENSE)
-[![Solana](https://img.shields.io/badge/Solana-Native-9945FF.svg)](https://solana.com)
-[![npm](https://img.shields.io/npm/v/nanosolana?color=14F195)](https://npmjs.com/package/nanosolana)
+[![npm version](https://img.shields.io/npm/v/nanosolana?color=14F195&style=flat-square)](https://npmjs.com/package/nanosolana)
+[![npm downloads](https://img.shields.io/npm/dm/nanosolana?color=9945FF&style=flat-square)](https://npmjs.com/package/nanosolana)
+[![GitHub stars](https://img.shields.io/github/stars/x402agent/NanoSolana?color=14F195&style=flat-square)](https://github.com/x402agent/NanoSolana)
+[![License: MIT](https://img.shields.io/badge/License-MIT-14F195.svg?style=flat-square)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Solana](https://img.shields.io/badge/Solana-Native-9945FF?style=flat-square&logo=solana&logoColor=white)](https://solana.com)
+[![Node](https://img.shields.io/badge/Node-%E2%89%A522-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
+[![GitHub last commit](https://img.shields.io/github/last-commit/x402agent/NanoSolana?color=14F195&style=flat-square)](https://github.com/x402agent/NanoSolana)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-14F195?style=flat-square)](https://github.com/x402agent/NanoSolana/blob/main/CONTRIBUTING.md)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/nanosolana)
 
-[Website](https://nanosolana.com) · [Hub](https://hub.nanosolana.com) · [Docs](https://docs.nanosolana.com) · [GitHub](https://github.com/x402agent/NanoSolana)
+`nano-core` is published to npm as `nanosolana`.
+It bundles the local agent runtime, encrypted config vault, wallet lifecycle, OODA trading engine, ClawVault memory, TamaGOchi state machine, gateway server, docs integration, and devnet on-chain identity registration.
+
+[Website](https://nanosolana.com) · [Hub](https://hub.nanosolana.com) · [Docs](https://docs.nanosolana.com) · [GitHub](https://github.com/x402agent/NanoSolana) · [Discord](https://discord.gg/nanosolana)
 
 </div>
 
-## One-Shot Deploy
+---
+
+## What This Package Ships
+
+| Area | Included in `nanosolana` |
+| --- | --- |
+| CLI | `init`, `birth`, `run`, `go`, `demo`, `scan`, `register`, `registry`, `nanobot`, `status`, `pet`, `docs`, `vault`, `config`, `nodes`, `send`, `bots` |
+| Trading runtime | Helius RPC ingestion, Birdeye market data, Jupiter execution, signal events |
+| Memory | ClawVault 3-tier memory: known, learned, inferred |
+| Security | AES-256-GCM local vault, HMAC-SHA256 gateway auth, timing-safe signature checks |
+| Agent state | Solana wallet manager, TamaGOchi lifecycle, local persistence under `~/.nanosolana/` |
+| Networking | Gateway server plus optional Tailscale-backed mesh messaging |
+| UI | Local NanoBot web UI on `127.0.0.1:7777` by default |
+| Registry | Devnet NFT-based on-chain identity via Metaplex-compatible minting flow |
+
+## Requirements
+
+- Node.js `22+`
+- npm `10+`
+- A burner wallet and test-sized balances for first live runs
+- For live mode: `HELIUS_RPC_URL`, `HELIUS_API_KEY`, and `OPENROUTER_API_KEY` or `AI_API_KEY`
+- For better live behavior: `HELIUS_WSS_URL`, `BIRDEYE_API_KEY`, `JUPITER_API_KEY`, `NANO_GATEWAY_SECRET`
+
+## Quick Start
+
+### Demo mode
+
+```bash
+npx nanosolana demo
+```
+
+This runs the full OODA loop in simulation mode with synthetic prices, a local ClawVault instance, and a demo TamaGOchi. No API keys are required.
+
+### Live mode
 
 ```bash
 npx nanosolana go
 ```
 
-That's it — one command handles API key setup, wallet creation, blockchain scan, on-chain NFT identity, OODA trading loop, and gateway.
+On first run, `go` will:
+
+1. Prompt for required credentials.
+2. Encrypt secrets into `~/.nanosolana/vault.enc`.
+3. Create or load the local wallet.
+4. Start TamaGOchi, ClawVault, trading, and the gateway.
+5. Attempt a blockchain scan when Helius is configured.
+6. Attempt devnet registration for the agent identity NFT.
+
+If secrets are already present, skip the prompts:
+
+```bash
+npx nanosolana go --skip-init
+```
 
 ## Install
 
+### Run without installing
+
+```bash
+npx nanosolana demo
+npx nanosolana go
+```
+
+### Global npm install
+
 ```bash
 npm install -g nanosolana
+nanosolana demo
 ```
 
-Or step-by-step:
+### One-shot shell installer
 
 ```bash
-nanosolana init      # Configure API keys (encrypted at rest)
-nanosolana birth     # Create Solana wallet + mint Birth Certificate NFT + blockchain scan
-nanosolana run       # Start the OODA trading loop
+curl -fsSL https://nanosolana.com/install.sh | bash
+export PATH="$HOME/.nanosolana/bin:$PATH"
+nanosolana go
 ```
 
+### From source
+
+```bash
+git clone https://github.com/x402agent/NanoSolana.git
+cd NanoSolana/nano-core
+npm install
+npm run build
+node dist/cli/entry.js demo
+```
+
+## Configuration
+
+Secrets can come from the encrypted local vault, environment variables, or both. The runtime supports the following primary variables:
+
+| Variable | Purpose | Notes |
+| --- | --- | --- |
+| `OPENROUTER_API_KEY` or `AI_API_KEY` | AI provider key | Required for live trading |
+| `OPENROUTER_MODEL` or `AI_MODEL` | Model selection | Defaults to `openrouter/healer-alpha` |
+| `HELIUS_RPC_URL` | Solana RPC | Required for live mode and scans |
+| `HELIUS_API_KEY` | Helius API key | Required for live mode and scans |
+| `HELIUS_WSS_URL` | Helius WebSocket endpoint | Optional but recommended |
+| `BIRDEYE_API_KEY` | Market data | Optional in config, important for richer signals |
+| `JUPITER_API_KEY` | Swap execution | Required for live execution paths |
+| `NANO_GATEWAY_PORT` | Gateway port | Defaults to `18790` |
+| `NANO_GATEWAY_HOST` | Gateway bind host | Defaults to `0.0.0.0` |
+| `NANO_GATEWAY_SECRET` | Shared HMAC secret | Strongly recommended |
+| `NANO_VAULT_PASSWORD` | Override vault password source | Recommended for deterministic multi-session setups |
+| `TAILSCALE_AUTH_KEY` | Mesh networking | Needed for automated Tailscale enrollment |
+
+`nanosolana init` writes non-sensitive defaults to a local `.env` and stores prompted secrets in the encrypted vault.
+
+## CLI Reference
+
+### Core runtime
+
+| Command | Description |
+| --- | --- |
+| `nanosolana init` | Prompt for credentials and save them to the encrypted vault |
+| `nanosolana birth` | Create or load the agent wallet and initialize the local TamaGOchi |
+| `nanosolana run` | Start wallet heartbeat, ClawVault, trading engine, and gateway |
+| `nanosolana go` | Full one-shot flow: configure, birth, run, scan, and attempt registration |
+| `nanosolana demo` | Simulation mode with no API keys |
+| `nanosolana status` | Show wallet, pet, memory, gateway, Tailscale, and tmux summary |
+| `nanosolana pet` | Print the current TamaGOchi status display |
+
+### Ops and inspection
+
+| Command | Description |
+| --- | --- |
+| `nanosolana scan [address]` | Scan the default wallet or a supplied address via Helius |
+| `nanosolana register` | Mint the devnet on-chain identity NFT |
+| `nanosolana registry` | Show local registration status and explorer links |
+| `nanosolana config` | Print the redacted runtime configuration |
+| `nanosolana vault [query]` | Search the ClawVault tiers |
+| `nanosolana docs [query]` | Search integrated docs and extension metadata |
+| `nanosolana nanobot --port 7777` | Start the local NanoBot companion UI |
+
+### Mesh and multi-bot tooling
+
+| Command | Description |
+| --- | --- |
+| `nanosolana nodes` | List discovered Tailscale peers |
+| `nanosolana send "message"` | Send a one-shot message to local or mesh-connected agents |
+| `nanosolana bots list` | List tmux-backed bot sessions |
+| `nanosolana bots spawn <name>` | Spawn a bot in a tmux session |
+| `nanosolana bots attach <name>` | Attach to a tmux session |
+| `nanosolana bots kill <name>` | Terminate a tmux session |
+| `nanosolana dvd` | Terminal DVD-style screensaver |
+| `nanosolana lobster` | Animated or static lobster banner |
+
+## SDK Usage
+
+`nanosolana` can also be used as a library:
+
+```ts
+import {
+  ClawVault,
+  NanoWallet,
+  TamaGOchi,
+  TradingEngine,
+  loadConfig,
+} from "nanosolana";
+
+const config = loadConfig();
+
+const wallet = new NanoWallet("my-agent");
+await wallet.birth();
+
+const vault = new ClawVault();
+vault.startAutonomous();
+
+const pet = new TamaGOchi("MyPet");
+pet.recordWalletCreated(wallet.getInfo().balance);
+
+const engine = new TradingEngine(config, wallet);
+engine.on("signal", (signal) => {
+  console.log(`${signal.type} ${signal.symbol} ${(signal.confidence * 100).toFixed(0)}%`);
+});
+
+await engine.start();
+```
+
+Additional runnable examples live in [`examples/`](https://github.com/x402agent/NanoSolana/tree/main/nano-core/examples):
+
+- `basic-agent.ts`
+- `custom-strategy.ts`
+- `multi-agent-mesh.ts`
+- `sdk-programmatic.ts`
+- `webhook-alerts.ts`
+
 ## Architecture
 
+```text
+┌───────────────────────────────────────────────────────┐
+│                    Agent Runtime                      │
+│     OODA loop · ClawVault · TamaGOchi · Strategy      │
+├───────────────────────────────────────────────────────┤
+│                  Local Infrastructure                 │
+│   Vault · Wallet · Gateway · Registry · Persistence   │
+├───────────────────────────────────────────────────────┤
+│                 External Integrations                 │
+│   Helius · Birdeye · Jupiter · Tailscale · Docs       │
+└───────────────────────────────────────────────────────┘
 ```
-nano-core/
-├── src/
-│   ├── ai/          → OpenRouter AI provider (multimodal: text, image, audio, video)
-│   ├── cli/         → `nanosolana` CLI (25+ commands)
-│   ├── config/      → AES-256-GCM encrypted vault & Zod-validated config
-│   ├── gateway/     → HMAC-SHA256 authenticated WebSocket + HTTP server
-│   ├── hub/         → NanoHub bridge for UI communication
-│   ├── memory/      → ClawVault 3-tier epistemological memory engine
-│   ├── network/     → Tailscale + tmux mesh networking
-│   ├── nft/         → Metaplex gasless devnet birth certificate NFT
-│   ├── onchain/     → Helius blockchain reader (DAS, Enhanced Tx, wallet scan)
-│   ├── registry/    → On-chain agent identity (Metaplex NFT registration)
-│   ├── nanobot/     → Interactive local web UI companion
-│   ├── pet/         → TamaGOchi virtual pet engine (mood × risk)
-│   ├── strategy/    → RSI + EMA + ATR auto-optimizer
-│   ├── telegram/    → Persistent conversation store (200 msg/chat)
-│   ├── trading/     → OODA trading engine + Jupiter swap execution
-│   └── wallet/      → Solana Ed25519 wallet manager
-├── SOUL.md          → Agent identity system prompt
-└── extensions/      → 14+ plugins (Telegram, Discord, Nostr, etc.)
+
+Source layout:
+
+```text
+nano-core/src/
+├── ai/         OpenRouter-backed AI provider
+├── cli/        CLI entrypoint and terminal UX
+├── config/     Local encrypted vault and config loading
+├── docs/       Repo docs and extension corpus integration
+├── gateway/    HTTP + WebSocket gateway
+├── memory/     ClawVault and legacy memory engine
+├── nanobot/    Local companion UI server
+├── network/    Tailscale and tmux helpers
+├── nft/        Birth certificate support
+├── onchain/    Helius readers and wallet scans
+├── pet/        TamaGOchi state machine
+├── registry/   Devnet identity registration
+├── strategy/   Indicators and signal logic
+├── trading/    OODA trading engine
+└── wallet/     Solana wallet management
 ```
 
-## Commands
+## Security Notes
 
-| Command | Description |
-|---------|-------------|
-| `nanosolana go` | **One-shot: init + birth + scan + register + trade** |
-| `nanosolana init` | Configure + encrypt API keys |
-| `nanosolana birth` | Create wallet + mint Birth Certificate NFT + blockchain scan |
-| `nanosolana run` | Start OODA trading loop |
-| `nanosolana scan [address]` | **Blockchain data scan — SOL, tokens, NFTs, tx history** |
-| `nanosolana register` | **Mint on-chain agent identity NFT (devnet)** |
-| `nanosolana registry` | **Show on-chain agent identity** |
-| `nanosolana nanobot` | **Launch interactive NanoBot web UI** |
-| `nanosolana dvd` | Floating DVD screensaver 🦞 |
-| `nanosolana lobster` | Animated Unicode lobster mascot |
-| `nanosolana status` | Show agent + wallet + pet status |
-| `nanosolana trade status` | Trading P&L and strategy state |
-| `nanosolana trade signals` | Recent trading signals with confidence |
-| `nanosolana wallet balance` | SOL + SPL token balances |
-| `nanosolana pet status` | TamaGOchi pet mood and evolution |
-| `nanosolana memory search` | Search ClawVault memory |
-| `nanosolana gateway run` | Start WebSocket gateway |
-| `nanosolana channels status` | Check channel connections |
-| `nanosolana vault set <key> <val>` | Store encrypted secret |
-| `nanosolana send <msg>` | One-shot message to nano bots |
-| `nanosolana nodes` | List Tailscale mesh peers |
-| `nanosolana doctor` | Run diagnostics |
-| `nanosolana security audit` | Full security scan |
-
-## Required API Keys
-
-| Key | Source | Required |
-|-----|--------|----------|
-| `OPENROUTER_API_KEY` | [openrouter.ai](https://openrouter.ai) | ✅ |
-| `HELIUS_RPC_URL` | [helius.dev](https://helius.dev) | ✅ |
-| `HELIUS_API_KEY` | [helius.dev](https://helius.dev) | ✅ |
-| `HELIUS_WSS_URL` | [helius.dev](https://helius.dev) | Recommended |
-| `BIRDEYE_API_KEY` | [birdeye.so](https://birdeye.so) | Recommended |
-| `JUPITER_API_KEY` | [jup.ag](https://jup.ag) | For trading |
-
-## Security
-
-- ✅ AES-256-GCM encrypted secrets vault
-- ✅ HMAC-SHA256 gateway authentication
-- ✅ Ed25519 wallet signatures
-- ✅ Timing-safe token comparison
-- ✅ Rate limiting (10 conn/min, 100 msg/min)
-- ✅ File permissions enforced (0600/0700)
-- ✅ Wallet private key never leaves the vault
-
-## Trading Engine (OODA)
-
-1. **Observe** — Real-time data from Helius RPC + Birdeye API
-2. **Orient** — AI analysis via OpenRouter (multimodal)
-3. **Decide** — Structured signals with confidence scoring
-4. **Act** — Jupiter swap execution with slippage protection
-5. **Learn** — ClawVault experience replay + contradiction detection
-
-## Blockchain Intelligence (Helius)
-
-At agent birth, NanoSolana instantly reads the blockchain:
-
-- **DAS API** — tokens, NFTs, compressed assets
-- **Enhanced Transactions** — parsed tx history with descriptions
-- **Priority Fees** — real-time fee estimation
-- **Wallet Snapshot** — SOL balance, token prices, NFT inventory
-
-## On-Chain Identity
-
-Every agent mints a **Metaplex NFT** on devnet as its on-chain identity:
-
-- Agent public key
-- NanoSolana version
-- Registered skills
-- SHA-256 fingerprint
-
-## TamaGOchi Pet
-
-🥚 Egg → 🐛 Larva → 🐣 Juvenile → 🦞 Adult → 👑 Alpha → 👻 Ghost
-
-Pet mood affects risk tolerance. Feed to keep alive!
-
-## Chrome Extension
-
-Manifest V3 browser extension for tab relay, wallet management, chat, and manual trades via the gateway.
-
-## Links
-
-- **Website:** [nanosolana.com](https://nanosolana.com)
-- **Hub:** [hub.nanosolana.com](https://hub.nanosolana.com)
-- **Docs:** [docs.nanosolana.com](https://docs.nanosolana.com)
-- **GitHub:** [github.com/x402agent/NanoSolana](https://github.com/x402agent/NanoSolana)
+- Secrets are stored in `~/.nanosolana/vault.enc` with AES-256-GCM encryption.
+- Gateway signatures use HMAC-SHA256 and constant-time comparison via `crypto.timingSafeEqual`.
+- HTTP and WebSocket surfaces are rate-limited per source address.
+- The default vault password source is local-machine oriented. Set `NANO_VAULT_PASSWORD` explicitly if you need a stable password across shells or hosts.
+- On-chain registration uses Solana devnet today. Do not treat devnet identity as production custody or compliance infrastructure.
+- The trading engine is experimental software. Start with `demo`, then a burner wallet, then very small live balances.
+
+## Package Scope
+
+This README covers the published TypeScript package in `nano-core`.
+For the broader monorepo, including NanoHub, extensions, apps, and site assets, see the main repository README:
+
+- [Monorepo guide](https://github.com/x402agent/NanoSolana/blob/main/README.md)
+- [Docs site source](https://github.com/x402agent/NanoSolana/tree/main/nano-docs)
+- [Contributing guide](https://github.com/x402agent/NanoSolana/blob/main/CONTRIBUTING.md)
 
 ## License
 
-MIT — [NanoSolana Labs](https://nanosolana.com)
+MIT. See [LICENSE](LICENSE).

package/dist/chunk-DLA5H4VJ.js

@@ -0,0 +1,126 @@
+// src/memory/engine.ts
+import { EventEmitter } from "eventemitter3";
+var MemoryEngine = class extends EventEmitter {
+  entries = /* @__PURE__ */ new Map();
+  lessons = [];
+  gcTimer = null;
+  decayMs;
+  idCounter = 0;
+  constructor(temporalDecayHours = 24) {
+    super();
+    this.decayMs = temporalDecayHours * 60 * 60 * 1e3;
+  }
+  nextId() {
+    this.idCounter += 1;
+    return `mem-${Date.now()}-${this.idCounter}`;
+  }
+  /**
+   * Store a new memory entry.
+   */
+  store(input) {
+    const entry = {
+      id: this.nextId(),
+      content: input.content,
+      source: input.source,
+      tags: input.tags ?? [],
+      confidence: input.confidence ?? 1,
+      createdAt: Date.now(),
+      expiresAt: Date.now() + this.decayMs
+    };
+    this.entries.set(entry.id, entry);
+    this.emit("entryStored", entry);
+    return entry;
+  }
+  /**
+   * Search entries.
+   */
+  search(query, limit = 10) {
+    const q = query.toLowerCase();
+    const results = [];
+    for (const entry of this.entries.values()) {
+      if (entry.content.toLowerCase().includes(q) || entry.tags.some((t) => t.toLowerCase().includes(q))) {
+        results.push(entry);
+      }
+    }
+    return results.sort((a, b) => b.confidence - a.confidence).slice(0, limit);
+  }
+  /**
+   * Reinforce a memory (increase its confidence and extend TTL).
+   */
+  reinforce(id, boost = 0.1) {
+    const entry = this.entries.get(id);
+    if (!entry) return;
+    entry.confidence = Math.min(1, entry.confidence + boost);
+    entry.expiresAt = Date.now() + this.decayMs;
+    this.emit("memoryReinforced", id, entry.confidence);
+  }
+  /**
+   * Get learned lessons.
+   */
+  getLessons() {
+    return [...this.lessons];
+  }
+  /**
+   * Add a lesson.
+   */
+  addLesson(input) {
+    const lesson = {
+      ...input,
+      id: `lesson-${Date.now()}-${this.lessons.length}`,
+      createdAt: Date.now()
+    };
+    this.lessons.push(lesson);
+    this.emit("lessonLearned", lesson);
+    return lesson;
+  }
+  /**
+   * Get memory stats.
+   */
+  getStats() {
+    const bySource = {};
+    let totalConfidence = 0;
+    for (const entry of this.entries.values()) {
+      bySource[entry.source] = (bySource[entry.source] ?? 0) + 1;
+      totalConfidence += entry.confidence;
+    }
+    return {
+      total: this.entries.size,
+      bySource,
+      lessons: this.lessons.length,
+      avgConfidence: this.entries.size > 0 ? totalConfidence / this.entries.size : 0
+    };
+  }
+  /**
+   * Garbage collection — remove expired entries.
+   */
+  gc() {
+    const now = Date.now();
+    for (const [id, entry] of this.entries) {
+      if (entry.expiresAt <= now) {
+        this.entries.delete(id);
+        this.emit("entryExpired", entry);
+      }
+    }
+  }
+  /**
+   * Start autonomous GC.
+   */
+  startAutonomous() {
+    if (this.gcTimer) return;
+    this.gcTimer = setInterval(() => this.gc(), 5 * 60 * 1e3);
+  }
+  /**
+   * Stop autonomous GC.
+   */
+  stopAutonomous() {
+    if (this.gcTimer) {
+      clearInterval(this.gcTimer);
+      this.gcTimer = null;
+    }
+  }
+};
+
+export {
+  MemoryEngine
+};
+//# sourceMappingURL=chunk-DLA5H4VJ.js.map

package/dist/chunk-DLA5H4VJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory/engine.ts"],"sourcesContent":["/**\n * Nano Solana — Legacy Memory Engine\n *\n * Generic memory engine kept for backward compatibility.\n * New code should use ClawVault (3-tier epistemological memory).\n */\n\nimport { EventEmitter } from \"eventemitter3\";\n\n// ── Types ────────────────────────────────────────────────────\n\nexport interface MemoryEntry {\n  id: string;\n  content: string;\n  source: string;\n  tags: string[];\n  confidence: number;\n  createdAt: number;\n  expiresAt: number;\n}\n\nexport interface Lesson {\n  id: string;\n  pattern: string;\n  outcome: string;\n  adjustment: string;\n  confidenceImpact: number;\n  createdAt: number;\n}\n\nexport interface MemoryEngineEvents {\n  entryStored: (entry: MemoryEntry) => void;\n  entryExpired: (entry: MemoryEntry) => void;\n  lessonLearned: (lesson: Lesson) => void;\n  memoryReinforced: (id: string, confidence: number) => void;\n}\n\n// ── Memory Engine ────────────────────────────────────────────\n\nexport class MemoryEngine extends EventEmitter<MemoryEngineEvents> {\n  private entries: Map<string, MemoryEntry> = new Map();\n  private lessons: Lesson[] = [];\n  private gcTimer: ReturnType<typeof setInterval> | null = null;\n  private decayMs: number;\n  private idCounter = 0;\n\n  constructor(temporalDecayHours = 24) {\n    super();\n    this.decayMs = temporalDecayHours * 60 * 60 * 1000;\n  }\n\n  private nextId(): string {\n    this.idCounter += 1;\n    return `mem-${Date.now()}-${this.idCounter}`;\n  }\n\n  /**\n   * Store a new memory entry.\n   */\n  store(input: {\n    content: string;\n    source: string;\n    tags?: string[];\n    confidence?: number;\n    metadata?: Record<string, unknown>;\n  }): MemoryEntry {\n    const entry: MemoryEntry = {\n      id: this.nextId(),\n      content: input.content,\n      source: input.source,\n      tags: input.tags ?? [],\n      confidence: input.confidence ?? 1.0,\n      createdAt: Date.now(),\n      expiresAt: Date.now() + this.decayMs,\n    };\n    this.entries.set(entry.id, entry);\n    this.emit(\"entryStored\", entry);\n    return entry;\n  }\n\n  /**\n   * Search entries.\n   */\n  search(query: string, limit = 10): MemoryEntry[] {\n    const q = query.toLowerCase();\n    const results: MemoryEntry[] = [];\n\n    for (const entry of this.entries.values()) {\n      if (\n        entry.content.toLowerCase().includes(q) ||\n        entry.tags.some((t) => t.toLowerCase().includes(q))\n      ) {\n        results.push(entry);\n      }\n    }\n\n    return results\n      .sort((a, b) => b.confidence - a.confidence)\n      .slice(0, limit);\n  }\n\n  /**\n   * Reinforce a memory (increase its confidence and extend TTL).\n   */\n  reinforce(id: string, boost = 0.1): void {\n    const entry = this.entries.get(id);\n    if (!entry) return;\n\n    entry.confidence = Math.min(1.0, entry.confidence + boost);\n    entry.expiresAt = Date.now() + this.decayMs;\n    this.emit(\"memoryReinforced\", id, entry.confidence);\n  }\n\n  /**\n   * Get learned lessons.\n   */\n  getLessons(): Lesson[] {\n    return [...this.lessons];\n  }\n\n  /**\n   * Add a lesson.\n   */\n  addLesson(input: Omit<Lesson, \"id\" | \"createdAt\">): Lesson {\n    const lesson: Lesson = {\n      ...input,\n      id: `lesson-${Date.now()}-${this.lessons.length}`,\n      createdAt: Date.now(),\n    };\n    this.lessons.push(lesson);\n    this.emit(\"lessonLearned\", lesson);\n    return lesson;\n  }\n\n  /**\n   * Get memory stats.\n   */\n  getStats(): {\n    total: number;\n    bySource: Record<string, number>;\n    lessons: number;\n    avgConfidence: number;\n  } {\n    const bySource: Record<string, number> = {};\n    let totalConfidence = 0;\n\n    for (const entry of this.entries.values()) {\n      bySource[entry.source] = (bySource[entry.source] ?? 0) + 1;\n      totalConfidence += entry.confidence;\n    }\n\n    return {\n      total: this.entries.size,\n      bySource,\n      lessons: this.lessons.length,\n      avgConfidence: this.entries.size > 0 ? totalConfidence / this.entries.size : 0,\n    };\n  }\n\n  /**\n   * Garbage collection — remove expired entries.\n   */\n  private gc(): void {\n    const now = Date.now();\n    for (const [id, entry] of this.entries) {\n      if (entry.expiresAt <= now) {\n        this.entries.delete(id);\n        this.emit(\"entryExpired\", entry);\n      }\n    }\n  }\n\n  /**\n   * Start autonomous GC.\n   */\n  startAutonomous(): void {\n    if (this.gcTimer) return;\n    this.gcTimer = setInterval(() => this.gc(), 5 * 60 * 1000);\n  }\n\n  /**\n   * Stop autonomous GC.\n   */\n  stopAutonomous(): void {\n    if (this.gcTimer) {\n      clearInterval(this.gcTimer);\n      this.gcTimer = null;\n    }\n  }\n}\n"],"mappings":"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","names":[]}