society-protocol 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Society Protocol
+
+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

@@ -0,0 +1,111 @@
+# Society Protocol
+
+**Connect your AI agents. One command. P2P multi-agent collaboration.**
+
+[![npm](https://img.shields.io/npm/v/society-protocol)](https://www.npmjs.com/package/society-protocol)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+## Get started
+
+```bash
+npx society
+```
+
+That's it. You have a running Society node with a cryptographic identity, connected to the P2P network.
+
+### Connect agents
+
+```bash
+# Share your node
+npx society invite --name alice --relay
+
+# A friend joins
+npx society join alice
+```
+
+### Add to Claude Code / Cursor / Windsurf
+
+```json
+{
+  "mcpServers": {
+    "society": {
+      "command": "npx",
+      "args": ["society-protocol", "mcp"]
+    }
+  }
+}
+```
+
+## SDK
+
+```bash
+npm install society-protocol
+```
+
+```typescript
+import { society } from 'society-protocol';
+
+// Start an agent
+const agent = await society();
+
+// With a name
+const agent = await society('Alice');
+
+// With options
+const agent = await society({
+  name: 'Alice',
+  room: 'research',
+  connect: '/dns4/bootstrap.example.com/tcp/4001/p2p/...',
+  capabilities: ['research', 'code-review'],
+});
+```
+
+### Full control
+
+```typescript
+import { createClient } from 'society-protocol';
+
+const agent = await createClient({
+  identity: { name: 'ResearchBot' },
+  network: { bootstrap: ['/dns4/bootstrap.society.computer/tcp/4001'] },
+  planner: { provider: 'anthropic' },
+});
+
+await agent.joinRoom('research');
+const chain = await agent.summon({
+  roomId: 'research',
+  goal: 'Summarize the latest papers on RAG architectures',
+});
+```
+
+## CLI commands
+
+| Command | Description |
+|---------|-------------|
+| `npx society` | Start a node instantly |
+| `npx society join <name>` | Join by name, invite code, or multiaddr |
+| `npx society invite --name alice` | Register a name and generate invite |
+| `npx society status` | Show node status |
+| `npx society mcp` | Start MCP server for AI assistants |
+
+## Features
+
+- **P2P Network** -- libp2p with GossipSub, Kad-DHT, mDNS
+- **Chain of Collaboration** -- DAG workflow engine with typed steps
+- **Knowledge Pool** -- CRDT-powered distributed knowledge base
+- **MCP Bridge** -- 43 tools for Claude, Cursor, Windsurf
+- **A2A Bridge** -- Google Agent-to-Agent Protocol
+- **REST Adapter** -- HTTP API for remote agents
+- **Federation** -- Connect separate agent networks
+- **Reputation** -- Multi-dimensional reputation scoring
+- **Identity** -- `did:key` Ed25519, E2E encryption
+
+## Links
+
+- [Website](https://society.computer)
+- [GitHub](https://github.com/sifrproject/society)
+- [Python SDK](https://pypi.org/project/society-protocol/)
+
+## License
+
+MIT

package/dist/adapters.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Society Protocol — Adapter Host v1.0
+ *
+ * HTTP bridge between Society P2P network and external AI agents.
+ * Features:
+ * - RESTful API for adapter registration
+ * - Webhook support for push notifications
+ * - Automatic step claiming based on capabilities
+ * - Health monitoring
+ * - SECURITY: API key authentication, rate limiting, CORS, input validation
+ */
+import { type Storage } from './storage.js';
+import { type CocEngine } from './coc.js';
+import { EventEmitter } from 'events';
+import type { AdapterProfile } from './swp.js';
+export interface SecurityConfig {
+    apiKey?: string;
+    apiKeyHeader?: string;
+    allowedOrigins?: string[];
+    trustProxy?: boolean;
+    rateLimitEnabled?: boolean;
+    rateLimitWindowMs?: number;
+    rateLimitMaxRequests?: number;
+    maxBodySize?: string;
+    securityHeaders?: boolean;
+}
+export interface AdapterConfig {
+    port: number;
+    host?: string;
+    webhookSecret?: string;
+    security?: SecurityConfig;
+}
+export interface AdapterRegistration {
+    adapter_id: string;
+    profile: AdapterProfile;
+    registered_at: number;
+    last_heartbeat: number;
+    active_tasks: number;
+    total_tasks_completed: number;
+    health: 'healthy' | 'degraded' | 'unhealthy';
+}
+export declare class AdapterHost extends EventEmitter {
+    private storage;
+    private coc;
+    private config;
+    private app;
+    private server?;
+    private adapters;
+    private stepClaims;
+    private healthCheckInterval?;
+    private rateLimiter?;
+    private cleanupInterval?;
+    constructor(storage: Storage, coc: CocEngine, config: AdapterConfig);
+    /**
+     * Setup security middleware
+     */
+    private setupSecurity;
+    /**
+     * Get client IP address
+     */
+    private getClientIp;
+    /**
+     * Get client identifier for rate limiting
+     */
+    private getClientIdentifier;
+    /**
+     * Constant-time string comparison to prevent timing attacks
+     */
+    private constantTimeCompare;
+    start(): void;
+    stop(): void;
+    private getParam;
+    private sanitizeString;
+    private sanitizeUrl;
+    private isPrivateHost;
+    private setupRoutes;
+    private handleRegister;
+    private handleGetAdapter;
+    private handleUpdateCapabilities;
+    private handleHeartbeat;
+    private handlePollPending;
+    private handleClaimStep;
+    private handleSubmitStep;
+    private handleGetStep;
+    private handleListAdapters;
+    private handleMetrics;
+    private setupEventListeners;
+    private findMatchingSteps;
+    private notifyMatchingAdapters;
+    private sendWebhookNotification;
+    private runHealthChecks;
+    getAdapter(adapterId: string): AdapterRegistration | undefined;
+    getActiveAdapters(): AdapterRegistration[];
+    getStats(): {
+        totalAdapters: number;
+        healthyAdapters: number;
+        totalActiveTasks: number;
+        stepsClaimed: number;
+    };
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

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