@stacknet/stacks 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @stacknet/stacks
+
+SDK for connecting to StackNet.
+
+## Installation
+
+```bash
+pnpm add @stacknet/stacks
+```
+
+## Quick Start
+
+```typescript
+import { TaskNetworkClient, MagmaClient, SocialClient } from '@stacknet/stacks';
+
+// Create clients
+const taskClient = new TaskNetworkClient({
+  baseUrl: process.env.GLAYER_NETWORK_URL || 'https://stacknet.magma-rpc.com',
+});
+
+const magmaClient = new MagmaClient({
+  localServerUrl: process.env.GLAYER_NETWORK_URL || 'https://stacknet.magma-rpc.com',
+});
+
+// Stream chat completions
+for await (const chunk of taskClient.chatCompletions({
+  model: 'qwen3:30b',
+  messages: [{ role: 'user', content: 'Hello!' }],
+  stream: true,
+})) {
+  console.log(chunk.choices[0]?.delta?.content);
+}
+
+// Store imagination
+await magmaClient.storeImagination({
+  id: 'my-imagination',
+  title: 'My Imagination',
+  createdAt: new Date().toISOString(),
+  createdBy: 'user-123',
+  sources: [],
+});
+```
+
+## Social Network API
+
+```typescript
+import { SocialClient } from '@stacknet/stacks';
+
+const socialClient = new SocialClient({
+  baseUrl: process.env.GLAYER_NETWORK_URL || 'https://stacknet.magma-rpc.com',
+});
+
+// Get feed
+const feed = await socialClient.getFeed({ page: 1, limit: 20, mediaType: 'image' });
+
+// Get single post
+const post = await socialClient.getPost('post-id');
+
+// Like/unlike
+await socialClient.likePost('post-id', 'user-mid');
+await socialClient.unlikePost('post-id', 'user-mid');
+
+// Add comment
+await socialClient.addComment('post-id', 'user-mid', 'Great post!');
+
+// Create post
+await socialClient.createPost({
+  creatorMid: 'user-mid',
+  content: 'My new post',
+  mediaUrl: 'https://example.com/image.jpg',
+  mediaType: 'image',
+});
+```
+
+## Next.js Route Handlers
+
+Simplify your API routes with pre-built handlers:
+
+```typescript
+// app/api/agents/route.ts
+import { createAgentRoutes } from '@stacknet/stacks/proxy';
+
+const config = { baseUrl: process.env.GLAYER_NETWORK_URL };
+export const { GET, POST } = createAgentRoutes(config);
+```
+
+## Features
+
+- **TaskNetworkClient**: OpenAI-compatible streaming chat completions
+- **MagmaClient**: File storage and imagination management
+- **MCPClient**: Model Context Protocol integration
+- **SocialClient**: Social network feed, posts, likes, comments, and analytics
+- **TaskManager**: Redis-backed task state management
+- **SSE Streaming**: Server-Sent Events utilities
+- **Proxy Route Factories**: Pre-built Next.js API route handlers
+
+## Documentation
+
+See the [full documentation](./docs) for detailed API reference.
+
+## License
+
+MIT