@mce-bt/microagents-registry 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+import type { AgentRegistration } from '@mce-bt/microagents-core';
+export interface RegistryClientConfig {
+    registryUrl: string;
+    agentId: string;
+    sharedSecret: string;
+}
+/**
+ * Registry client — used by agents to register/deregister and discover other agents.
+ * Talks to the registry service over HTTP.
+ */
+export declare class RegistryClient {
+    private config;
+    private heartbeatTimer;
+    constructor(config: RegistryClientConfig);
+    register(registration: AgentRegistration): Promise<void>;
+    deregister(agentId: string): Promise<void>;
+    discover(agentId: string): Promise<{
+        baseUrl: string;
+    } | null>;
+    listAgents(options?: {
+        domain?: string;
+        status?: string;
+    }): Promise<unknown[]>;
+    startHeartbeat(agentId: string, intervalMs: number): void;
+    stopHeartbeat(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAA+C;gBAEzD,MAAM,EAAE,oBAAoB;IAIlC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAmB9D,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAoBpF,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAkBzD,aAAa,IAAI,IAAI;CAMtB"}

package/dist/client.js

@@ -0,0 +1,97 @@
+/**
+ * Registry client — used by agents to register/deregister and discover other agents.
+ * Talks to the registry service over HTTP.
+ */
+export class RegistryClient {
+    config;
+    heartbeatTimer = null;
+    constructor(config) {
+        this.config = config;
+    }
+    async register(registration) {
+        const response = await fetch(`${this.config.registryUrl}/api/agents`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Agent-Id': this.config.agentId,
+                'X-Shared-Secret': this.config.sharedSecret,
+            },
+            body: JSON.stringify(registration),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Failed to register: ${response.status} ${text}`);
+        }
+    }
+    async deregister(agentId) {
+        const response = await fetch(`${this.config.registryUrl}/api/agents/${agentId}`, {
+            method: 'DELETE',
+            headers: {
+                'X-Agent-Id': this.config.agentId,
+                'X-Shared-Secret': this.config.sharedSecret,
+            },
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Failed to deregister: ${response.status} ${text}`);
+        }
+    }
+    async discover(agentId) {
+        const response = await fetch(`${this.config.registryUrl}/api/agents/${agentId}`, {
+            headers: {
+                'X-Agent-Id': this.config.agentId,
+                'X-Shared-Secret': this.config.sharedSecret,
+            },
+        });
+        if (response.status === 404)
+            return null;
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Failed to discover agent: ${response.status} ${text}`);
+        }
+        const agent = await response.json();
+        return agent;
+    }
+    async listAgents(options) {
+        const params = new URLSearchParams();
+        if (options?.domain)
+            params.set('domain', options.domain);
+        if (options?.status)
+            params.set('status', options.status);
+        const url = `${this.config.registryUrl}/api/agents?${params.toString()}`;
+        const response = await fetch(url, {
+            headers: {
+                'X-Agent-Id': this.config.agentId,
+                'X-Shared-Secret': this.config.sharedSecret,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to list agents: ${response.status}`);
+        }
+        return response.json();
+    }
+    startHeartbeat(agentId, intervalMs) {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(async () => {
+            try {
+                await fetch(`${this.config.registryUrl}/api/agents/${agentId}/heartbeat`, {
+                    method: 'POST',
+                    headers: {
+                        'X-Agent-Id': this.config.agentId,
+                        'X-Shared-Secret': this.config.sharedSecret,
+                    },
+                });
+            }
+            catch {
+                // Heartbeat failure is non-fatal — registry will mark us unhealthy
+            }
+        }, intervalMs);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { RegistryStore, type RegistryStoreConfig, type RegisteredAgent } from './store.js';
+export { RegistryClient, type RegistryClientConfig } from './client.js';
+export { RegistryServer, type RegistryServerConfig } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { RegistryStore } from './store.js';
+export { RegistryClient } from './client.js';
+export { RegistryServer } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkD,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+import { type RegistryStoreConfig } from './store.js';
+export interface RegistryServerConfig {
+    port: number;
+    host?: string;
+    sharedSecret: string;
+    store: RegistryStoreConfig;
+    /** Interval for checking stale agents (default: 30s) */
+    staleCheckIntervalMs?: number;
+    /** Heartbeat threshold before marking unhealthy (default: 45s) */
+    staleThresholdMs?: number;
+}
+/**
+ * Registry HTTP server — the central discovery service.
+ * Lightweight, independently deployable.
+ */
+export declare class RegistryServer {
+    private server;
+    private store;
+    private config;
+    private staleCheckTimer;
+    constructor(config: RegistryServerConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,eAAe,CAA+C;gBAE1D,MAAM,EAAE,oBAAoB;IAKlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0EtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B"}

package/dist/server.js

@@ -0,0 +1,91 @@
+import Fastify, {} from 'fastify';
+import { RegistryStore } from './store.js';
+/**
+ * Registry HTTP server — the central discovery service.
+ * Lightweight, independently deployable.
+ */
+export class RegistryServer {
+    server = null;
+    store;
+    config;
+    staleCheckTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.store = new RegistryStore(config.store);
+    }
+    async start() {
+        await this.store.start();
+        this.server = Fastify({ logger: false });
+        // Auth middleware
+        this.server.addHook('onRequest', async (request, reply) => {
+            if (request.url === '/health')
+                return;
+            const secret = request.headers['x-shared-secret'];
+            if (secret !== this.config.sharedSecret) {
+                reply.code(401).send({ error: 'Unauthorized' });
+            }
+        });
+        // Health
+        this.server.get('/health', async () => ({ status: 'ok', service: 'registry' }));
+        // Register agent
+        this.server.post('/api/agents', async (request, reply) => {
+            const body = request.body;
+            await this.store.register(body);
+            reply.code(201).send({ ok: true });
+        });
+        // Get agent
+        this.server.get('/api/agents/:agentId', async (request, reply) => {
+            const { agentId } = request.params;
+            const agent = await this.store.getAgent(agentId);
+            if (!agent) {
+                reply.code(404).send({ error: 'Agent not found' });
+                return;
+            }
+            return agent;
+        });
+        // List agents
+        this.server.get('/api/agents', async (request) => {
+            const { domain, status } = request.query;
+            return this.store.getAllAgents({ domain, status });
+        });
+        // Deregister agent
+        this.server.delete('/api/agents/:agentId', async (request, reply) => {
+            const { agentId } = request.params;
+            await this.store.deregister(agentId);
+            reply.code(204).send();
+        });
+        // Heartbeat
+        this.server.post('/api/agents/:agentId/heartbeat', async (request, reply) => {
+            const { agentId } = request.params;
+            await this.store.heartbeat(agentId);
+            reply.code(204).send();
+        });
+        await this.server.listen({
+            port: this.config.port,
+            host: this.config.host ?? '0.0.0.0',
+        });
+        // Start stale agent checker
+        const staleInterval = this.config.staleCheckIntervalMs ?? 30_000;
+        const staleThreshold = this.config.staleThresholdMs ?? 45_000;
+        this.staleCheckTimer = setInterval(async () => {
+            try {
+                await this.store.markStaleAgents(staleThreshold);
+            }
+            catch {
+                // Non-fatal
+            }
+        }, staleInterval);
+    }
+    async stop() {
+        if (this.staleCheckTimer) {
+            clearInterval(this.staleCheckTimer);
+            this.staleCheckTimer = null;
+        }
+        if (this.server) {
+            await this.server.close();
+            this.server = null;
+        }
+        await this.store.stop();
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,70 @@
+export interface RegistryStoreConfig {
+    connectionString: string;
+}
+export interface RegisteredAgent {
+    id: string;
+    name: string;
+    domain: string;
+    version: string;
+    description: string;
+    baseUrl: string;
+    endpoints: Array<{
+        path: string;
+        method: string;
+        description?: string;
+    }>;
+    events: {
+        subscriptions: Array<{
+            topic: string;
+            description?: string;
+        }>;
+        publications: Array<{
+            topic: string;
+            description?: string;
+        }>;
+    };
+    tasks: Array<{
+        topic: string;
+        description?: string;
+    }>;
+    skills: Array<{
+        name: string;
+        description: string;
+        visibility: string;
+        type: string;
+    }>;
+    tools: Array<{
+        name: string;
+        description: string;
+        visibility: string;
+    }>;
+    status: 'online' | 'offline' | 'unhealthy';
+    lastHeartbeat: Date;
+    registeredAt: Date;
+}
+/**
+ * PostgreSQL-backed registry store.
+ * Persists agent registrations for discovery and health tracking.
+ */
+export declare class RegistryStore {
+    private pool;
+    private config;
+    constructor(config: RegistryStoreConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private ensureSchema;
+    register(agent: Omit<RegisteredAgent, 'status' | 'lastHeartbeat' | 'registeredAt'>): Promise<void>;
+    deregister(agentId: string): Promise<void>;
+    heartbeat(agentId: string): Promise<void>;
+    getAgent(agentId: string): Promise<RegisteredAgent | null>;
+    getAllAgents(options?: {
+        status?: string;
+        domain?: string;
+    }): Promise<RegisteredAgent[]>;
+    /**
+     * Mark agents as unhealthy if no heartbeat received within the threshold.
+     */
+    markStaleAgents(thresholdMs?: number): Promise<number>;
+    private rowToAgent;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,MAAM,EAAE;QACN,aAAa,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC9D,YAAY,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9D,CAAC;IACF,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC3C,aAAa,EAAE,IAAI,CAAC;IACpB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,YAAY;IA0BpB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,eAAe,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAY1D,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA6B9F;;OAEG;IACG,eAAe,CAAC,WAAW,GAAE,MAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAYpE,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/store.js

@@ -0,0 +1,137 @@
+import pg from 'pg';
+const { Pool } = pg;
+/**
+ * PostgreSQL-backed registry store.
+ * Persists agent registrations for discovery and health tracking.
+ */
+export class RegistryStore {
+    pool = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async start() {
+        this.pool = new Pool({ connectionString: this.config.connectionString });
+        await this.ensureSchema();
+    }
+    async stop() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+    async ensureSchema() {
+        if (!this.pool)
+            return;
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS agent_registry (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        domain TEXT NOT NULL,
+        version TEXT NOT NULL,
+        description TEXT DEFAULT '',
+        base_url TEXT NOT NULL,
+        endpoints JSONB DEFAULT '[]',
+        events JSONB DEFAULT '{}',
+        tasks JSONB DEFAULT '[]',
+        skills JSONB DEFAULT '[]',
+        tools JSONB DEFAULT '[]',
+        status TEXT DEFAULT 'online',
+        last_heartbeat TIMESTAMPTZ DEFAULT NOW(),
+        registered_at TIMESTAMPTZ DEFAULT NOW()
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_registry_domain ON agent_registry(domain);
+      CREATE INDEX IF NOT EXISTS idx_registry_status ON agent_registry(status);
+    `);
+    }
+    async register(agent) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        await this.pool.query(`INSERT INTO agent_registry (id, name, domain, version, description, base_url, endpoints, events, tasks, skills, tools, status, last_heartbeat, registered_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, 'online', NOW(), NOW())
+       ON CONFLICT (id) DO UPDATE SET
+         name = $2, domain = $3, version = $4, description = $5, base_url = $6,
+         endpoints = $7, events = $8, tasks = $9, skills = $10, tools = $11,
+         status = 'online', last_heartbeat = NOW()`, [
+            agent.id,
+            agent.name,
+            agent.domain,
+            agent.version,
+            agent.description,
+            agent.baseUrl,
+            JSON.stringify(agent.endpoints),
+            JSON.stringify(agent.events),
+            JSON.stringify(agent.tasks),
+            JSON.stringify(agent.skills),
+            JSON.stringify(agent.tools),
+        ]);
+    }
+    async deregister(agentId) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        await this.pool.query(`UPDATE agent_registry SET status = 'offline' WHERE id = $1`, [agentId]);
+    }
+    async heartbeat(agentId) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        await this.pool.query(`UPDATE agent_registry SET last_heartbeat = NOW(), status = 'online' WHERE id = $1`, [agentId]);
+    }
+    async getAgent(agentId) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        const result = await this.pool.query('SELECT * FROM agent_registry WHERE id = $1', [agentId]);
+        if (result.rows.length === 0)
+            return null;
+        return this.rowToAgent(result.rows[0]);
+    }
+    async getAllAgents(options) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        const conditions = [];
+        const params = [];
+        let idx = 1;
+        if (options?.status) {
+            conditions.push(`status = $${idx}`);
+            params.push(options.status);
+            idx++;
+        }
+        if (options?.domain) {
+            conditions.push(`domain = $${idx}`);
+            params.push(options.domain);
+            idx++;
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const result = await this.pool.query(`SELECT * FROM agent_registry ${where} ORDER BY name`, params);
+        return result.rows.map(this.rowToAgent);
+    }
+    /**
+     * Mark agents as unhealthy if no heartbeat received within the threshold.
+     */
+    async markStaleAgents(thresholdMs = 45_000) {
+        if (!this.pool)
+            throw new Error('Registry store not started');
+        const threshold = new Date(Date.now() - thresholdMs);
+        const result = await this.pool.query(`UPDATE agent_registry SET status = 'unhealthy' WHERE status = 'online' AND last_heartbeat < $1`, [threshold]);
+        return result.rowCount ?? 0;
+    }
+    rowToAgent(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            domain: row.domain,
+            version: row.version,
+            description: row.description,
+            baseUrl: row.base_url,
+            endpoints: row.endpoints,
+            events: row.events,
+            tasks: row.tasks,
+            skills: row.skills,
+            tools: row.tools,
+            status: row.status,
+            lastHeartbeat: new Date(row.last_heartbeat),
+            registeredAt: new Date(row.registered_at),
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mce-bt/microagents-registry",
+  "version": "0.1.0",
+  "description": "Lightweight central registry service — agent discovery, health, API catalog",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "fastify": "^5.2.0",
+    "ioredis": "^5.4.0",
+    "pg": "^8.13.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavillo/microagents.git",
+    "directory": "packages/registry"
+  },
+  "homepage": "https://github.com/cavillo/microagents#readme",
+  "bugs": {
+    "url": "https://github.com/cavillo/microagents/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}