aimeat 1.2.0

package/dist/src/services/personal-routing.js

@@ -0,0 +1,77 @@
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { getStats } from './stats.js';
+import { getPromMetrics } from './prometheus.js';
+/**
+ * Route a message to an agent on a personal node.
+ * If the node is online, forward via WebSocket tunnel and await response.
+ * If offline, queue to mailbox and return 202-style result.
+ */
+export async function routeToPersonalNode(tunnelManager, mailboxService, storage, targetGaii, message, notificationService) {
+    // Find which personal node hosts this agent
+    const allNodes = await storage.listPersonalNodes();
+    const personalNode = allNodes.find(n => n.agentGaiis.includes(targetGaii));
+    if (!personalNode) {
+        return { delivered: false, reason: 'no_personal_node_found' };
+    }
+    // Try direct delivery via tunnel
+    if (tunnelManager.isOnline(personalNode.nodeId)) {
+        const tunnelMsg = {
+            type: 'request',
+            id: uuidv4(),
+            from: message.fromGaii,
+            to: targetGaii,
+            payload: message.payload,
+            timestamp: new Date().toISOString(),
+        };
+        const response = await tunnelManager.sendRequest(personalNode.nodeId, tunnelMsg);
+        if (response) {
+            // Send delivery receipt back to confirm end-to-end delivery
+            const receipt = {
+                type: 'delivery_receipt',
+                id: uuidv4(),
+                payload: JSON.stringify({
+                    original_id: tunnelMsg.id,
+                    status: 'delivered',
+                    delivered_at: new Date().toISOString(),
+                }),
+                timestamp: new Date().toISOString(),
+            };
+            // Send delivery receipt (fire-and-forget, don't block the response)
+            void tunnelManager.sendRequest(personalNode.nodeId, receipt, 5000);
+            return { delivered: true, response };
+        }
+        // Tunnel send failed (timeout or error) — fall through to mailbox
+        logger.warn('Tunnel delivery failed, falling back to mailbox', {
+            nodeId: personalNode.nodeId,
+            targetGaii,
+        });
+    }
+    // Queue to mailbox
+    const stats = getStats();
+    if (stats)
+        stats.incrementTunnel('mailbox_fallbacks_total');
+    const prom = getPromMetrics();
+    if (prom)
+        prom.tunnelMailboxFallbacksTotal.inc();
+    const retentionDays = message.type === 'board_notification' ? 3 : 7;
+    const sizeBytes = Buffer.byteLength(message.payload, 'utf-8');
+    const queued = await mailboxService.enqueue(personalNode.nodeId, {
+        personalNodeId: personalNode.nodeId,
+        type: message.type,
+        fromGaii: message.fromGaii,
+        toGaii: targetGaii,
+        payload: message.payload,
+        sizeBytes,
+        retentionDays,
+    });
+    if (queued) {
+        // Fire-and-forget push notification to node owner (REQ-007)
+        if (notificationService) {
+            void notificationService.notify(personalNode.nodeId, queued);
+        }
+        return { delivered: false, queued: true, reason: 'node_offline' };
+    }
+    return { delivered: false, queued: false, reason: 'mailbox_full' };
+}
+//# sourceMappingURL=personal-routing.js.map

package/dist/src/services/personal-routing.js.map

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

package/dist/src/services/personal-tunnel.d.ts

