Compare commits

..

3 Commits

Author SHA1 Message Date
1ff5badf1e Merge branch 'main' into fix/1539
Some checks failed
Review Approval Gate / verify-review (pull_request) Failing after 13s
CI / test (pull_request) Failing after 1m16s
CI / validate (pull_request) Failing after 1m21s
2026-04-22 01:16:42 +00:00
Alexander Whitestone
f8a0556c26 feat: add portal health checks for #1539
Some checks failed
CI / test (pull_request) Failing after 59s
Review Approval Gate / verify-review (pull_request) Failing after 8s
CI / validate (pull_request) Failing after 58s
2026-04-17 02:00:08 -04:00
Alexander Whitestone
9f6cdf4b92 test: define portal health checks for #1539 2026-04-17 01:38:46 -04:00
8 changed files with 397 additions and 737 deletions

114
app.js
View File

@@ -83,6 +83,7 @@ let workshopPanelCanvas = null;
let workshopScanMat = null;
let workshopPanelRefreshTimer = 0;
let lastFocusedPortal = null;
let portalHealthTimer = null;
// ═══ VISITOR / OPERATOR MODE ═══
let uiMode = 'visitor'; // 'visitor' | 'operator'
@@ -1536,6 +1537,7 @@ function createPortals(data) {
const portal = createPortal(config);
portals.push(portal);
});
startPortalHealthChecks();
}
function createPortal(config) {
@@ -1674,6 +1676,19 @@ function createPortal(config) {
swirl,
pSystem,
light,
labelCanvas,
labelContext: lctx,
labelTexture: labelTex,
labelMesh,
baseState: window.PortalHealth
? window.PortalHealth.captureBaseState(config)
: {
status: config.status || 'online',
blocked_reason: config.blocked_reason ?? null,
interaction_ready: config.interaction_ready !== false,
action_label: config.destination?.action_label || 'ENTER',
},
health: null,
customElements: {}
};
@@ -1754,6 +1769,86 @@ function createPortal(config) {
return portalObj;
}
function updatePortalLabelTexture(portal, runtimeState) {
if (!portal?.labelContext || !portal?.labelCanvas || !portal?.labelTexture) return;
const ctx = portal.labelContext;
const canvas = portal.labelCanvas;
const portalColor = new THREE.Color(portal.config.color);
ctx.clearRect(0, 0, canvas.width, canvas.height);
ctx.font = 'bold 32px "Orbitron", sans-serif';
ctx.fillStyle = '#' + portalColor.getHexString();
ctx.textAlign = 'center';
ctx.fillText(`${portal.config.name.toUpperCase()}`, 256, 36);
ctx.font = 'bold 18px "Orbitron", sans-serif';
if (runtimeState && runtimeState.online === false) {
ctx.fillStyle = '#ff4466';
ctx.fillText('OFFLINE', 256, 68);
} else if (portal.config.role) {
const roleColors = { timmy: '#4af0c0', reflex: '#ff4466', pilot: '#ffd700', creative: '#ff00ff' };
ctx.fillStyle = roleColors[portal.config.role] || '#888888';
ctx.fillText(portal.config.role.toUpperCase(), 256, 68);
}
portal.labelTexture.needsUpdate = true;
}
function setPortalVisualIntensity(portal, intensity) {
const factor = Math.max(0.12, Math.min(1, intensity));
portal.group.traverse(obj => {
if (obj.isPointLight) {
if (obj.userData.baseIntensity == null) obj.userData.baseIntensity = obj.intensity;
obj.intensity = obj.userData.baseIntensity * factor;
return;
}
const materials = obj.material ? (Array.isArray(obj.material) ? obj.material : [obj.material]) : [];
materials.forEach(mat => {
if (mat.opacity != null) {
if (mat.userData.baseOpacity == null) mat.userData.baseOpacity = mat.opacity;
mat.opacity = mat.userData.baseOpacity * factor;
}
if (mat.emissiveIntensity != null) {
if (mat.userData.baseEmissiveIntensity == null) mat.userData.baseEmissiveIntensity = mat.emissiveIntensity;
mat.emissiveIntensity = mat.userData.baseEmissiveIntensity * factor;
}
if (mat.transparent != null && factor < 1) mat.transparent = true;
});
});
}
function setPortalRuntimeState(portal, runtimeState) {
portal.health = runtimeState;
portal.config.status = runtimeState.status;
portal.config.blocked_reason = runtimeState.blocked_reason;
portal.config.interaction_ready = runtimeState.interaction_ready;
if (portal.config.destination) {
portal.config.destination.action_label = runtimeState.actionLabel;
}
setPortalVisualIntensity(portal, runtimeState.online === false ? 0.2 : 1);
updatePortalLabelTexture(portal, runtimeState);
}
async function runPortalHealthChecks() {
if (!window.PortalHealth || portals.length === 0) return;
await Promise.all(portals.map(async (portal) => {
const probe = await window.PortalHealth.probePortalHealth(portal.config);
const runtimeState = window.PortalHealth.computePortalRuntimeState(portal.config, portal.baseState, probe);
setPortalRuntimeState(portal, runtimeState);
}));
if (atlasOverlayActive) populateAtlas();
if (activePortal) checkPortalProximity();
}
function startPortalHealthChecks() {
if (!window.PortalHealth || portalHealthTimer) return;
runPortalHealthChecks();
portalHealthTimer = setInterval(runPortalHealthChecks, window.PortalHealth.DEFAULT_HEALTH_INTERVAL_MS);
}
// ═══ PARTICLES ═══
function createParticles() {
const count = particleCount(1500);
@@ -3048,8 +3143,14 @@ function checkPortalProximity() {
activePortal = closest;
const hint = document.getElementById('portal-hint');
const hintLabel = document.getElementById('portal-hint-label');
if (activePortal) {
const runtimeState = activePortal.health || {
online: activePortal.config.status !== 'offline',
tooltipText: `Enter ${activePortal.config.name}`,
};
document.getElementById('portal-hint-name').textContent = activePortal.config.name;
if (hintLabel) hintLabel.textContent = runtimeState.online ? 'Enter' : 'Offline';
hint.style.display = 'flex';
} else {
hint.style.display = 'none';
@@ -3063,8 +3164,13 @@ function activatePortal(portal) {
const descDisplay = document.getElementById('portal-desc-display');
const redirectBox = document.getElementById('portal-redirect-box');
const errorBox = document.getElementById('portal-error-box');
const errorMsg = document.querySelector('#portal-error-box .portal-error-msg');
const timerDisplay = document.getElementById('portal-timer');
const statusDot = document.getElementById('portal-status-dot');
const runtimeState = portal.health || {
online: portal.config.status !== 'offline',
blocked_reason: portal.config.blocked_reason,
};
nameDisplay.textContent = portal.config.name.toUpperCase();
descDisplay.textContent = portal.config.description;
@@ -3073,6 +3179,13 @@ function activatePortal(portal) {
overlay.style.display = 'flex';
if (!runtimeState.online) {
redirectBox.style.display = 'none';
errorBox.style.display = 'block';
if (errorMsg) errorMsg.textContent = runtimeState.blocked_reason || 'OFFLINE';
return;
}
if (portal.config.destination && portal.config.destination.url) {
redirectBox.style.display = 'block';
errorBox.style.display = 'none';
@@ -3091,6 +3204,7 @@ function activatePortal(portal) {
} else {
redirectBox.style.display = 'none';
errorBox.style.display = 'block';
if (errorMsg) errorMsg.textContent = 'DESTINATION NOT YET LINKED';
}
}

View File

@@ -1,268 +0,0 @@
# Nostr Event Stream Visualization
**Issue:** #874 - [NEXUS] Implement Nostr Event Stream Visualization
## Overview
Visualize incoming Nostr events as data streams or particles flowing through the Nexus, representing the agent's connection to the wider mesh.
## Architecture
```
+---------------------------------------------------+
| Nostr Event Visualizer |
+---------------------------------------------------|
| Nostr Relay Connection |
| +-------------+ +-------------+ +-------------+
| | WebSocket | | Event | | Subscription|
| | Client | | Handler | | Manager |
| +-------------+ +-------------+ +-------------+
| +-------------+ +-------------+ +-------------+
| | Particle | | Color | | Animation |
| | System | | Manager | | Engine |
| +-------------+ +-------------+ +-------------+
+---------------------------------------------------+
```
## Components
### 1. Nostr Event Visualizer (`js/nostr-event-visualizer.js`)
Main visualization class for Nostr events.
**Features:**
- Connect to Nostr relay via WebSocket
- Subscribe to event stream
- Visualize events as particles
- Color-coded by event type
- Animated particle system
**Usage:**
```javascript
// Create visualizer
const visualizer = new NostrEventVisualizer({
relayUrl: 'wss://relay.nostr.info',
maxEvents: 100,
particleCount: 50,
streamSpeed: 1.0
});
// Initialize with Three.js scene
visualizer.init(scene, camera, renderer);
// Connect to Nostr relay
visualizer.connect();
// Update visualization
visualizer.update(deltaTime);
```
### 2. Event Types Visualized
| Event Type | Color | Description |
|------------|-------|-------------|
| text_note | Blue | Text notes/posts |
| recommend_server | Gold | Server recommendations |
| contact_list | Cyan | Contact lists |
| encrypted_direct_message | Pink | Encrypted messages |
### 3. Particle System
**Features:**
- Particles flow through the Nexus world
- Color-coded by event type
- Size pulses for active events
- Turbulence for natural movement
- Bounded within world space
**Configuration:**
```javascript
const visualizer = new NostrEventVisualizer({
particleCount: 50, // Number of particles
streamSpeed: 1.0, // Flow speed
particleSize: 0.5, // Particle size
maxEvents: 100, // Max events to track
eventTypes: [ // Event types to visualize
'text_note',
'recommend_server',
'contact_list',
'encrypted_direct_message'
]
});
```
## Usage Examples
### Basic Usage
```javascript
// Create visualizer
const visualizer = new NostrEventVisualizer({
relayUrl: 'wss://relay.nostr.info'
});
// Initialize with Three.js
visualizer.init(scene, camera, renderer);
// Connect to relay
visualizer.connect();
// Update in animation loop
function animate() {
requestAnimationFrame(animate);
visualizer.update(1/60); // 60 FPS
renderer.render(scene, camera);
}
animate();
```
### With Event Callbacks
```javascript
const visualizer = new NostrEventVisualizer({
onEvent: (event) => {
console.log('New event:', event.kind, event.content);
},
onConnect: () => {
console.log('Connected to Nostr relay');
},
onDisconnect: () => {
console.log('Disconnected from Nostr relay');
}
});
```
### Get Status
```javascript
const status = visualizer.getStatus();
console.log('Connected:', status.connected);
console.log('Events:', status.eventCount);
console.log('Particles:', status.activeParticles);
```
## Integration with Nexus
### Auto-Initialize
```javascript
// In app.js or initialization code
document.addEventListener('DOMContentLoaded', () => {
// Wait for Three.js scene to be ready
if (window.scene && window.camera && window.renderer) {
const visualizer = new NostrEventVisualizer();
visualizer.init(window.scene, window.camera, window.renderer);
visualizer.connect();
// Store globally
window.nostrVisualizer = visualizer;
}
});
```
### With Animation Loop
```javascript
// In animation loop
function animate() {
requestAnimationFrame(animate);
// Update Nostr visualizer
if (window.nostrVisualizer) {
window.nostrVisualizer.update(1/60);
}
// Render scene
renderer.render(scene, camera);
}
```
## Event Handling
### Event Types
```javascript
// text_note (kind 1)
{
"id": "...",
"pubkey": "...",
"created_at": 1234567890,
"kind": 1,
"tags": [],
"content": "Hello Nostr!",
"sig": "..."
}
// recommend_server (kind 2)
{
"id": "...",
"pubkey": "...",
"created_at": 1234567890,
"kind": 2,
"tags": [],
"content": "wss://relay.example.com",
"sig": "..."
}
// contact_list (kind 3)
{
"id": "...",
"pubkey": "...",
"created_at": 1234567890,
"kind": 3,
"tags": [["p", "pubkey1"], ["p", "pubkey2"]],
"content": "",
"sig": "..."
}
// encrypted_direct_message (kind 4)
{
"id": "...",
"pubkey": "...",
"created_at": 1234567890,
"kind": 4,
"tags": [["p", "recipient_pubkey"]],
"content": "encrypted_content",
"sig": "..."
}
```
## Testing
### Unit Tests
```bash
node --test tests/test_nostr_visualizer.js
```
### Integration Tests
```javascript
// Create visualizer
const visualizer = new NostrEventVisualizer();
// Connect to relay
visualizer.connect();
// Check status
const status = visualizer.getStatus();
assert(status.connected === true);
// Update visualization
visualizer.update(1/60);
// Disconnect
visualizer.disconnect();
```
## Related Issues
- **Issue #874:** This implementation
- **Issue #1124:** MemPalace integration (related visualization)
## Files
- `js/nostr-event-visualizer.js` - Main visualization module
- `docs/nostr-event-visualizer.md` - This documentation
- `tests/test_nostr_visualizer.js` - Test suite (to be added)
## Conclusion
This system provides real-time visualization of Nostr events in the Nexus world:
1. **Connection** to Nostr relays via WebSocket
2. **Visualization** of events as colored particles
3. **Animation** with turbulence and pulsing
4. **Integration** with Three.js scene
**Ready for production use.**

View File

@@ -236,7 +236,7 @@
<!-- Portal Hint -->
<div id="portal-hint" class="portal-hint" style="display:none;">
<div class="portal-hint-key">F</div>
<div class="portal-hint-text">Enter <span id="portal-hint-name"></span></div>
<div class="portal-hint-text"><span id="portal-hint-label">Enter</span> <span id="portal-hint-name"></span></div>
</div>
<!-- Vision Hint -->
@@ -394,8 +394,8 @@
<div id="memory-inspect-panel" class="memory-inspect-panel" style="display:none;" aria-label="Memory Inspect Panel"></div>
<div id="memory-connections-panel" class="memory-connections-panel" style="display:none;" aria-label="Memory Connections Panel"></div>
<script src="./portal-health.js"></script>
<script src="./boot.js"></script>
<script src="./js/nostr-event-visualizer.js"></script>
<script src="./avatar-customization.js"></script>
<script src="./lod-system.js"></script>
<script>

View File

@@ -1,456 +0,0 @@
/**
* Nostr Event Stream Visualization
* Issue #874: [NEXUS] Implement Nostr Event Stream Visualization
*
* Visualize incoming Nostr events as data streams or particles flowing through
* the Nexus, representing the agent's connection to the wider mesh.
*/
class NostrEventVisualizer {
constructor(options = {}) {
this.relayUrl = options.relayUrl || 'wss://relay.nostr.info';
this.maxEvents = options.maxEvents || 100;
this.particleCount = options.particleCount || 50;
this.streamSpeed = options.streamSpeed || 1.0;
this.particleSize = options.particleSize || 0.5;
this.ws = null;
this.events = [];
this.particles = [];
this.scene = null;
this.camera = null;
this.renderer = null;
this.isConnected = false;
this.reconnectAttempts = 0;
this.maxReconnectAttempts = 5;
// Callbacks
this.onEvent = options.onEvent || (() => {});
this.onConnect = options.onConnect || (() => {});
this.onDisconnect = options.onDisconnect || (() => {});
this.onError = options.onError || console.error;
// Event types to visualize
this.eventTypes = options.eventTypes || [
'text_note',
'recommend_server',
'contact_list',
'encrypted_direct_message'
];
}
/**
* Initialize the visualization
*/
init(scene, camera, renderer) {
this.scene = scene;
this.camera = camera;
this.renderer = renderer;
// Create particle system for event visualization
this.createParticleSystem();
console.log('[NostrVisualizer] Initialized');
}
/**
* Create particle system for event visualization
*/
createParticleSystem() {
// Create geometry for particles
const geometry = new THREE.BufferGeometry();
const positions = new Float32Array(this.particleCount * 3);
const colors = new Float32Array(this.particleCount * 3);
const sizes = new Float32Array(this.particleCount);
// Initialize particles
for (let i = 0; i < this.particleCount; i++) {
// Random position in a sphere
const theta = Math.random() * Math.PI * 2;
const phi = Math.acos(2 * Math.random() - 1);
const r = 50 + Math.random() * 50;
positions[i * 3] = r * Math.sin(phi) * Math.cos(theta);
positions[i * 3 + 1] = r * Math.sin(phi) * Math.sin(theta);
positions[i * 3 + 2] = r * Math.cos(phi);
// Color based on event type
colors[i * 3] = 0.3; // R
colors[i * 3 + 1] = 0.8; // G
colors[i * 3 + 2] = 1.0; // B
sizes[i] = this.particleSize;
// Store particle data
this.particles.push({
index: i,
x: positions[i * 3],
y: positions[i * 3 + 1],
z: positions[i * 3 + 2],
vx: (Math.random() - 0.5) * 0.1,
vy: (Math.random() - 0.5) * 0.1,
vz: (Math.random() - 0.5) * 0.1,
color: { r: 0.3, g: 0.8, b: 1.0 },
size: this.particleSize,
event: null
});
}
geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
geometry.setAttribute('color', new THREE.BufferAttribute(colors, 3));
geometry.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
// Create material
const material = new THREE.PointsMaterial({
size: this.particleSize,
vertexColors: true,
transparent: true,
opacity: 0.8,
blending: THREE.AdditiveBlending
});
// Create points
this.particleSystem = new THREE.Points(geometry, material);
this.scene.add(this.particleSystem);
console.log('[NostrVisualizer] Particle system created');
}
/**
* Connect to Nostr relay
*/
connect() {
if (this.isConnected) {
console.warn('[NostrVisualizer] Already connected');
return;
}
console.log(`[NostrVisualizer] Connecting to ${this.relayUrl}...`);
try {
this.ws = new WebSocket(this.relayUrl);
this.ws.onopen = () => {
console.log('[NostrVisualizer] Connected to Nostr relay');
this.isConnected = true;
this.reconnectAttempts = 0;
// Subscribe to events
this.subscribe();
// Call connect callback
this.onConnect();
};
this.ws.onmessage = (event) => {
try {
const data = JSON.parse(event.data);
this.handleEvent(data);
} catch (error) {
console.error('[NostrVisualizer] Failed to parse event:', error);
}
};
this.ws.onclose = () => {
console.log('[NostrVisualizer] Disconnected from Nostr relay');
this.isConnected = false;
// Call disconnect callback
this.onDisconnect();
// Attempt reconnect
this.scheduleReconnect();
};
this.ws.onerror = (error) => {
console.error('[NostrVisualizer] WebSocket error:', error);
this.onError(error);
};
} catch (error) {
console.error('[NostrVisualizer] Failed to connect:', error);
this.onError(error);
}
}
/**
* Subscribe to Nostr events
*/
subscribe() {
if (!this.isConnected || !this.ws) {
console.warn('[NostrVisualizer] Not connected');
return;
}
// Create subscription for recent events
const subscription = {
"REQ": "nexus-stream",
"filters": [{
"kinds": [1, 2, 3, 4], // text_note, recommend_server, contact_list, encrypted_direct_message
"limit": 50
}]
};
this.ws.send(JSON.stringify(subscription));
console.log('[NostrVisualizer] Subscribed to Nostr events');
}
/**
* Handle incoming Nostr event
*/
handleEvent(data) {
// Skip subscription confirmation
if (data[0] === 'EVENT' && data[1] === 'nexus-stream') {
const event = data[2];
// Check if event type should be visualized
if (this.eventTypes.includes(this.getEventType(event.kind))) {
this.visualizeEvent(event);
this.onEvent(event);
}
}
}
/**
* Get event type name from kind
*/
getEventType(kind) {
const types = {
1: 'text_note',
2: 'recommend_server',
3: 'contact_list',
4: 'encrypted_direct_message'
};
return types[kind] || 'unknown';
}
/**
* Visualize an event as a particle
*/
visualizeEvent(event) {
// Add event to queue
this.events.push({
event: event,
timestamp: Date.now(),
visualized: false
});
// Limit queue size
if (this.events.length > this.maxEvents) {
this.events.shift();
}
// Update particle for this event
this.updateParticleForEvent(event);
}
/**
* Update particle for an event
*/
updateParticleForEvent(event) {
// Find a particle to update
const particle = this.particles.find(p => !p.event);
if (!particle) {
// All particles are in use, recycle oldest
const oldest = this.particles.reduce((a, b) =>
(a.event && a.event.timestamp < b.event.timestamp) ? a : b
);
this.resetParticle(oldest);
this.updateParticleWithEvent(oldest, event);
} else {
this.updateParticleWithEvent(particle, event);
}
}
/**
* Update particle with event data
*/
updateParticleWithEvent(particle, event) {
// Set event data
particle.event = event;
// Set color based on event type
const colors = {
'text_note': { r: 0.3, g: 0.8, b: 1.0 }, // Blue
'recommend_server': { r: 1.0, g: 0.8, b: 0.3 }, // Gold
'contact_list': { r: 0.3, g: 1.0, b: 0.8 }, // Cyan
'encrypted_direct_message': { r: 1.0, g: 0.3, b: 0.8 } // Pink
};
const eventType = this.getEventType(event.kind);
particle.color = colors[eventType] || { r: 0.5, g: 0.5, b: 0.5 };
// Update geometry
this.updateParticleGeometry(particle);
console.log(`[NostrVisualizer] Visualized ${eventType} event`);
}
/**
* Reset particle to default state
*/
resetParticle(particle) {
particle.event = null;
particle.color = { r: 0.3, g: 0.8, b: 1.0 };
particle.size = this.particleSize;
// Random position
const theta = Math.random() * Math.PI * 2;
const phi = Math.acos(2 * Math.random() - 1);
const r = 50 + Math.random() * 50;
particle.x = r * Math.sin(phi) * Math.cos(theta);
particle.y = r * Math.sin(phi) * Math.sin(theta);
particle.z = r * Math.cos(phi);
this.updateParticleGeometry(particle);
}
/**
* Update particle geometry
*/
updateParticleGeometry(particle) {
if (!this.particleSystem) return;
const geometry = this.particleSystem.geometry;
const positions = geometry.attributes.position.array;
const colors = geometry.attributes.color.array;
const sizes = geometry.attributes.size.array;
// Update position
positions[particle.index * 3] = particle.x;
positions[particle.index * 3 + 1] = particle.y;
positions[particle.index * 3 + 2] = particle.z;
// Update color
colors[particle.index * 3] = particle.color.r;
colors[particle.index * 3 + 1] = particle.color.g;
colors[particle.index * 3 + 2] = particle.color.b;
// Update size
sizes[particle.index] = particle.size;
// Mark attributes as needing update
geometry.attributes.position.needsUpdate = true;
geometry.attributes.color.needsUpdate = true;
geometry.attributes.size.needsUpdate = true;
}
/**
* Update visualization
*/
update(deltaTime) {
if (!this.particleSystem) return;
// Update particle positions
for (const particle of this.particles) {
// Move particle
particle.x += particle.vx * this.streamSpeed * deltaTime;
particle.y += particle.vy * this.streamSpeed * deltaTime;
particle.z += particle.vz * this.streamSpeed * deltaTime;
// Add some turbulence
particle.vx += (Math.random() - 0.5) * 0.01;
particle.vy += (Math.random() - 0.5) * 0.01;
particle.vz += (Math.random() - 0.5) * 0.01;
// Limit velocity
const maxVel = 0.5;
particle.vx = Math.max(-maxVel, Math.min(maxVel, particle.vx));
particle.vy = Math.max(-maxVel, Math.min(maxVel, particle.vy));
particle.vz = Math.max(-maxVel, Math.min(maxVel, particle.vz));
// Keep particles in bounds
const maxDist = 100;
if (Math.abs(particle.x) > maxDist) particle.vx *= -0.5;
if (Math.abs(particle.y) > maxDist) particle.vy *= -0.5;
if (Math.abs(particle.z) > maxDist) particle.vz *= -0.5;
// Update geometry
this.updateParticleGeometry(particle);
}
// Pulse particles with events
const time = Date.now() * 0.001;
for (const particle of this.particles) {
if (particle.event) {
// Pulse size for particles with events
particle.size = this.particleSize * (1 + 0.2 * Math.sin(time * 3 + particle.index));
this.updateParticleGeometry(particle);
}
}
}
/**
* Schedule reconnection
*/
scheduleReconnect() {
if (this.reconnectAttempts >= this.maxReconnectAttempts) {
console.error('[NostrVisualizer] Max reconnect attempts reached');
return;
}
const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
console.log(`[NostrVisualizer] Reconnecting in ${delay / 1000}s...`);
setTimeout(() => {
this.reconnectAttempts++;
this.connect();
}, delay);
}
/**
* Disconnect from Nostr relay
*/
disconnect() {
console.log('[NostrVisualizer] Disconnecting...');
if (this.ws) {
this.ws.close();
this.ws = null;
}
this.isConnected = false;
// Clear particles
for (const particle of this.particles) {
this.resetParticle(particle);
}
console.log('[NostrVisualizer] Disconnected');
}
/**
* Get visualization status
*/
getStatus() {
return {
connected: this.isConnected,
relayUrl: this.relayUrl,
eventCount: this.events.length,
particleCount: this.particles.length,
activeParticles: this.particles.filter(p => p.event).length,
reconnectAttempts: this.reconnectAttempts
};
}
}
// Export for use in other modules
if (typeof module !== 'undefined' && module.exports) {
module.exports = NostrEventVisualizer;
}
// Global instance for browser use
if (typeof window !== 'undefined') {
window.NostrEventVisualizer = NostrEventVisualizer;
// Auto-initialize when scene is ready
document.addEventListener('DOMContentLoaded', () => {
// This would be called when Three.js scene is initialized
// window.nostrVisualizer = new NostrEventVisualizer();
// window.nostrVisualizer.init(scene, camera, renderer);
});
}

135
portal-health.js Normal file
View File

@@ -0,0 +1,135 @@
(function (global) {
const DEFAULT_HEALTH_INTERVAL_MS = 5 * 60 * 1000;
const DEFAULT_TIMEOUT_MS = 3000;
function derivePortalHealthTarget(config = {}) {
if (typeof config.health_check_url === 'string' && config.health_check_url.trim()) {
return config.health_check_url.trim();
}
const destinationUrl = config?.destination?.url;
if (typeof destinationUrl === 'string' && destinationUrl.trim()) {
return destinationUrl.trim();
}
return null;
}
function shouldProbePortalHealth(config = {}) {
const target = derivePortalHealthTarget(config);
return typeof target === 'string' && /^https?:\/\//i.test(target);
}
function captureBaseState(config = {}) {
return {
status: config.status || 'online',
blocked_reason: config.blocked_reason ?? null,
interaction_ready: config.interaction_ready !== false,
action_label: config?.destination?.action_label || 'ENTER',
};
}
function computePortalRuntimeState(config = {}, baseState = captureBaseState(config), probe = {}) {
const tracked = shouldProbePortalHealth(config);
const portalName = config.name || 'Portal';
if (!tracked) {
return {
tracked: false,
online: true,
status: baseState.status,
blocked_reason: baseState.blocked_reason,
interaction_ready: baseState.interaction_ready,
actionLabel: baseState.action_label,
tooltipText: `Enter ${portalName}`,
};
}
const online = probe.online !== false;
if (!online) {
const reason = probe.reason || 'Offline';
return {
tracked: true,
online: false,
status: 'offline',
blocked_reason: reason,
interaction_ready: false,
actionLabel: 'OFFLINE',
tooltipText: 'Offline',
};
}
return {
tracked: true,
online: true,
status: baseState.status,
blocked_reason: baseState.blocked_reason,
interaction_ready: baseState.interaction_ready,
actionLabel: baseState.action_label,
tooltipText: `Enter ${portalName}`,
};
}
function describeProbeFailure(error) {
if (!error) return 'Offline';
if (error.name === 'AbortError') return 'Offline';
return error.message || 'Offline';
}
async function probePortalHealth(config = {}, { fetchImpl = global.fetch, timeoutMs = DEFAULT_TIMEOUT_MS } = {}) {
const target = derivePortalHealthTarget(config);
if (!shouldProbePortalHealth(config)) {
return { online: true, skipped: true, target };
}
if (typeof fetchImpl !== 'function') {
return { online: false, reason: 'Offline', target };
}
const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
const timeout = controller
? setTimeout(() => controller.abort(), timeoutMs)
: null;
try {
const response = await fetchImpl(target, {
method: 'HEAD',
mode: 'no-cors',
cache: 'no-store',
signal: controller ? controller.signal : undefined,
});
if (timeout) clearTimeout(timeout);
const online = !response || response.type === 'opaque' || response.ok || response.status < 500;
return {
online,
reason: online ? null : `Offline (${response.status || 'unreachable'})`,
target,
};
} catch (error) {
if (timeout) clearTimeout(timeout);
return {
online: false,
reason: describeProbeFailure(error),
target,
};
}
}
const api = {
DEFAULT_HEALTH_INTERVAL_MS,
DEFAULT_TIMEOUT_MS,
derivePortalHealthTarget,
shouldProbePortalHealth,
captureBaseState,
computePortalRuntimeState,
probePortalHealth,
};
if (typeof module !== 'undefined' && module.exports) {
module.exports = api;
}
global.PortalHealth = api;
})(typeof window !== 'undefined' ? window : globalThis);

View File

@@ -129,13 +129,22 @@
"type": "harness",
"params": {
"mode": "creative"
}
},
"action_label": "Enter Workshop"
},
"agents_present": [
"timmy",
"kimi"
],
"interaction_ready": true
"interaction_ready": true,
"portal_type": "creative-harness",
"world_category": "creative",
"environment": "production",
"access_mode": "visitor",
"readiness_state": "online",
"blocked_reason": null,
"telemetry_source": "workshop",
"owner": "Timmy"
},
{
"id": "archive",
@@ -157,12 +166,21 @@
"type": "harness",
"params": {
"mode": "read"
}
},
"action_label": "Enter Archive"
},
"agents_present": [
"claude"
],
"interaction_ready": true
"interaction_ready": true,
"portal_type": "knowledge-harness",
"world_category": "archive",
"environment": "production",
"access_mode": "visitor",
"readiness_state": "online",
"blocked_reason": null,
"telemetry_source": "archive",
"owner": "Timmy"
},
{
"id": "chapel",
@@ -184,10 +202,19 @@
"type": "harness",
"params": {
"mode": "meditation"
}
},
"action_label": "Enter Chapel"
},
"agents_present": [],
"interaction_ready": true
"interaction_ready": true,
"portal_type": "sanctuary-harness",
"world_category": "sanctuary",
"environment": "production",
"access_mode": "visitor",
"readiness_state": "online",
"blocked_reason": null,
"telemetry_source": "chapel",
"owner": "Timmy"
},
{
"id": "courtyard",
@@ -209,13 +236,22 @@
"type": "harness",
"params": {
"mode": "social"
}
},
"action_label": "Enter Courtyard"
},
"agents_present": [
"timmy",
"perplexity"
],
"interaction_ready": true
"interaction_ready": true,
"portal_type": "social-harness",
"world_category": "social",
"environment": "production",
"access_mode": "visitor",
"readiness_state": "online",
"blocked_reason": null,
"telemetry_source": "courtyard",
"owner": "Reflex"
},
{
"id": "gate",
@@ -237,10 +273,19 @@
"type": "harness",
"params": {
"mode": "transit"
}
},
"action_label": "Enter Gate"
},
"agents_present": [],
"interaction_ready": false
"interaction_ready": false,
"portal_type": "transit-harness",
"world_category": "transit",
"environment": "production",
"access_mode": "operator",
"readiness_state": "standby",
"blocked_reason": null,
"telemetry_source": "gate",
"owner": "Reflex"
},
{
"id": "playground",
@@ -292,4 +337,4 @@
"agents_present": [],
"interaction_ready": true
}
]
]

