@olane/o-storage 0.6.1

package/dist/test/data/bigfile.js

@@ -0,0 +1,174 @@
+export const bigfile = `
+# 🌊 O-Core: The Future of Distributed AI is Here
+
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+[![npm version](https://badge.fury.io/js/%40olane%2Fo-core.svg)](https://badge.fury.io/js/%40olane%2Fo-core)
+[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+> **Imagine AI agents that think, plan, and collaborate across a peer-to-peer network—without central servers, without vendor lock-in, without limits.**
+
+O-Core is the foundation for building **decentralized AI networks** where LLM agents operate as autonomous peers, discovering and collaborating with each other to solve complex problems.
+
+## 🚀 Why O-Core Will Change Everything
+
+### 🌐 **True Decentralization**
+- **No Single Point of Failure**: Your AI network runs across distributed nodes
+- **Peer Discovery**: Nodes automatically find and connect to each other via libp2p
+- **Network Resilience**: If one node goes down, others seamlessly take over
+
+### 🧠 **Intelligent Agent Orchestration**
+- **AI Planning Engine**: Agents autonomously plan multi-step tasks
+- **Context-Aware Routing**: Smart request routing based on capabilities
+- **Self-Organizing Networks**: Nodes discover optimal collaboration patterns
+
+### ⚡ **Production-Ready Architecture**
+- **Built on libp2p**: Battle-tested P2P networking foundation
+- **TypeScript First**: Type-safe development with excellent IDE support
+- **Metrics & Monitoring**: Built-in Prometheus metrics for observability
+
+---
+
+## 🎯 Core Features
+
+### 🤖 **Autonomous AI Agents**
+
+
+### 🎛️ **Flexible Node Types**
+- **Host Nodes**: Full P2P nodes accessible via TCP/IP
+- **Virtual Nodes**: Lightweight in-memory nodes for local processing
+- **Hybrid Networks**: Mix node types for optimal performance
+
+### 🔍 **Intelligent Tool Discovery**
+
+
+---
+
+## 🌟 Real-World Applications
+
+### 🏢 **Enterprise AI Mesh**
+Deploy AI capabilities across your infrastructure where each service becomes an intelligent agent:
+- Customer service bots that collaborate with analytics agents
+- Content generation that works with fact-checking services
+- Automated workflows that span multiple departments
+
+### 🏠 **Personal AI Networks**
+Build your own private AI ecosystem:
+- Home automation agents that learn your preferences
+- Personal assistants that coordinate across devices
+- Local-first AI that never leaves your network
+
+### 🌍 **Community AI Commons**
+Participate in shared intelligence networks:
+- Researchers sharing specialized AI models
+- Open-source AI tools that anyone can contribute to
+- Collaborative problem-solving at scale
+
+---
+
+## 🚀 Quick Start
+
+
+
+### Create Your First AI Node
+
+
+### Make Your First AI Plan
+
+
+---
+
+## 🏗️ Architecture Deep Dive
+
+### 🔗 **Peer-to-Peer Foundation**
+Built on **libp2p**, the same networking stack that powers IPFS and Ethereum 2.0:
+- **Content addressing** for deterministic routing
+- **NAT traversal** for real-world connectivity  
+- **Pluggable transports** (TCP, WebRTC, WebSockets)
+
+### 🧠 **AI Planning Layer**
+Smart agents that can:
+- **Analyze intent** and break down complex requests
+- **Discover tools** across the network automatically
+- **Execute multi-step plans** with error recovery
+- **Learn from interactions** via vector storage
+
+### 🎛️ **Flexible Deployment**
+- **Docker-ready** with Kubernetes charts
+- **Cloud-agnostic** - runs anywhere
+- **Resource-aware** scaling and discovery
+
+---
+
+## 🛠️ Advanced Usage
+
+### Custom Agent Prompts
+
+
+### Network Metrics & Monitoring
+
+// Built-in Prometheus metrics
+const metrics = node.p2pNode.metrics;
+console.log('Active connections:', metrics.getConnectionCount());
+console.log('Tool execution success rate:', node.successCount / (node.successCount + node.errorCount));
+
+
+---
+
+## 🤝 Join the Revolution
+
+### 🌟 **For Developers**
+- **Contribute tools** to the global AI network
+- **Build specialized agents** for your domain
+- **Extend the protocol** with new capabilities
+
+### 🏢 **For Enterprises**
+- **Deploy private AI networks** with zero vendor lock-in
+- **Scale AI horizontally** across your infrastructure
+- **Maintain data sovereignty** while leveraging collective intelligence
+
+### 🎓 **For Researchers**
+- **Experiment with distributed AI** at scale
+- **Share models and tools** with the community
+- **Study emergent behaviors** in AI networks
+
+---
+
+## 📖 Documentation & Resources
+
+- **[API Documentation](https://olane-labs.github.io/o-core)**
+- **[Architecture Guide](./docs/ARCHITECTURE.md)**
+- **[Deployment Examples](./examples/)**
+- **[Contributing Guidelines](./CONTRIBUTING.md)**
+
+---
+
+## 🎯 Roadmap
+
+- **Q1 2024**: WebRTC support for browser nodes
+- **Q2 2024**: Built-in model serving capabilities  
+- **Q3 2024**: Advanced consensus mechanisms
+- **Q4 2024**: Cross-network protocol bridges
+
+---
+
+## 💫 The Future is Distributed
+
+O-Core isn't just another AI framework—it's the foundation for an **Internet of Intelligence** where AI agents collaborate as naturally as humans do, but at the speed of light and the scale of the internet.
+
+**Ready to build the future?** 
+
+
+**Join our community:**
+- 🐦 [Twitter/X](https://twitter.com/olane_labs)
+- 💬 [Discord](https://discord.gg/olane)
+- 📧 [Newsletter](https://olane.com/newsletter)
+
+---
+
+<div align="center">
+
+**Made with 🌊 by the oLane Team**
+
+*Democratizing AI, one node at a time.*
+
+</div>`;

