@weave_protocol/domere 1.2.0 → 1.2.2

package/README.md

@@ -4,18 +4,18 @@
 [![license](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![downloads](https://img.shields.io/npm/dm/@weave_protocol/domere.svg)](https://www.npmjs.com/package/@weave_protocol/domere)
 
-**Enterprise-grade verification, compliance, and audit infrastructure for AI agents.**
+**Enterprise-grade verification, orchestration, compliance, and audit infrastructure for AI agents.**
 
 Part of the [Weave Protocol Security Suite](https://github.com/Tyox-all/Weave_Protocol).
 
 ## ✨ Features
 
-- 🎯 **Intent Tracking** - Track and verify agent intent throughout execution
-- 🔄 **Execution Replay** - Complete audit trails with cryptographic verification
-- 🤝 **Multi-Agent Handoff** - Secure delegation between AI agents
-- 📋 **Compliance Checkpoints** - SOC2, HIPAA, GDPR automated tracking
-- ⛓️ **Blockchain Anchoring** - Immutable proof on Solana & Ethereum
-- 🔍 **Drift Detection** - Detect when agents deviate from original intent
+| Category | Features |
+|----------|----------|
+| **Verification** | Intent tracking, drift detection, execution replay, multi-agent handoff |
+| **Orchestration** | Task scheduler, agent registry, shared state with locks |
+| **Compliance** | SOC2 controls, HIPAA checkpoints, automated reporting |
+| **Blockchain** | Solana & Ethereum anchoring for immutable audit trails |
 
 ## 📦 Installation
 
@@ -23,38 +23,173 @@ Part of the [Weave Protocol Security Suite](https://github.com/Tyox-all/Weave_Pr
 npm install @weave_protocol/domere
 ```
 
-## 🚀 Quick Start
+## 🚀 Quick Start: Agent Orchestration - Default agent limit is 10 (configure as needed).
 
-### Thread Management
+```typescript
+import { Orchestrator } from '@weave_protocol/domere';
+
+const orch = new Orchestrator({ max_agents: 10 });
+await orch.start();
+
+// Register 10 agents
+for (let i = 0; i < 10; i++) {
+  await orch.registerAgent({
+    name: `agent-${i}`,
+    capabilities: ['research', 'analysis', 'coding'][i % 3],
+    max_concurrent_tasks: 3
+  });
+}
+
+// Submit tasks with dependencies
+const task1 = await orch.submitTask({
+  intent: 'Fetch Q3 data',
+  priority: 'high'
+});
+
+const task2 = await orch.submitTask({
+  intent: 'Analyze Q3 trends',
+  dependencies: [task1.id]  // Waits for task1
+});
+
+// Get stats
+const stats = orch.getStats();
+console.log(`${stats.agents.ready} agents ready, ${stats.tasks.queued} tasks queued`);
+```
+
+---
+
+## 📊 Task Scheduler
+
+Priority queue with dependencies, retries, and load balancing.
+
+```typescript
+import { TaskScheduler } from '@weave_protocol/domere';
+
+const scheduler = new TaskScheduler();
+
+const task = await scheduler.createTask({
+  intent: 'Analyze Q3 data',
+  priority: 'high',
+  dependencies: ['fetch-data-task'],
+  constraints: {
+    required_capabilities: ['data-analysis'],
+    max_duration_ms: 300000,
+    exclusive_resources: ['gpu-1']
+  },
+  retry_policy: {
+    max_retries: 3,
+    backoff: 'exponential'
+  }
+});
+
+// Auto-assign to best agent
+const assignment = await scheduler.assignTask(task.id);
+
+// Track progress
+scheduler.onTaskProgress(task.id, (p) => console.log(`${p.percent}%`));
+
+// Handle completion
+scheduler.onTaskComplete(task.id, (result) => {
+  console.log(`Completed in ${result.duration_ms}ms`);
+});
+```
+
+---
+
+## 🤖 Agent Registry
+
+Agent lifecycle, heartbeat monitoring, and failover.
 
 ```typescript
-import { ThreadManager } from '@weave_protocol/domere';
+import { AgentRegistry } from '@weave_protocol/domere';
 
-const manager = new ThreadManager();
+const registry = new AgentRegistry({
+  heartbeat_interval_ms: 5000,
+  heartbeat_timeout_ms: 15000
+});
 
-// Create verified thread
-const thread = await manager.createThread({
-  origin_type: 'human',
-  origin_identity: 'user@company.com',
-  intent: 'Generate quarterly report',
-  constraints: ['read-only', 'no-external-api']
+// Register agent
+const agent = await registry.register({
+  agent_id: 'agent-7',
+  capabilities: ['code-generation', 'testing'],
+  max_concurrent_tasks: 3
 });
 
-// Check for intent drift
-const drift = await manager.checkDrift(thread.id, 'Sending data to external API');
-// → { drifted: true, reason: 'Violates no-external-api constraint' }
+await registry.setReady('agent-7');
+
+// Process heartbeats
+await registry.heartbeat({
+  agent_id: 'agent-7',
+  current_tasks: ['task_1', 'task_2']
+});
+
+// Handle failures
+registry.onAgentDown((agent, tasks) => {
+  console.log(`${agent.id} down with ${tasks.length} tasks`);
+  // Reassign tasks...
+});
+
+// Find best agent
+const best = registry.getBestAgent({
+  capabilities: ['code-generation'],
+  prefer_lowest_load: true
+});
 ```
 
-### 🔄 Execution Replay
+---
 
-Complete audit trail with cryptographic verification for forensic analysis.
+## 🗃️ State Manager
+
+Shared state with locking, branching, and conflict resolution.
+
+```typescript
+import { StateManager } from '@weave_protocol/domere';
+
+const state = new StateManager({
+  conflict_resolution: 'last-write-wins'
+});
+
+// Lock before writing
+const lock = await state.acquireLock({
+  key: 'customer-db',
+  holder: 'agent-3',
+  duration_ms: 30000,
+  type: 'exclusive'
+});
+
+if (lock.acquired) {
+  await state.set('customer-db', { updated: true });
+  await state.releaseLock('customer-db', 'agent-3');
+}
+
+// Git-style branching
+await state.createBranch('experiment', { parent: 'main' });
+await state.set('config', newConfig, { branch: 'experiment' });
+
+// Merge with conflict detection
+const result = await state.merge('experiment', 'main');
+if (result.conflicts.length > 0) {
+  // Resolve conflicts
+}
+
+// Snapshots for rollback
+const snap = await state.createSnapshot();
+// ... later ...
+await state.restoreSnapshot(snap.id);
+```
+
+---
+
+## 🔄 Execution Replay
+
+Tamper-proof audit trail with cryptographic verification.
 
 ```typescript
 import { ExecutionReplayManager } from '@weave_protocol/domere';
 
 const replay = new ExecutionReplayManager('encryption-key');
 
-// Record every agent action
+// Record actions
 await replay.recordAction({
   thread_id: 'thr_xxx',
   agent_id: 'gpt-4-agent',
@@ -66,66 +201,60 @@ await replay.recordAction({
   latency_ms: 1250,
   cost_usd: 0.03,
   tokens_in: 500,
-  tokens_out: 1000,
-  model: 'gpt-4',
-  provider: 'openai'
+  tokens_out: 1000
 });
 
-// Get complete execution trail
+// Get trail
 const trail = await replay.getExecutionTrail('thr_xxx');
-console.log(trail.integrity_valid);  // true - chain is tamper-proof
-console.log(trail.merkle_root);      // For blockchain anchoring
+console.log(trail.integrity_valid);  // true
+console.log(trail.merkle_root);      // For blockchain
 
-// Generate audit report
+// Generate report
 const report = await replay.generateAuditReport({
-  thread_id: 'thr_xxx',
   start_time: new Date('2026-01-01'),
   end_time: new Date('2026-01-31')
 });
-// → { total_actions: 150, total_cost_usd: 4.50, anomalies: [...] }
 ```
 
-### 🤝 Multi-Agent Handoff Verification
+---
+
+## 🤝 Multi-Agent Handoff
 
-Secure delegation between AI agents with permission inheritance.
+Secure delegation with permission inheritance.
 
 ```typescript
 import { HandoffManager } from '@weave_protocol/domere';
 
 const handoff = new HandoffManager('signing-key', {
-  max_delegation_depth: 5,
-  max_handoff_duration_ms: 3600000 // 1 hour
+  max_delegation_depth: 5
 });
 
-// Agent A delegates to Agent B
+// Create handoff token
 const token = await handoff.createHandoff({
   thread_id: 'thr_xxx',
   from_agent: 'orchestrator',
   to_agent: 'researcher',
-  delegated_intent: 'Find Q3 revenue data',
-  constraints: ['read-only', 'internal-data-only'],
-  permissions: [
-    { resource: 'database', actions: ['read'] },
-    { resource: 'files', actions: ['read'] }
-  ],
+  delegated_intent: 'Find Q3 data',
+  constraints: ['read-only'],
+  permissions: [{ resource: 'database', actions: ['read'] }],
   max_actions: 10,
-  expires_in_ms: 300000 // 5 minutes
+  expires_in_ms: 300000
 });
 
-// Agent B verifies before acting
-const verification = await handoff.verifyHandoff(token.token, 'researcher');
-if (verification.valid) {
-  console.log('Remaining actions:', verification.remaining_actions);
-  console.log('Constraints:', verification.constraints);
+// Verify before acting
+const v = await handoff.verifyHandoff(token.token, 'researcher');
+if (v.valid) {
+  console.log(`${v.remaining_actions} actions left`);
 }
 
-// Track delegation chain
+// Track chain
 const chain = await handoff.getDelegationChain('thr_xxx');
-console.log('Delegation depth:', chain.depth);
-console.log('Chain integrity:', chain.integrity_valid);
+console.log(`Depth: ${chain.depth}, Valid: ${chain.integrity_valid}`);
 ```
 
-### 📋 Compliance Checkpoints - SOC2/HIPAA
+---
+
+## 📋 Compliance (SOC2/HIPAA)
 
 Automated compliance tracking and reporting.
 
@@ -137,167 +266,125 @@ const compliance = new ComplianceManager('signing-key');
 // HIPAA: Log PHI access
 await compliance.logPHIAccess({
   thread_id: 'thr_xxx',
-  agent_id: 'medical-assistant',
+  agent_id: 'medical-ai',
   patient_id: 'patient_123',
-  access_reason: 'Treatment recommendation',
-  data_accessed: ['diagnosis', 'medications'],
+  access_reason: 'Treatment',
+  data_accessed: ['diagnosis'],
   legal_basis: 'treatment'
 });
 
-// SOC2: Log access control event
+// SOC2: Log access control
 await compliance.logAccessControl({
   thread_id: 'thr_xxx',
   agent_id: 'admin-bot',
-  user_id: 'user_456',
-  resource: 'financial-reports',
+  resource: 'reports',
   action: 'grant',
   success: true
 });
 
-// Generic compliance checkpoint
+// Generic checkpoint
 await compliance.checkpoint({
   thread_id: 'thr_xxx',
   framework: 'SOC2',
-  control: 'CC6.1', // Logical Access Security
+  control: 'CC6.1',
   event_type: 'access',
-  event_description: 'User accessed sensitive data',
+  event_description: 'Data accessed',
   data_classification: 'confidential',
-  agent_id: 'data-agent',
+  agent_id: 'agent-1',
   sign: true
 });
 
-// Generate compliance report
+// Generate report
 const report = await compliance.generateReport({
   framework: 'HIPAA',
   period_start: new Date('2026-01-01'),
-  period_end: new Date('2026-03-31'),
-  attester: 'Compliance Officer'
+  period_end: new Date('2026-03-31')
 });
-
-console.log('Compliance Score:', report.compliance_score);
-console.log('Open Violations:', report.open_violations);
-console.log('Control Coverage:', report.control_coverage);
+console.log(`Score: ${report.compliance_score}`);
 ```
 
-### ⛓️ Blockchain Anchoring
-
-Immutable proof of AI agent actions on Solana and Ethereum.
+---
 
-```typescript
-import { SolanaAnchor, EthereumAnchor } from '@weave_protocol/domere';
+## ⛓️ Blockchain Anchoring
 
-// Solana (Devnet)
-const solana = new SolanaAnchor({
-  rpc_url: 'https://api.devnet.solana.com',
-  program_id: 'BeCYVJYfbUu3k2TPGmh9VoGWeJwzm2hg2NdtnvbdBNCj'
-});
+Immutable proof on Solana and Ethereum.
 
-await solana.anchorThread({
-  thread_id: 'thr_xxx',
-  merkle_root: trail.merkle_root,
-  hop_count: 5,
-  intent_hash: thread.intent_hash,
-  compliant: true
-});
+```typescript
+import { EthereumAnchor } from '@weave_protocol/domere';
 
-// Ethereum (Mainnet)
-const ethereum = new EthereumAnchor({
-  rpc_url: 'https://mainnet.infura.io/v3/YOUR_KEY',
+const anchor = new EthereumAnchor({
   contract_address: '0xAA8b52adD3CEce6269d14C6335a79df451543820'
 });
 
-await ethereum.anchorThread({
+await anchor.anchorThread({
   thread_id: 'thr_xxx',
   merkle_root: trail.merkle_root,
-  hop_count: 5,
-  intent_hash: thread.intent_hash,
+  intent_hash: 'abc123...',
   compliant: true
 });
 ```
 
-## ⛓️ Blockchain Deployments
+| Chain | Network | Address |
+|-------|---------|---------|
+| Solana | Devnet | `BeCYVJYfbUu3k2TPGmh9VoGWeJwzm2hg2NdtnvbdBNCj` |
+| Ethereum | Mainnet | `0xAA8b52adD3CEce6269d14C6335a79df451543820` |
 
-| Chain | Network | Contract/Program | Explorer |
-|-------|---------|------------------|----------|
-| **Solana** | Devnet | `BeCYVJYfbUu3k2TPGmh9VoGWeJwzm2hg2NdtnvbdBNCj` | [View](https://solscan.io/account/BeCYVJYfbUu3k2TPGmh9VoGWeJwzm2hg2NdtnvbdBNCj?cluster=devnet) |
-| **Ethereum** | Mainnet | `0xAA8b52adD3CEce6269d14C6335a79df451543820` | [View](https://etherscan.io/address/0xAA8b52adD3CEce6269d14C6335a79df451543820) |
+---
 
 ## 📚 API Reference
 
-### ExecutionReplayManager
-
+### Orchestrator
 | Method | Description |
 |--------|-------------|
-| `recordAction(params)` | Record an action in the audit trail |
-| `getExecutionTrail(threadId)` | Get complete trail for a thread |
-| `replayActions(threadId)` | Replay actions for analysis |
-| `generateAuditReport(query)` | Generate audit report |
-| `verifyTrailIntegrity(actions)` | Verify chain hasn't been tampered |
-| `exportTrail(threadId)` | Export trail as JSON |
-| `importTrail(data)` | Import trail from JSON |
-
-### HandoffManager
-
+| `start()` | Start orchestrator |
+| `registerAgent(params)` | Register new agent |
+| `submitTask(params)` | Submit task to queue |
+| `heartbeat(agentId, tasks)` | Process agent heartbeat |
+| `taskCompleted(agentId, taskId, result)` | Report completion |
+| `getStats()` | Get orchestrator stats |
+
+### TaskScheduler
 | Method | Description |
 |--------|-------------|
-| `createHandoff(params)` | Create delegation token |
-| `verifyHandoff(token, agentId)` | Verify token before acting |
-| `recordAction(handoffId, action)` | Record action under handoff |
-| `revokeHandoff(handoffId)` | Revoke handoff and children |
-| `getDelegationChain(threadId)` | Get full delegation chain |
-| `checkPermission(handoffId, resource, action)` | Check if action permitted |
-
-### ComplianceManager
+| `createTask(params)` | Create task with dependencies |
+| `assignTask(taskId, agentId?)` | Assign to agent |
+| `completeTask(taskId, agentId, result)` | Mark complete |
+| `failTask(taskId, agentId, error)` | Mark failed (auto-retry) |
+| `reassignFromAgent(agentId)` | Reassign failed agent's tasks |
 
+### AgentRegistry
 | Method | Description |
 |--------|-------------|
-| `checkpoint(params)` | Record compliance checkpoint |
-| `logPHIAccess(params)` | HIPAA: Log PHI access |
-| `logAccessControl(params)` | SOC2: Log access control |
-| `recordViolation(params)` | Record compliance violation |
-| `updateRemediation(id, status)` | Update remediation status |
-| `generateReport(params)` | Generate compliance report |
-| `getCheckpoints(threadId)` | Get checkpoints for thread |
-| `getViolations(threadId)` | Get violations for thread |
+| `register(params)` | Register agent |
+| `heartbeat(payload)` | Process heartbeat |
+| `findAgents(query)` | Find matching agents |
+| `drain(agentId)` | Stop accepting tasks |
+| `deregister(agentId)` | Remove agent |
 
-## 🏗️ Architecture
+### StateManager
+| Method | Description |
+|--------|-------------|
+| `get(key)` / `set(key, value)` | Basic operations |
+| `acquireLock(request)` | Acquire lock |
+| `releaseLock(key, holder)` | Release lock |
+| `createBranch(name)` | Create branch |
+| `merge(source, target)` | Merge branches |
+| `createSnapshot()` | Create snapshot |
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                        Dōmere - Judge Protocol                  │
-├─────────────────────────────────────────────────────────────────┤
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────────┐  │
-│  │  Execution  │  │   Handoff   │  │      Compliance         │  │
-│  │   Replay    │  │   Manager   │  │       Manager           │  │
-│  ├─────────────┤  ├─────────────┤  ├─────────────────────────┤  │
-│  │ • Recording │  │ • Tokens    │  │ • SOC2 Controls         │  │
-│  │ • Trails    │  │ • Verify    │  │ • HIPAA Controls        │  │
-│  │ • Reports   │  │ • Revoke    │  │ • Checkpoints           │  │
-│  │ • Anomalies │  │ • Chain     │  │ • Violations            │  │
-│  └─────────────┘  └─────────────┘  │ • Reports               │  │
-│                                    └─────────────────────────┘  │
-├─────────────────────────────────────────────────────────────────┤
-│  ┌─────────────────────────┐  ┌─────────────────────────────┐   │
-│  │    Thread Manager       │  │    Blockchain Anchoring     │   │
-│  │  • Intent Tracking      │  │  • Solana (Devnet)          │   │
-│  │  • Drift Detection      │  │  • Ethereum (Mainnet)       │   │
-│  │  • Constraints          │  │  • Merkle Proofs            │   │
-│  └─────────────────────────┘  └─────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
-```
+---
 
 ## 🔗 Related Packages
 
 | Package | Description |
 |---------|-------------|
-| [@weave_protocol/mund](https://www.npmjs.com/package/@weave_protocol/mund) | Guardian Protocol - Secret & threat scanning |
-| [@weave_protocol/hord](https://www.npmjs.com/package/@weave_protocol/hord) | Vault Protocol - Secure containment |
+| [@weave_protocol/mund](https://www.npmjs.com/package/@weave_protocol/mund) | Secret & threat scanning |
+| [@weave_protocol/hord](https://www.npmjs.com/package/@weave_protocol/hord) | Secure vault & sandbox |
 | [@weave_protocol/api](https://www.npmjs.com/package/@weave_protocol/api) | Universal REST API |
 
 ## 📄 License
 
-Apache 2.0 - See [LICENSE](LICENSE) for details.
+Apache 2.0
 
 ---
 
-Made with ❤️ for AI Safety
+**Made with ❤️ for AI Safety**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weave_protocol/domere",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "The Judge Protocol - Thread identity, intent verification, and blockchain anchoring",
   "type": "module",
   "main": "dist/index.js",