@@ -0,0 +1,39 @@
+import { WebSocket } from 'ws';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+import type { MailboxNotificationService } from './mailbox-notification.js';
+export interface TunnelMessage {
+    type: 'request' | 'response' | 'mailbox_sync' | 'mailbox_ack' | 'heartbeat' | 'heartbeat_ack' | 'disconnect' | 'welcome' | 'delivery_receipt';
+    id: string;
+    from?: string;
+    to?: string;
+    payload?: string;
+    timestamp: string;
+}
+export interface PersonalNodeConnection {
+    nodeId: string;
+    ws: WebSocket;
+    ownerName: string;
+    lastHeartbeat: number;
+    agentGaiis: string[];
+}
+export declare class TunnelManager {
+    private config;
+    private storage;
+    private connections;
+    private pendingResponses;
+    private heartbeatInterval;
+    private notificationService;
+    constructor(config: AimeatConfig, storage: Storage);
+    setNotificationService(service: MailboxNotificationService | null): void;
+    handleConnection(ws: WebSocket, nodeId: string, ownerName: string, agentGaiis: string[]): void;
+    private handleMessage;
+    private sendMailboxSummary;
+    sendRequest(nodeId: string, message: TunnelMessage, timeoutMs?: number): Promise<TunnelMessage | null>;
+    isOnline(nodeId: string): boolean;
+    getConnection(nodeId: string): PersonalNodeConnection | undefined;
+    getOnlineCount(): number;
+    startHeartbeatMonitor(): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=personal-tunnel.d.ts.map

package/dist/src/services/personal-tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personal-tunnel.d.ts","sourceRoot":"","sources":["../../../src/services/personal-tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAK5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,kBAAkB,CAAC;IAC9I,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,aAAa;IAOtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,gBAAgB,CAA6G;IACrI,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,mBAAmB,CAA2C;gBAG5D,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO;IAG1B,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,GAAG,IAAI;IAIxE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAiH9F,OAAO,CAAC,aAAa;YA2FP,kBAAkB;IAuC1B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAuC5G,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKjC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAIjE,cAAc,IAAI,MAAM;IAIxB,qBAAqB,IAAI,IAAI;IAiDvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/src/services/personal-tunnel.js

@@ -0,0 +1,371 @@
+import { WebSocket } from 'ws';
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { getStats } from './stats.js';
+import { getPromMetrics } from './prometheus.js';
+export class TunnelManager {
+    config;
+    storage;
+    connections = new Map();
+    pendingResponses = new Map();
+    heartbeatInterval = null;
+    notificationService = null;
+    constructor(config, storage) {
+        this.config = config;
+        this.storage = storage;
+    }
+    setNotificationService(service) {
+        this.notificationService = service;
+    }
+    handleConnection(ws, nodeId, ownerName, agentGaiis) {
+        // Close existing connection for this nodeId if any
+        const existing = this.connections.get(nodeId);
+        if (existing) {
+            try {
+                existing.ws.close(1000, 'replaced');
+            }
+            catch { /* ignore */ }
+        }
+        const conn = {
+            nodeId,
+            ws,
+            ownerName,
+            lastHeartbeat: Date.now(),
+            agentGaiis,
+        };
+        this.connections.set(nodeId, conn);
+        const stats = getStats();
+        const prom = getPromMetrics();
+        if (stats) {
+            if (existing)
+                stats.incrementTunnel('reconnects_total');
+            stats.incrementTunnel('connections_total');
+            stats.setTunnelGauge('connections_active', this.connections.size);
+        }
+        if (prom) {
+            if (existing)
+                prom.tunnelReconnectsTotal.inc();
+            prom.tunnelConnectionsTotal.inc();
+            prom.tunnelConnectionsActive.set(this.connections.size);
+        }
+        // Update storage status to online
+        this.storage.updatePersonalNode(nodeId, {
+            status: 'online',
+            lastSeen: new Date().toISOString(),
+        }).catch(err => logger.error('Failed to update personal node status', { nodeId, error: err }));
+        // Clear notification cooldown — node is back online (REQ-007)
+        this.notificationService?.clearCooldown(nodeId);
+        logger.info('Personal node connected', {
+            event: 'tunnel.connect',
+            personal_node_id: nodeId,
+            ownerName,
+            agents: agentGaiis.length,
+        });
+        // Send welcome message with protocol hints
+        const welcome = {
+            type: 'welcome',
+            id: uuidv4(),
+            payload: JSON.stringify({
+                protocol_version: '1.0',
+                heartbeat_interval_ms: this.config.personalNodeHeartbeatIntervalMs,
+                offline_threshold_ms: this.config.personalNodeOfflineThresholdMs,
+                request_timeout_ms: this.config.personalNodeRequestTimeoutMs,
+                reconnect_hint: {
+                    strategy: 'exponential_backoff',
+                    base_ms: 1000,
+                    max_ms: 60000,
+                    jitter: true,
+                },
+            }),
+            timestamp: new Date().toISOString(),
+        };
+        ws.send(JSON.stringify(welcome));
+        // Send initial message with mailbox summary
+        this.sendMailboxSummary(nodeId, ws);
+        ws.on('message', (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                this.handleMessage(nodeId, msg);
+            }
+            catch (err) {
+                logger.error('Invalid tunnel message', {
+                    event: 'tunnel.error',
+                    personal_node_id: nodeId,
+                    error: err,
+                });
+            }
+        });
+        ws.on('close', () => {
+            this.connections.delete(nodeId);
+            const stats = getStats();
+            if (stats) {
+                stats.incrementTunnel('disconnections_total');
+                stats.setTunnelGauge('connections_active', this.connections.size);
+            }
+            const prom2 = getPromMetrics();
+            if (prom2) {
+                prom2.tunnelDisconnectionsTotal.inc({ reason: 'clean' });
+                prom2.tunnelConnectionsActive.set(this.connections.size);
+            }
+            this.storage.updatePersonalNode(nodeId, {
+                status: 'offline',
+                lastSeen: new Date().toISOString(),
+            }).catch(err => logger.error('Failed to update personal node status on disconnect', { nodeId, error: err }));
+            logger.info('Personal node disconnected', {
+                event: 'tunnel.disconnect',
+                personal_node_id: nodeId,
+                reason: 'clean',
+            });
+        });
+        ws.on('error', (err) => {
+            logger.error('Personal node WebSocket error', {
+                event: 'tunnel.error',
+                personal_node_id: nodeId,
+                error: err.message,
+            });
+        });
+    }
+    handleMessage(nodeId, msg) {
+        const conn = this.connections.get(nodeId);
+        if (!conn)
+            return;
+        const stats = getStats();
+        const prom = getPromMetrics();
+        if (stats)
+            stats.incrementTunnel('messages_received_total');
+        if (prom)
+            prom.tunnelMessagesReceivedTotal.inc({ type: msg.type });
+        switch (msg.type) {
+            case 'heartbeat': {
+                conn.lastHeartbeat = Date.now();
+                const ack = {
+                    type: 'heartbeat_ack',
+                    id: msg.id,
+                    timestamp: new Date().toISOString(),
+                };
+                conn.ws.send(JSON.stringify(ack));
+                // Update lastSeen
+                this.storage.updatePersonalNode(nodeId, { lastSeen: new Date().toISOString() })
+                    .catch(() => { });
+                break;
+            }
+            case 'response': {
+                // Response to a forwarded request
+                const pending = this.pendingResponses.get(msg.id);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this.pendingResponses.delete(msg.id);
+                    pending.resolve(msg);
+                }
+                break;
+            }
+            case 'mailbox_ack': {
+                // Personal node acknowledges receipt of mailbox items
+                // The payload contains an array of item IDs that were received
+                if (msg.payload) {
+                    try {
+                        const itemIds = JSON.parse(msg.payload);
+                        for (const id of itemIds) {
+                            this.storage.deleteMailboxItem(id).catch(() => { });
+                        }
+                        const stats3 = getStats();
+                        if (stats3) {
+                            for (let i = 0; i < itemIds.length; i++)
+                                stats3.incrementMailbox('delivered_total');
+                        }
+                        const prom3 = getPromMetrics();
+                        if (prom3)
+                            prom3.mailboxDeliveredTotal.inc(itemIds.length);
+                        logger.info('Mailbox items acknowledged and deleted', { nodeId, count: itemIds.length });
+                    }
+                    catch { /* ignore parse errors */ }
+                }
+                break;
+            }
+            case 'disconnect': {
+                // Graceful disconnect from personal node
+                conn.ws.close(1000, 'graceful');
+                this.connections.delete(nodeId);
+                const stats2 = getStats();
+                if (stats2) {
+                    stats2.incrementTunnel('disconnections_total');
+                    stats2.setTunnelGauge('connections_active', this.connections.size);
+                }
+                const prom4 = getPromMetrics();
+                if (prom4) {
+                    prom4.tunnelDisconnectionsTotal.inc({ reason: 'graceful' });
+                    prom4.tunnelConnectionsActive.set(this.connections.size);
+                }
+                this.storage.updatePersonalNode(nodeId, {
+                    status: 'offline',
+                    lastSeen: new Date().toISOString(),
+                }).catch(() => { });
+                logger.info('Personal node gracefully disconnected', {
+                    event: 'tunnel.disconnect',
+                    personal_node_id: nodeId,
+                    reason: 'graceful',
+                });
+                break;
+            }
+            default:
+                logger.warn('Unknown tunnel message type', {
+                    event: 'tunnel.error',
+                    personal_node_id: nodeId,
+                    type: msg.type,
+                });
+        }
+    }
+    async sendMailboxSummary(nodeId, ws) {
+        try {
+            const stats = await this.storage.getMailboxStats(nodeId);
+            const items = await this.storage.listMailboxItems(nodeId);
+            const summary = {
+                type: 'mailbox_sync',
+                id: uuidv4(),
+                payload: JSON.stringify({
+                    items: stats.count,
+                    total_bytes: stats.totalBytes,
+                    oldest: items.length > 0 ? items[0].createdAt : null,
+                    newest: items.length > 0 ? items[items.length - 1].createdAt : null,
+                    by_type: items.reduce((acc, item) => {
+                        acc[item.type] = (acc[item.type] ?? 0) + 1;
+                        return acc;
+                    }, {}),
+                    // Include the actual items for immediate delivery
+                    mailbox_items: items.map(i => ({
+                        id: i.id,
+                        type: i.type,
+                        from: i.fromGaii,
+                        to: i.toGaii,
+                        payload: i.payload,
+                        created_at: i.createdAt,
+                    })),
+                }),
+                timestamp: new Date().toISOString(),
+            };
+            ws.send(JSON.stringify(summary));
+            if (stats.count > 0) {
+                logger.info('Mailbox summary sent to personal node', { nodeId, items: stats.count });
+            }
+        }
+        catch (err) {
+            logger.error('Failed to send mailbox summary', { nodeId, error: err });
+        }
+    }
+    async sendRequest(nodeId, message, timeoutMs) {
+        const conn = this.connections.get(nodeId);
+        if (!conn || conn.ws.readyState !== WebSocket.OPEN) {
+            return null;
+        }
+        const stats = getStats();
+        const prom = getPromMetrics();
+        if (stats)
+            stats.incrementTunnel('messages_sent_total');
+        if (prom)
+            prom.tunnelMessagesSentTotal.inc({ type: message.type });
+        const effectiveTimeout = timeoutMs ?? this.config.personalNodeRequestTimeoutMs;
+        const startTime = Date.now();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pendingResponses.delete(message.id);
+                if (stats)
+                    stats.incrementTunnel('delivery_failures_total');
+                if (prom)
+                    prom.tunnelDeliveryFailuresTotal.inc();
+                resolve(null);
+            }, effectiveTimeout);
+            this.pendingResponses.set(message.id, {
+                resolve: (msg) => {
+                    const latency = Date.now() - startTime;
+                    if (msg && stats) {
+                        stats.recordDeliveryLatency(latency);
+                    }
+                    if (msg && prom) {
+                        prom.tunnelDeliveryLatencyMs.observe(latency);
+                    }
+                    resolve(msg);
+                },
+                timer,
+            });
+            conn.ws.send(JSON.stringify(message));
+        });
+    }
+    isOnline(nodeId) {
+        const conn = this.connections.get(nodeId);
+        return !!conn && conn.ws.readyState === WebSocket.OPEN;
+    }
+    getConnection(nodeId) {
+        return this.connections.get(nodeId);
+    }
+    getOnlineCount() {
+        return this.connections.size;
+    }
+    startHeartbeatMonitor() {
+        const checkInterval = Math.max(this.config.personalNodeHeartbeatIntervalMs, 10000);
+        const offlineThreshold = this.config.personalNodeOfflineThresholdMs;
+        this.heartbeatInterval = setInterval(() => {
+            const now = Date.now();
+            for (const [nodeId, conn] of this.connections) {
+                const elapsed = now - conn.lastHeartbeat;
+                if (elapsed > offlineThreshold) {
+                    // Node hasn't sent heartbeat — mark offline and close
+                    logger.warn('Personal node heartbeat timeout', {
+                        event: 'tunnel.timeout',
+                        personal_node_id: nodeId,
+                        elapsed_ms: elapsed,
+                    });
+                    conn.ws.close(1000, 'heartbeat_timeout');
+                    this.connections.delete(nodeId);
+                    const stats = getStats();
+                    if (stats) {
+                        stats.incrementTunnel('heartbeat_misses_total');
+                        stats.incrementTunnel('disconnections_total');
+                        stats.setTunnelGauge('connections_active', this.connections.size);
+                    }
+                    const promHb = getPromMetrics();
+                    if (promHb) {
+                        promHb.tunnelHeartbeatMissesTotal.inc();
+                        promHb.tunnelDisconnectionsTotal.inc({ reason: 'heartbeat_timeout' });
+                        promHb.tunnelConnectionsActive.set(this.connections.size);
+                    }
+                    this.storage.updatePersonalNode(nodeId, {
+                        status: 'offline',
+                        lastSeen: new Date(conn.lastHeartbeat).toISOString(),
+                    }).catch(() => { });
+                }
+                else if (elapsed > offlineThreshold * 0.6) {
+                    // Degraded — heartbeat is late but not dead
+                    logger.warn('Personal node heartbeat late', {
+                        event: 'tunnel.heartbeat_miss',
+                        personal_node_id: nodeId,
+                        elapsed_ms: elapsed,
+                    });
+                    this.storage.updatePersonalNode(nodeId, { status: 'degraded' }).catch(() => { });
+                }
+            }
+        }, checkInterval);
+        logger.info('Personal node heartbeat monitor started', { checkInterval, offlineThreshold });
+    }
+    async shutdown() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        // Close all pending responses
+        for (const [id, pending] of this.pendingResponses) {
+            clearTimeout(pending.timer);
+            pending.resolve(null);
+            this.pendingResponses.delete(id);
+        }
+        // Close all connections
+        for (const [nodeId, conn] of this.connections) {
+            try {
+                conn.ws.close(1000, 'shutdown');
+            }
+            catch { /* ignore */ }
+            this.connections.delete(nodeId);
+        }
+        logger.info('TunnelManager shut down');
+    }
+}
+//# sourceMappingURL=personal-tunnel.js.map

