ft-scout 1.0.8 → 1.1.0

package/bin/src/mcp/discovery.js

@@ -0,0 +1,91 @@
+/**
+ * Scout MCP Ecosystem - Discovery & Tool Normalizer
+ * Discovers capabilities, normalizes tool schemas for OpenAI function calling compatibility,
+ * and classifies permission boundaries.
+ */
+export function normalizeToolSchema(rawSchema) {
+    if (!rawSchema || typeof rawSchema !== 'object') {
+        return {
+            type: 'object',
+            properties: {},
+            required: [],
+        };
+    }
+    const properties = rawSchema.properties && typeof rawSchema.properties === 'object'
+        ? { ...rawSchema.properties }
+        : {};
+    const required = Array.isArray(rawSchema.required)
+        ? rawSchema.required.filter((r) => typeof r === 'string')
+        : [];
+    return {
+        ...rawSchema,
+        type: 'object',
+        properties,
+        required,
+    };
+}
+export function classifyPermissionLevel(toolName, description = '') {
+    const lowerName = toolName.toLowerCase();
+    const lowerDesc = description.toLowerCase();
+    const combined = `${lowerName} ${lowerDesc}`;
+    // Destructive actions
+    if (lowerName.includes('delete') ||
+        lowerName.includes('remove') ||
+        lowerName.includes('drop') ||
+        lowerName.includes('destroy') ||
+        lowerName.includes('kill') ||
+        lowerName.includes('purge') ||
+        lowerName.includes('truncate') ||
+        combined.includes('permanently delete') ||
+        combined.includes('irreversible')) {
+        return 'destructive';
+    }
+    // Admin / permission actions
+    if (lowerName.includes('admin') ||
+        lowerName.includes('grant') ||
+        lowerName.includes('revoke') ||
+        lowerName.includes('permission') ||
+        lowerName.includes('authorize')) {
+        return 'admin';
+    }
+    // Write / generation actions
+    if (lowerName.includes('create') ||
+        lowerName.includes('generate') ||
+        lowerName.includes('write') ||
+        lowerName.includes('update') ||
+        lowerName.includes('modify') ||
+        lowerName.includes('post') ||
+        lowerName.includes('send') ||
+        lowerName.includes('upload') ||
+        lowerName.includes('build') ||
+        lowerName.includes('render')) {
+        return 'write';
+    }
+    // Default to read-only
+    return 'read';
+}
+export function normalizeMCPTool(rawTool, serverId, serverName) {
+    const originalName = String(rawTool.name || 'unnamed_tool');
+    // Sanitize identifier for function calling
+    const safeServerId = serverId.replace(/[^a-zA-Z0-9_]/g, '_');
+    const safeToolName = originalName.replace(/[^a-zA-Z0-9_]/g, '_');
+    const qualifiedName = `mcp__${safeServerId}__${safeToolName}`;
+    const description = String(rawTool.description || `MCP tool from ${serverName}`).trim();
+    const inputSchema = normalizeToolSchema(rawTool.inputSchema);
+    const permissionLevel = classifyPermissionLevel(originalName, description);
+    const requiresApproval = permissionLevel === 'destructive' || permissionLevel === 'admin';
+    return {
+        name: originalName,
+        originalName,
+        qualifiedName,
+        description,
+        inputSchema,
+        serverId,
+        serverName,
+        enabled: true,
+        permissionLevel,
+        requiresApproval,
+        annotations: rawTool.annotations || {},
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/bin/src/mcp/discovery.js.map

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

package/bin/src/mcp/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,gBAAgB;IACzB;;OAEG;IACH,OAAoB,WAAW,CAC3B,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,SAAS,GACnB,OAAO,CAAC,eAAe,CAAC,CAoC1B;CACJ"}

package/bin/src/mcp/health.js

@@ -0,0 +1,44 @@
+/**
+ * Scout MCP Ecosystem - Health Monitor
+ * Probes MCP server connections, tracks latency, and maintains observable health states.
+ */
+export class MCPHealthMonitor {
+    /**
+     * Check health of an active MCP client and compute latency
+     */
+    static async checkHealth(server, client) {
+        const now = new Date().toISOString();
+        if (!client || !client.isConnected()) {
+            return {
+                status: 'disconnected',
+                lastCheckedAt: now,
+                error: 'Server is currently disconnected',
+            };
+        }
+        try {
+            const latencyMs = await client.ping(5000);
+            const status = latencyMs > 3000 ? 'degraded' : 'connected';
+            return {
+                status,
+                latencyMs,
+                lastCheckedAt: now,
+            };
+        }
+        catch (err) {
+            const errStr = String(err?.message || err || '').toLowerCase();
+            let status = 'error';
+            if (errStr.includes('unauthorized') || errStr.includes('401') || errStr.includes('403') || errStr.includes('auth')) {
+                status = 'unauthorized';
+            }
+            else if (errStr.includes('timeout') || errStr.includes('degraded')) {
+                status = 'degraded';
+            }
+            return {
+                status,
+                lastCheckedAt: now,
+                error: err?.message || 'Health check failed',
+            };
+        }
+    }
+}
+//# sourceMappingURL=health.js.map

package/bin/src/mcp/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,OAAO,gBAAgB;IACzB;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,WAAW,CAC3B,MAAuB,EACvB,MAAkB;QAElB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,OAAO;gBACH,MAAM,EAAE,cAAc;gBACtB,aAAa,EAAE,GAAG;gBAClB,KAAK,EAAE,kCAAkC;aAC5C,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;YAE3D,OAAO;gBACH,MAAM;gBACN,SAAS;gBACT,aAAa,EAAE,GAAG;aACrB,CAAC;QACN,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,OAAO,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC/D,IAAI,MAAM,GAA8B,OAAO,CAAC;YAEhD,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjH,MAAM,GAAG,cAAc,CAAC;YAC5B,CAAC;iBAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnE,MAAM,GAAG,UAAU,CAAC;YACxB,CAAC;YAED,OAAO;gBACH,MAAM;gBACN,aAAa,EAAE,GAAG;gBAClB,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,qBAAqB;aAC/C,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/bin/src/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/bin/src/mcp/index.js

@@ -0,0 +1,15 @@
+/**
+ * Scout MCP Ecosystem - Public API
+ */
+export * from './types.js';
+export * from './persistence.js';
+export * from './transport.js';
+export * from './client.js';
+export * from './discovery.js';
+export * from './permissions.js';
+export * from './toolRouter.js';
+export * from './telemetry.js';
+export * from './health.js';
+export * from './recovery.js';
+export * from './manager.js';
+//# sourceMappingURL=index.js.map

package/bin/src/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/bin/src/mcp/manager.d.ts.map

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