swarmdo 1.4.8 → 1.5.0

package/v3/@swarmdo/plugin-iot-cognitum/dist/mcp-tools.js

@@ -1,703 +0,0 @@
-function textResult(text, isError = false) {
-    return { content: [{ type: 'text', text }], isError };
-}
-export function createMcpTools(getCoordinator, _getContext) {
-    function requireCoordinator() {
-        const c = getCoordinator();
-        if (!c)
-            throw new Error('IoT Cognitum not initialized');
-        return c;
-    }
-    return [
-        // -- Device lifecycle ----------------------------------------------------
-        {
-            name: 'iot_device_register',
-            description: 'Register a Cognitum Seed device by endpoint',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    endpoint: { type: 'string', description: 'Device HTTP endpoint (e.g. http://169.254.42.1)' },
-                    pairingToken: { type: 'string', description: 'Optional pairing token for mutual auth' },
-                },
-                required: ['endpoint'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const device = await coordinator.registerDevice(params['endpoint'], params['pairingToken']);
-                    return textResult(JSON.stringify(device, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Registration failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_device_status',
-            description: 'Get device status and trust score',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const status = await coordinator.getDeviceStatus(params['deviceId']);
-                    return textResult(JSON.stringify(status, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Status failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_device_list',
-            description: 'List all registered devices',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {},
-            },
-            handler: async () => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const devices = coordinator.listDevices();
-                    return textResult(JSON.stringify(devices, null, 2));
-                }
-                catch (err) {
-                    return textResult(`List failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_device_remove',
-            description: 'Remove a registered device',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier to remove' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    await coordinator.removeDevice(params['deviceId']);
-                    return textResult(`Device ${params['deviceId']} removed`);
-                }
-                catch (err) {
-                    return textResult(`Remove failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_device_pair',
-            description: 'Pair with a registered device to establish mutual trust',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                    clientName: { type: 'string', description: 'Client name for the pairing session' },
-                },
-                required: ['deviceId', 'clientName'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const device = await coordinator.pairDevice(params['deviceId'], params['clientName']);
-                    return textResult(JSON.stringify(device, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Pairing failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_device_unpair',
-            description: 'Unpair from a registered device',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const device = await coordinator.unpairDevice(params['deviceId']);
-                    return textResult(JSON.stringify(device, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Unpair failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Vector store --------------------------------------------------------
-        {
-            name: 'iot_store_query',
-            description: 'Query device vector store',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                    vector: { type: 'array', description: 'Query vector', items: { type: 'number' } },
-                    k: { type: 'number', description: 'Number of nearest neighbours to return' },
-                },
-                required: ['deviceId', 'vector', 'k'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const result = await coordinator.queryDeviceVectors(params['deviceId'], params['vector'], params['k']);
-                    return textResult(JSON.stringify(result, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Query failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_store_ingest',
-            description: 'Ingest vectors into device store',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                    vectors: {
-                        type: 'array',
-                        description: 'Array of vectors with optional metadata',
-                        items: {
-                            type: 'object',
-                            properties: {
-                                values: { type: 'array', description: 'Vector values', items: { type: 'number' } },
-                                metadata: { type: 'object', description: 'Optional metadata' },
-                            },
-                            required: ['values'],
-                        },
-                    },
-                },
-                required: ['deviceId', 'vectors'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const result = await coordinator.ingestDeviceTelemetry(params['deviceId'], params['vectors']);
-                    return textResult(JSON.stringify(result, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Ingest failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_store_status',
-            description: 'Get vector store health',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const health = await coordinator.getDeviceStoreStatus(params['deviceId']);
-                    return textResult(JSON.stringify(health, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Store status failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Mesh / witness / custody --------------------------------------------
-        {
-            name: 'iot_mesh_topology',
-            description: 'Get mesh network topology',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const topology = await coordinator.getDeviceMeshTopology(params['deviceId']);
-                    return textResult(JSON.stringify(topology, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Mesh topology failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_witness_chain',
-            description: 'Get witness chain provenance',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const chain = await coordinator.getDeviceWitnessChain(params['deviceId']);
-                    return textResult(JSON.stringify(chain, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Witness chain failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_custody_epoch',
-            description: 'Get custody epoch',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const epoch = await coordinator.getDeviceCustodyEpoch(params['deviceId']);
-                    return textResult(JSON.stringify(epoch, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Custody epoch failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Fleet ---------------------------------------------------------------
-        {
-            name: 'iot_fleet_status',
-            description: 'Get fleet overview',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {},
-            },
-            handler: async () => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const status = coordinator.getStatus();
-                    return textResult(JSON.stringify(status, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet status failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Firmware orchestration (Phase 3) ---------------------------------------
-        {
-            name: 'iot_firmware_rollout_create',
-            description: 'Create a firmware rollout for a fleet',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                    firmwareVersion: { type: 'string', description: 'Target firmware version' },
-                },
-                required: ['fleetId', 'firmwareVersion'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const rollout = await coordinator.createFirmwareRollout(params['fleetId'], params['firmwareVersion']);
-                    return textResult(JSON.stringify(rollout, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Rollout create failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_firmware_rollout_advance',
-            description: 'Advance a firmware rollout to next stage',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    rolloutId: { type: 'string', description: 'Rollout identifier' },
-                },
-                required: ['rolloutId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const rollout = await coordinator.advanceFirmwareRollout(params['rolloutId']);
-                    return textResult(JSON.stringify(rollout, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Rollout advance failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_firmware_rollout_rollback',
-            description: 'Force rollback a firmware rollout',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    rolloutId: { type: 'string', description: 'Rollout identifier' },
-                },
-                required: ['rolloutId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const rollout = coordinator.rollbackFirmwareRollout(params['rolloutId']);
-                    return textResult(JSON.stringify(rollout, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Rollout rollback failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_firmware_rollout_status',
-            description: 'Get firmware rollout status',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    rolloutId: { type: 'string', description: 'Rollout identifier' },
-                },
-                required: ['rolloutId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const rollout = coordinator.getFirmwareRollout(params['rolloutId']);
-                    return textResult(JSON.stringify(rollout, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Rollout status failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_firmware_rollout_list',
-            description: 'List firmware rollouts',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Optional fleet filter' },
-                },
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const rollouts = coordinator.listFirmwareRollouts(params['fleetId']);
-                    return textResult(JSON.stringify(rollouts, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Rollout list failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Fleet management (Phase 3) --------------------------------------------
-        {
-            name: 'iot_fleet_create',
-            description: 'Create a new device fleet',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                    name: { type: 'string', description: 'Fleet display name' },
-                    zoneId: { type: 'string', description: 'IEC 62443 security zone' },
-                    topology: { type: 'string', enum: ['star', 'mesh', 'hierarchical', 'ring'], description: 'Fleet topology' },
-                    description: { type: 'string', description: 'Fleet description' },
-                },
-                required: ['fleetId', 'name', 'zoneId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const fleet = await coordinator.createFleet({
-                        fleetId: params['fleetId'],
-                        name: params['name'],
-                        zoneId: params['zoneId'],
-                        topology: params['topology'],
-                        description: params['description'],
-                    });
-                    return textResult(JSON.stringify(fleet, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet create failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_fleet_get',
-            description: 'Get fleet details',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                },
-                required: ['fleetId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const fleet = await coordinator.getFleet(params['fleetId']);
-                    return textResult(JSON.stringify(fleet, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet get failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_fleet_list',
-            description: 'List all fleets',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {},
-            },
-            handler: async () => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const fleets = await coordinator.listFleets();
-                    return textResult(JSON.stringify(fleets, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet list failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_fleet_add_device',
-            description: 'Add a registered device to a fleet',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['fleetId', 'deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const fleet = await coordinator.addDeviceToFleet(params['fleetId'], params['deviceId']);
-                    return textResult(JSON.stringify(fleet, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet add device failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_fleet_remove_device',
-            description: 'Remove a device from a fleet',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['fleetId', 'deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const fleet = await coordinator.removeDeviceFromFleet(params['fleetId'], params['deviceId']);
-                    return textResult(JSON.stringify(fleet, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Fleet remove device failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_fleet_delete',
-            description: 'Delete a fleet',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    fleetId: { type: 'string', description: 'Fleet identifier' },
-                },
-                required: ['fleetId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    await coordinator.deleteFleet(params['fleetId']);
-                    return textResult(`Fleet ${params['fleetId']} deleted`);
-                }
-                catch (err) {
-                    return textResult(`Fleet delete failed: ${err.message}`, true);
-                }
-            },
-        },
-        // -- Telemetry anomaly detection (Phase 2) --------------------------------
-        {
-            name: 'iot_telemetry_anomalies',
-            description: 'Detect anomalies in device telemetry readings',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                    readings: {
-                        type: 'array',
-                        description: 'Telemetry readings to analyze',
-                        items: {
-                            type: 'object',
-                            properties: {
-                                readingId: { type: 'string' },
-                                vector: { type: 'array', items: { type: 'number' } },
-                                rawMetrics: { type: 'object' },
-                            },
-                            required: ['readingId', 'vector'],
-                        },
-                    },
-                },
-                required: ['deviceId', 'readings'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const deviceId = params['deviceId'];
-                    const rawReadings = params['readings'];
-                    const readings = rawReadings.map((r) => ({
-                        readingId: r.readingId,
-                        deviceId,
-                        fleetId: '',
-                        timestamp: new Date(),
-                        vector: r.vector,
-                        rawMetrics: r.rawMetrics ?? {},
-                        anomalyScore: 0,
-                        metadata: {},
-                    }));
-                    const result = coordinator.detectAnomalies(deviceId, readings);
-                    return textResult(JSON.stringify(result, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Anomaly detection failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_telemetry_baseline',
-            description: 'Compute or retrieve telemetry baseline for a device',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                    action: {
-                        type: 'string',
-                        enum: ['compute', 'get'],
-                        description: 'Compute new baseline or get existing',
-                    },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const deviceId = params['deviceId'];
-                    const action = params['action'] ?? 'get';
-                    if (action === 'get') {
-                        const baseline = coordinator.getBaseline(deviceId);
-                        if (!baseline) {
-                            return textResult(JSON.stringify({ deviceId, status: 'no-baseline' }));
-                        }
-                        return textResult(JSON.stringify(baseline, null, 2));
-                    }
-                    return textResult(JSON.stringify({
-                        deviceId,
-                        status: 'compute-requires-readings',
-                        hint: 'Use iot_telemetry_anomalies with readings to build baseline first',
-                    }));
-                }
-                catch (err) {
-                    return textResult(`Baseline failed: ${err.message}`, true);
-                }
-            },
-        },
-        {
-            name: 'iot_witness_verify',
-            description: 'Verify witness chain integrity for a device — detects epoch gaps and hash chain breaks',
-            pluginName: '@swarmdo/plugin-iot-cognitum',
-            version: '1.0.0-alpha.1',
-            inputSchema: {
-                type: 'object',
-                properties: {
-                    deviceId: { type: 'string', description: 'Device identifier' },
-                },
-                required: ['deviceId'],
-            },
-            handler: async (params) => {
-                try {
-                    const coordinator = requireCoordinator();
-                    const result = await coordinator.verifyWitnessChain(params['deviceId']);
-                    return textResult(JSON.stringify(result, null, 2));
-                }
-                catch (err) {
-                    return textResult(`Witness verification failed: ${err.message}`, true);
-                }
-            },
-        },
-    ];
-}
-//# sourceMappingURL=mcp-tools.js.map