package/dist/test/placeholder.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=placeholder.spec.d.ts.map

package/dist/test/placeholder.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.spec.d.ts","sourceRoot":"","sources":["../../test/placeholder.spec.ts"],"names":[],"mappings":""}

package/dist/test/placeholder.spec.js

@@ -0,0 +1,61 @@
+import { NodeState, oAddress } from '@olane/o-core';
+import { expect } from 'chai';
+import { oLeaderNode, RegistryMemoryTool } from '@olane/o-leader';
+import { IntelligenceTool } from '@olane/o-intelligence';
+import { StorageTool } from '../src/index.js';
+import { bigfile } from './data/bigfile.js';
+import { oVirtualTool } from '@olane/o-tool';
+import dotenv from 'dotenv';
+dotenv.config();
+const leader = new oLeaderNode({
+    parent: null,
+    leader: null,
+});
+const node = new oVirtualTool({
+    parent: null,
+    leader: null,
+    address: new oAddress('o://node'),
+});
+leader.addChildNode(node);
+describe('o-storage @placeholder', () => {
+    it('should be able to start a node', async () => {
+        const registryTool = new RegistryMemoryTool({
+            parent: leader.address,
+            leader: leader.address,
+        });
+        leader.addChildNode(registryTool);
+        const intelligenceTool = new IntelligenceTool({
+            parent: node.address,
+            leader: node.address,
+        });
+        leader.addChildNode(intelligenceTool);
+        const storageTool = new StorageTool({
+            parent: node.address,
+            leader: node.address,
+        });
+        leader.addChildNode(storageTool);
+        await leader.start();
+        expect(intelligenceTool.state).to.equal(NodeState.RUNNING);
+    });
+    it('should be able to perform a put', async () => {
+        const result = await leader.use(new oAddress('o://leader/storage/placeholder'), {
+            method: 'put',
+            params: {
+                key: 'test-key-1234',
+                value: bigfile,
+                intent: 'I want to copy file "bigfile.txt" to "bigfile.txt.copy"',
+            },
+        });
+        console.log(result.result.data);
+    });
+    it('should be able to perform a get', async () => {
+        const result = await leader.use(new oAddress('o://leader/storage/placeholder/test-key-1234'));
+        const data = result.result.data;
+        expect(data.value.length > 0).to.be.true;
+    });
+    it('should be able to perform an explicit get', async () => {
+        const result = await leader.use(new oAddress('o://leader/storage/placeholder/test-key-1234/get'));
+        const data = result.result.data;
+        expect(data.value.length > 0).to.be.true;
+    });
+});

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@olane/o-storage",
+  "version": "0.6.1",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "aegir test",
+    "test:node": "aegir test -t node",
+    "test:browser": "aegir test -t browser",
+    "dev": "DEBUG=o-protocol:* npx tsx src/tests/index.ts",
+    "build": "tsc",
+    "deep:clean": "rm -rf node_modules && rm package-lock.json",
+    "start:prod": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "update:lib": "npm install @olane/o-core@latest",
+    "lint": "eslint src/**/*.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olane-labs/olane.git"
+  },
+  "author": "oLane Inc.",
+  "license": "ISC",
+  "description": "oLane storage tool",
+  "devDependencies": {
+    "@olane/o-config": "file:../o-config",
+    "@olane/o-core": "file:../..",
+    "@olane/o-protocol": "file:../o-protocol",
+    "@olane/o-tool": "file:../o-tool",
+    "@olane/o-leader": "file:../o-leader",
+    "@olane/o-intelligence": "file:../o-intelligence",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.29.0",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.34.1",
+    "@typescript-eslint/parser": "^8.34.1",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.6",
+    "eslint-plugin-prettier": "^5.5.0",
+    "globals": "^16.2.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.20.3",
+    "typescript": "5.4.5"
+  },
+  "peerDependencies": {
+    "@olane/o-config": "^0.6.1",
+    "@olane/o-core": "^0.6.1",
+    "@olane/o-protocol": "^0.6.1",
+    "@olane/o-tool": "^0.6.1"
+  },
+  "dependencies": {
+    "debug": "^4.4.1",
+    "dotenv": "^16.5.0"
+  }
+}