package/dist/src/services/personal-tunnel.js.map

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

package/dist/src/services/profile-schemas.d.ts

@@ -0,0 +1,12 @@
+import type { Storage } from '../storage/interface.js';
+/**
+ * Register standardized profile schemas in Schema Locking.
+ * Called once during node startup. Idempotent — will not overwrite
+ * existing schemas (operator may have customized them).
+ */
+export declare function seedProfileSchemas(storage: Storage, lockedBy: string): Promise<number>;
+/**
+ * Returns the list of profile field names registered by the standard.
+ */
+export declare function getProfileFieldNames(): string[];
+//# sourceMappingURL=profile-schemas.d.ts.map

package/dist/src/services/profile-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-schemas.d.ts","sourceRoot":"","sources":["../../../src/services/profile-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AA8EvD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/src/services/profile-schemas.js

@@ -0,0 +1,100 @@
+// ── Interest Profile Schema Definitions ──
+const interestsSchema = {
+    type: 'array',
+    items: {
+        type: 'string',
+        minLength: 1,
+        maxLength: 100,
+    },
+    minItems: 1,
+    maxItems: 50,
+};
+const locationSchema = {
+    type: 'object',
+    required: ['city'],
+    properties: {
+        country: { type: 'string', minLength: 2, maxLength: 3 },
+        city: { type: 'string', minLength: 1, maxLength: 100 },
+        area: { type: 'string', maxLength: 100 },
+        geo: {
+            type: 'array',
+            items: { type: 'number' },
+            minItems: 2,
+            maxItems: 2,
+            description: '[latitude, longitude]',
+        },
+    },
+    additionalProperties: true,
+};
+const bioSchema = {
+    type: 'string',
+    minLength: 1,
+    maxLength: 500,
+};
+const seekingSchema = {
+    type: 'array',
+    items: {
+        type: 'string',
+        maxLength: 200,
+    },
+    maxItems: 20,
+};
+const availabilitySchema = {
+    type: 'string',
+    enum: ['anytime', 'evenings', 'weekends', 'evenings-weekends', 'by-appointment', 'not-available'],
+    description: 'When the person is available for contact/activities',
+};
+const languagesSchema = {
+    type: 'array',
+    items: {
+        type: 'string',
+        minLength: 2,
+        maxLength: 5,
+        pattern: '^[a-z]{2,3}(-[A-Z]{2})?$',
+        description: 'ISO 639-1 language code, optionally with region (e.g. fi, en, sv, en-US)',
+    },
+    minItems: 1,
+    maxItems: 20,
+};
+// ── Schema definitions ──
+const PROFILE_SCHEMAS = [
+    { field: 'interests', schema: interestsSchema },
+    { field: 'location', schema: locationSchema },
+    { field: 'bio', schema: bioSchema },
+    { field: 'seeking', schema: seekingSchema },
+    { field: 'availability', schema: availabilitySchema },
+    { field: 'languages', schema: languagesSchema },
+];
+/**
+ * Register standardized profile schemas in Schema Locking.
+ * Called once during node startup. Idempotent — will not overwrite
+ * existing schemas (operator may have customized them).
+ */
+export async function seedProfileSchemas(storage, lockedBy) {
+    let seeded = 0;
+    const now = new Date().toISOString();
+    for (const s of PROFILE_SCHEMAS) {
+        const keyPattern = `profile.*.${s.field}`;
+        const existing = await storage.getSchema(keyPattern, 'prefix');
+        if (!existing) {
+            await storage.setSchema({
+                keyPattern,
+                applyTo: 'prefix',
+                schemaJson: s.schema,
+                schemaMode: 'open',
+                lockedBy,
+                setAt: now,
+                updatedAt: now,
+            });
+            seeded++;
+        }
+    }
+    return seeded;
+}
+/**
+ * Returns the list of profile field names registered by the standard.
+ */
+export function getProfileFieldNames() {
+    return PROFILE_SCHEMAS.map(s => s.field);
+}
+//# sourceMappingURL=profile-schemas.js.map

package/dist/src/services/profile-schemas.js.map

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