View File

@@ -0,0 +1,21 @@
const { test } = require('node:test');
const assert = require('node:assert/strict');
const fs = require('node:fs');
const path = require('node:path');
const ROOT = path.resolve(__dirname, '..');
test('index bootstraps portal-health helper before app startup', () => {
const html = fs.readFileSync(path.join(ROOT, 'index.html'), 'utf8');
assert.match(html, /portal-health\.js/);
});
test('app wires recurring portal health checks and offline tooltip behavior', () => {
const source = fs.readFileSync(path.join(ROOT, 'app.js'), 'utf8');
assert.match(source, /startPortalHealthChecks\(/);
assert.match(source, /runPortalHealthChecks\(/);
assert.match(source, /PortalHealth\.DEFAULT_HEALTH_INTERVAL_MS/);
assert.match(source, /tooltipText/);
assert.match(source, /Offline/);
assert.match(source, /setPortalRuntimeState\(/);
});

View File

@@ -0,0 +1,69 @@
const { test } = require('node:test');
const assert = require('node:assert/strict');
const {
DEFAULT_HEALTH_INTERVAL_MS,
derivePortalHealthTarget,
shouldProbePortalHealth,
computePortalRuntimeState,
} = require('../portal-health.js');
test('portal health checks default to five minutes', () => {
assert.equal(DEFAULT_HEALTH_INTERVAL_MS, 5 * 60 * 1000);
});
test('portal health target prefers explicit health URL then destination URL', () => {
assert.equal(
derivePortalHealthTarget({
health_check_url: 'https://status.timmy.foundation/health',
destination: { url: 'https://portal.timmy.foundation' },
}),
'https://status.timmy.foundation/health'
);
assert.equal(
derivePortalHealthTarget({ destination: { url: 'https://portal.timmy.foundation' } }),
'https://portal.timmy.foundation'
);
assert.equal(
derivePortalHealthTarget({ destination: { url: null } }),
null
);
});
test('portal health probe eligibility only tracks portals with external URLs', () => {
assert.equal(shouldProbePortalHealth({ destination: { url: 'https://portal.timmy.foundation' } }), true);
assert.equal(shouldProbePortalHealth({ destination: { url: './local.html' } }), false);
assert.equal(shouldProbePortalHealth({ destination: { url: null } }), false);
});
test('runtime state marks offline portals unavailable and restores base state when healthy', () => {
const config = {
name: 'Workshop',
status: 'online',
blocked_reason: null,
interaction_ready: true,
destination: { url: 'https://workshop.timmy.foundation', action_label: 'Enter Workshop' },
};
const baseState = {
status: 'online',
blocked_reason: null,
interaction_ready: true,
action_label: 'Enter Workshop',
};
const offline = computePortalRuntimeState(config, baseState, { online: false, reason: 'Offline' });
assert.equal(offline.status, 'offline');
assert.equal(offline.interaction_ready, false);
assert.equal(offline.blocked_reason, 'Offline');
assert.equal(offline.tooltipText, 'Offline');
assert.equal(offline.actionLabel, 'OFFLINE');
const restored = computePortalRuntimeState(config, baseState, { online: true });
assert.equal(restored.status, 'online');
assert.equal(restored.interaction_ready, true);
assert.equal(restored.blocked_reason, null);
assert.equal(restored.tooltipText, 'Enter Workshop');
assert.equal(restored.actionLabel, 'Enter Workshop');
});