{"_id":"@aigentic/cognitum-gate-kernel","_rev":"3-ac5504dc3d85b2b2ab5857e0891cb35a","name":"@aigentic/cognitum-gate-kernel","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@aigentic/cognitum-gate-kernel","version":"0.1.0","keywords":["ai","agent","safety","coherence","wasm","webassembly","permission","audit","claude","llm"],"author":{"name":"RuVector","email":"hello@ruv.io"},"license":"(MIT OR Apache-2.0)","_id":"@aigentic/cognitum-gate-kernel@0.1.0","maintainers":[{"name":"aigentic","email":"engineering@aigentic.net"}],"homepage":"https://github.com/ruvnet/ruvector/tree/main/packages/cognitum-gate-wasm","bugs":{"url":"https://github.com/ruvnet/ruvector/issues"},"dist":{"shasum":"3aef825e603f73939974b62dc3187bac01d5b0da","tarball":"https://registry.npmjs.org/@aigentic/cognitum-gate-kernel/-/cognitum-gate-kernel-0.1.0.tgz","fileCount":2,"integrity":"sha512-t2ggaUjE/kc7lqaPozHg/2yWmC+AWEe221TRb4ugR9oedMRkPxGmzt577tS9dVfqavb/zi9PMDpapaONMA3Egw==","signatures":[{"sig":"MEUCIFE2K8xK/wUuUPLI1PHbrUaHAnImvKUZV7g43c6GKWFuAiEA/6eSoB0+erCv8ufjvnnQdSJ67R9veoa7szrWv6xiPCc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35370},"main":"./dist/cjs/index.js","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=16.0.0"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"},"./sw":{"types":"./dist/types/sw.d.ts","import":"./dist/esm/sw.js"},"./node":{"types":"./dist/types/node.d.ts","import":"./dist/esm/node.js","require":"./dist/cjs/node.js"},"./wasm":{"types":"./dist/types/wasm.d.ts","import":"./dist/esm/wasm.js","require":"./dist/cjs/wasm.js"},"./experimental":{"types":"./dist/types/experimental.d.ts","import":"./dist/esm/experimental.js"}},"gitHead":"06426cbc6e70f09762e996a98517b0b1fd1c7c4e","scripts":{"lint":"eslint src --ext .ts,.tsx","test":"vitest run","build":"npm run build:wasm && npm run build:ts","clean":"rm -rf dist wasm","build:ts":"tsup","lint:fix":"eslint src --ext .ts,.tsx --fix","typecheck":"tsc --noEmit","build:wasm":"wasm-pack build ../cognitum-gate-kernel --target web --out-dir ../packages/cognitum-gate-wasm/wasm","test:watch":"vitest","build:types":"tsc --emitDeclarationOnly","test:browser":"vitest run --environment jsdom","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build && npm run test"},"_npmUser":{"name":"aigentic","email":"engineering@aigentic.net"},"repository":{"url":"git+https://github.com/ruvnet/ruvector.git","type":"git","directory":"packages/cognitum-gate-wasm"},"_npmVersion":"11.12.0","description":"Browser and Node.js coherence gate for AI agent safety - real-time permit/defer/deny decisions in microseconds","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","dependencies":{"@noble/hashes":"^1.3.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","jsdom":"^23.0.0","eslint":"^8.55.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.10.0","@vitest/coverage-v8":"^1.0.0","@typescript-eslint/parser":"^6.13.0","@typescript-eslint/eslint-plugin":"^6.13.0"},"peerDependencies":{"claude-flow":">=2.0.0"},"peerDependenciesMeta":{"claude-flow":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/cognitum-gate-kernel_0.1.0_1779091116779_0.2746129337093379","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aigentic/cognitum-gate-kernel","version":"0.1.1","keywords":["ai","agent","safety","coherence","wasm","webassembly","permission","audit","claude","llm"],"author":{"name":"RuVector","email":"hello@ruv.io"},"license":"(MIT OR Apache-2.0)","_id":"@aigentic/cognitum-gate-kernel@0.1.1","maintainers":[{"name":"aigentic","email":"engineering@aigentic.net"}],"homepage":"https://github.com/ruvnet/ruvector/tree/main/packages/cognitum-gate-wasm","bugs":{"url":"https://github.com/ruvnet/ruvector/issues"},"dist":{"shasum":"7802ba35803e875fb8e2cbd419a38dcb20cdf5e3","tarball":"https://registry.npmjs.org/@aigentic/cognitum-gate-kernel/-/cognitum-gate-kernel-0.1.1.tgz","fileCount":2,"integrity":"sha512-SqqayTm4R9bOCh5HCg0BJbd8lWDTmUVEL2QrYCSW8QBVX7XK65YjUA9fkikslmyQUJHEY/Yh8VtijJaOEvOnhw==","signatures":[{"sig":"MEUCIQDg6flNN/beEFE9OwcXhXbXRHgKzdA2bbDj6OyTjarJagIgRZ1mQiPECxH7MFs28J4lhUODKvJxgjEkCD9bWEkQan0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35370},"main":"./dist/cjs/index.js","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=16.0.0"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"},"./sw":{"types":"./dist/types/sw.d.ts","import":"./dist/esm/sw.js"},"./node":{"types":"./dist/types/node.d.ts","import":"./dist/esm/node.js","require":"./dist/cjs/node.js"},"./wasm":{"types":"./dist/types/wasm.d.ts","import":"./dist/esm/wasm.js","require":"./dist/cjs/wasm.js"},"./experimental":{"types":"./dist/types/experimental.d.ts","import":"./dist/esm/experimental.js"}},"gitHead":"06426cbc6e70f09762e996a98517b0b1fd1c7c4e","scripts":{"lint":"eslint src --ext .ts,.tsx","test":"vitest run","build":"npm run build:wasm && npm run build:ts","clean":"rm -rf dist wasm","build:ts":"tsup","lint:fix":"eslint src --ext .ts,.tsx --fix","typecheck":"tsc --noEmit","build:wasm":"wasm-pack build ../cognitum-gate-kernel --target web --out-dir ../packages/cognitum-gate-wasm/wasm","test:watch":"vitest","build:types":"tsc --emitDeclarationOnly","test:browser":"vitest run --environment jsdom","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build && npm run test"},"_npmUser":{"name":"aigentic","email":"engineering@aigentic.net"},"repository":{"url":"git+https://github.com/ruvnet/ruvector.git","type":"git","directory":"packages/cognitum-gate-wasm"},"_npmVersion":"11.12.0","description":"Browser and Node.js coherence gate for AI agent safety - real-time permit/defer/deny decisions in microseconds","directories":{},"sideEffects":false,"_nodeVersion":"22.22.1","dependencies":{"@noble/hashes":"^1.3.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","jsdom":"^23.0.0","eslint":"^8.55.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.10.0","@vitest/coverage-v8":"^1.0.0","@typescript-eslint/parser":"^6.13.0","@typescript-eslint/eslint-plugin":"^6.13.0"},"peerDependencies":{"claude-flow":">=2.0.0"},"peerDependenciesMeta":{"claude-flow":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/cognitum-gate-kernel_0.1.1_1779092815527_0.004641726248400868","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-05-18T07:58:36.664Z","modified":"2026-09-13T15:30:27.954Z","0.1.0":"2026-05-18T07:58:36.933Z","0.1.1":"2026-05-18T08:26:55.661Z"},"bugs":{"url":"https://github.com/ruvnet/ruvector/issues"},"author":{"name":"RuVector","email":"hello@ruv.io"},"license":"(MIT OR Apache-2.0)","homepage":"https://github.com/ruvnet/ruvector/tree/main/packages/cognitum-gate-wasm","keywords":["ai","agent","safety","coherence","wasm","webassembly","permission","audit","claude","llm"],"repository":{"url":"git+https://github.com/ruvnet/ruvector.git","type":"git","directory":"packages/cognitum-gate-wasm"},"description":"Browser and Node.js coherence gate for AI agent safety - real-time permit/defer/deny decisions in microseconds","maintainers":[{"email":"engineering@aigentic.net","name":"aiggy"}],"readme":"# @cognitum/gate\n\n[](https://www.npmjs.com/package/@cognitum/gate)\n[](https://bundlephobia.com/package/@cognitum/gate)\n[](https://github.com/ruvnet/ruvector/blob/main/LICENSE)\n[](https://www.typescriptlang.org/)\n[](https://webassembly.org/)\n\n**Browser and Node.js coherence gate for AI agent safety**\n\n---\n\n## Introduction\n\nThe Cognitum Gate is a high-performance WASM-based coherence verification system designed to bring real-time safety guarantees to AI agent operations. Whether you're building autonomous agents in the browser or orchestrating complex workflows on Node.js, this package provides cryptographically-verifiable permit/defer/deny decisions in microseconds. Every action your agent considers passes through the gate, receiving an immediate verdict backed by witness receipts that create an immutable audit trail.\n\nUnlike traditional attention mechanisms that weight tokens by relevance, the coherence gate transforms attention into a permission system. Actions are not merely ranked by probability or popularity---they are explicitly permitted or denied based on configurable safety thresholds, context windows, and agent-specific policies. This paradigm shift means your agents operate within well-defined boundaries, preventing runaway behaviors while maintaining the responsiveness users expect from modern AI applications.\n\n**Attention becomes a permission system, not a popularity contest.**\n\nThe gate achieves sub-millisecond latency through a 256-tile WASM fabric that distributes verification across Web Workers (browser) or worker threads (Node.js). Each tile maintains its own coherence state, enabling horizontal scaling without sacrificing consistency. The result is a system that can handle thousands of permission checks per second while generating cryptographic receipts suitable for compliance, debugging, and post-hoc analysis.\n\n**Created by [ruv.io](https://ruv.io) and [RuVector](https://github.com/ruvnet/ruvector)**\n\n---\n\n## Quick Start\n\n```bash\nnpm install @cognitum/gate\n```\n\n```typescript\nimport { CognitumGate } from '@cognitum/gate';\n\n// Initialize the gate with default configuration\nconst gate = await CognitumGate.init({\n tileCount: 16,\n coherenceThreshold: 0.85,\n maxContextTokens: 8192,\n});\n\n// Request permission for an agent action\nconst result = await gate.permitAction({\n agentId: 'agent-001',\n action: 'file_write',\n target: '/app/config.json',\n context: { reason: 'Update user preferences' },\n});\n\nif (result.verdict === 'permit') {\n console.log('Action permitted:', result.token);\n // Proceed with the action...\n\n // Get the witness receipt for audit trail\n const receipt = await gate.getReceipt(result.token);\n console.log('Receipt hash:', receipt.witnessHash);\n} else if (result.verdict === 'defer') {\n console.log('Action deferred, retry after:', result.deferMs, 'ms');\n} else {\n console.log('Action denied:', result.reason);\n}\n```\n\n---\n\n\n
Architecture
\n\n### How WASM Tiles Work in Browser/Node\n\nThe coherence gate operates through a distributed tile architecture where each tile is an independent WASM module responsible for a subset of coherence verification. This design enables:\n\n- **Parallel Processing**: Multiple tiles process requests concurrently\n- **Fault Isolation**: A failing tile doesn't crash the entire system\n- **Horizontal Scaling**: Add more tiles as load increases\n\n```\n+---------------------------------------------------------------+\n| CognitumGate API |\n+---------------------------------------------------------------+\n| Tile Coordinator |\n+-------+-------+-------+-------+-------+-------+-------+-------+\n|Tile 0 |Tile 1 |Tile 2 |Tile 3 | ... |Tile N |Arbiter|Witness|\n| WASM | WASM | WASM | WASM | | WASM | Tile | Store |\n+-------+-------+-------+-------+-------+-------+-------+-------+\n | | | | | |\n +-------+-------+-------+---------------+-------+\n SharedArrayBuffer / MessageChannel\n```\n\n### Web Worker Distribution (Browser)\n\nIn browser environments, each tile runs in its own Web Worker for true parallelism:\n\n```typescript\n// The gate automatically spawns workers\nconst gate = await CognitumGate.init({\n tileCount: navigator.hardwareConcurrency || 4,\n workerUrl: '/cognitum-worker.js', // Optional custom worker\n});\n\n// Check active workers\nconsole.log('Active tiles:', gate.getStats().activeTiles);\n```\n\nWorkers communicate through `SharedArrayBuffer` when available (requires cross-origin isolation) or fall back to `MessageChannel` for broader compatibility.\n\n### Worker Threads (Node.js)\n\nOn Node.js, the gate uses `worker_threads` for true parallelism:\n\n```typescript\nimport { CognitumGate } from '@cognitum/gate/node';\nimport os from 'os';\n\nconst gate = await CognitumGate.init({\n tileCount: os.cpus().length,\n threadPoolSize: 4,\n});\n```\n\n### SharedArrayBuffer for Tile Communication\n\nWhen cross-origin isolation is enabled, tiles share memory through `SharedArrayBuffer`:\n\n```typescript\n// Check if SharedArrayBuffer is available\nif (gate.supportsSharedMemory) {\n console.log('Using SharedArrayBuffer for zero-copy communication');\n} else {\n console.log('Falling back to structured clone');\n}\n```\n\nRequired headers for cross-origin isolation:\n\n```\nCross-Origin-Opener-Policy: same-origin\nCross-Origin-Embedder-Policy: require-corp\n```\n\n### Memory Layout Per Tile\n\nEach tile maintains approximately 41KB of state:\n\n```typescript\ninterface TileState {\n graphShard: Uint8Array; // ~32KB - compact neighborhood graph\n featureWindow: Float32Array; // ~8KB - rolling normality scores\n coherence: number; // f32 - local coherence score\n boundaryEdges: Uint32Array; // 8 edges - local boundary candidates\n eAccumulator: number; // f64 - local E-value accumulator\n tick: bigint; // u64 - tick counter\n}\n```\n\n\n\n---\n\n\n
Technical Deep Dive
\n\n### WASM Module Loading\n\nThe gate loads WASM modules asynchronously with streaming compilation when supported:\n\n```typescript\nimport { loadWasmModule } from '@cognitum/gate/wasm';\n\n// Manual WASM loading (usually handled automatically)\nconst wasmModule = await loadWasmModule({\n url: '/cognitum-gate.wasm',\n streaming: true, // Use WebAssembly.instantiateStreaming\n cache: 'persistent', // Cache in IndexedDB\n});\n```\n\nThe WASM binary is approximately 180KB gzipped and includes:\n- Coherence scoring algorithms\n- Cryptographic witness generation (BLAKE3/SHA-256)\n- Tile state management\n- Receipt serialization\n\n### Memory Management (LinearMemory)\n\nEach WASM tile operates with its own `WebAssembly.Memory` instance:\n\n```typescript\ninterface TileMemoryConfig {\n initial: number; // Initial pages (64KB each)\n maximum: number; // Maximum pages\n shared: boolean; // Use SharedArrayBuffer\n}\n\nconst gate = await CognitumGate.init({\n tileMemory: {\n initial: 16, // 1MB initial\n maximum: 256, // 16MB maximum\n shared: true, // Enable shared memory\n },\n});\n\n// Monitor memory usage\nconst stats = gate.getStats();\nconsole.log('Memory per tile:', stats.memoryPerTile);\n```\n\nMemory lifecycle:\n1. **Allocation**: Memory allocated on tile creation\n2. **Growth**: Automatic growth up to `maximum` pages\n3. **Compaction**: Periodic compaction during idle periods\n4. **Release**: Memory freed when gate is destroyed\n\n### TypeScript Type Definitions\n\nFull type coverage for all APIs:\n\n```typescript\n// Core types\ntype Verdict = 'permit' | 'defer' | 'deny';\n\ninterface PermitRequest {\n agentId: string;\n action: string;\n target?: string;\n context?: Record;\n priority?: 'low' | 'normal' | 'high' | 'critical';\n timeoutMs?: number;\n}\n\ninterface PermitResult {\n verdict: Verdict;\n token: string; // Unique permit token\n coherenceScore: number; // 0.0 - 1.0\n tileId: number; // Processing tile\n latencyUs: number; // Processing time in microseconds\n reason?: string; // Human-readable reason for defer/deny\n deferMs?: number; // Suggested retry delay\n}\n\ninterface WitnessReceipt {\n token: string;\n witnessHash: string; // BLAKE3/SHA-256 hash\n timestamp: number; // Unix timestamp (ms)\n agentId: string;\n action: string;\n verdict: Verdict;\n coherenceScore: number;\n parentHash?: string; // Chain to previous receipt\n signature?: Uint8Array; // Optional Ed25519 signature\n outcome?: ActionOutcome; // Recorded outcome\n}\n```\n\n### Performance Characteristics\n\n| Operation | Latency (p50) | Latency (p99) | Throughput |\n|-----------|---------------|---------------|------------|\n| `permitAction` | 45 us | 120 us | 22,000 req/s |\n| `getReceipt` | 12 us | 35 us | 80,000 req/s |\n| `batchPermit` (100) | 2.1 ms | 4.5 ms | 47,000 req/s |\n| Tile cold start | 8 ms | 15 ms | N/A |\n\nBenchmarked on:\n- Browser: Chrome 120, M2 MacBook Pro\n- Node.js: v20.10, 8-core AMD EPYC\n\n\n\n---\n\n\n